Public API

10/2024

Fetch end user information and react to Identity Intelligence threat detection using Cisco Identity Intelligence.

Authorization

Prerequisites

Generate client API credentials:

1. Sign in to Cisco Identity Intelligence.

2. From the Integrations tab, click Add Integration.

3. Scroll down and click Add API Client.

4. Provide a Name and Description.

5. Click Save and generate credentials.

6. Click Copy all to copy the credentials to your clipboard.

Exchange the client credentials for an access token

1. Send a POST request to the tokenUrl with the following body:

   {
     "client_id": "<client ID of the API client>",
     "client_secret": "<client secret of the API client>",
     "grant_type": "client_credentials"
   }

API clients created before September 2025 may require an additional audience field (audience of the API client) in the body of the POST request. If you are requesting a token for an existing API Client that originally included an audience , please ensure that this field is present in your request to avoid errors. You can check a particular API client's settings via the Integrations page in Cisco Identity Intelligence to confirm whether the audience field is required.

1. Extract the access_token from the response. An access token is valid for 10 hours.

2. When invoking the public API requests set an Authorization header with the value Bearer <value ofaccess_token>

Using a Postman Collection

Import the attached Postman collection JSON file and follow the instructions in the collection overview tab.

20KB

Cisco Identity Intelligence Public API.postman_collection.json

Open