Cisco Duo

Connection Requirements

1

Api hostname

This is the unique API server address for your Duo account. It is the URL where your application must send its API calls. It's custom-generated for each Duo account and typically follows the format api-xxxxxxxx.duosecurity.com.

2

Integration key

This is a public identifier that uniquely identifies your application. It's how your application says, "This is me," when it makes an API call. It specifies which application or service is using the API.

3

Secret key

This is a private password used to cryptographically sign your API calls. Known only to you and Duo, this key proves that the API request is genuinely from you and ensures its integrity. It should never be shared and must be kept confidential. Duo uses this Secret Key along with the Integration Key to verify the validity of the API request.

To create a new Admin API connection in Duo, go to the Duo Admin Panel, navigate to the Applications section, and enter the Application Catalog. Select the Admin API and add the application. Duo will then automatically provide the necessary Integration Key, Secret Key, and API Hostname for administrative tasks like managing users and devices. Add these keys to your application's code to complete the API connection.

To find the information for an Admin API you've already created, log into the Duo Admin Panel and go to the Applications section from the left-hand menu. Click on your Admin API in the list of applications to open the details page and view your Integration Key, Secret Key, and API Hostname. Note: for security, the Secret Key may only have been shown once; if you didn't save it, you may need to generate a new key.

Please perform a connection test to ensure there is a valid connection to the host. When the discovery operation is finalized, you will be able to see the details on the Assets page.