Connect to Cloudaware CMDB API using Connected App with OAuth 2.0 Client Credentials Flow (legacy)

This article explains how to configure a connected app using OAuth 2.0 Client Credentials Flow for Cloudaware CMDB API access. Connected apps are a legacy feature. It is recommended to use External Client Apps.

Prerequisites

Contact your dedicated technical account manager or tam@cloudaware.com to enable the App Manager feature for your Cloudaware account. Once the feature is enabled, proceed with the setup.

Set up the app

1. Log in to the Cloudaware account → Setup:
   

   

2. In a Quick Find bar, search for App Manager and select 'App Manager' under Apps:
   

   

3. Click New Connected App → select 'Create a Connected App' → click Continue: 
   

   

4. Specify a name and a contact email for the connected app. The API name will be auto-populated.
   

5. Under API (Enable OAuth Settings), check the box 'Enable OAuth Settings'. Use http://localhost:1717/OauthRedirect in the Callback URL field. 
   

   

6. Select the following OAuth scopes:
   
   Manage user data via APIs (api)
   Perform requests at any time (refresh_token, offline_access)
   

   

7. Uncheck the check box 'Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows' if it is not required.
   

8. Check the box 'Enable Client Credentials Flow'. Click OK in the popup window. Scroll down and click Save.
   

9. A message will appear informing that the changes may take some time to be applied. Click Continue to be redirected to the New Connected App page.
   

   

10. Click Manage Consumer Details.
    

    

11. Check your email to get the code required to verify your identity.

12. Copy & save Consumer Key and Consumer Secret. These credentials should be used as client_id and client_secret in authorization API requests to obtain an access token.
    

    

    
    Click the link 'Back to Manage Connected Apps'.
    

13. Click Manage → Edit Policies:
    

    

    

14. Under 'Client Credentials Flow' in '(Run As)', click on the magnifying glass icon:
    

    

    
    In a popup window, select a preferred user* using the list of users or a search bar:
    

    

*This user is considered to be a 'running' user of the connected app. The API will respect the permissions of the specified Cloudaware User while processing the requests. 

14. Once the popup window is closed, get back to the Edit Policies page. Scroll down and click Save.