Duo Security is a platform for multi-factor authentication and user access management. This guide shows you how to create an Admin API application in Duo and gather the values you need to configure the integration.
Before you begin, ensure that you have:
- A Duo Security account with administrative access to the Duo Admin Panel
| Permission | Purpose |
|---|---|
| Grant resource - Read | Read users, groups, and devices |
| Grant resource - Write | Enable and disable users |
| Grant read log | Read authentication and administrator action logs |
- Log in to the Duo Admin Panel
- Select Applications > Application Catalog
- Find Admin API, then select + Add
- In the Permissions section, select the permissions listed in the section above titled Required Permissions
- Select Save
- Take note of the Integration key, Secret key, and API hostname values and store them in a safe location
- You have now created an Admin API application. Proceed to the next section titled Configuring the Integration
For more information on Admin API applications, see the Duo Admin API docs page
To configure a new Duo Security integration, provide each of the values as defined below:
| Integration Parameter | Description |
|---|---|
| Secret Key | The Secret key value you took note of when you created the Admin API application |
| Integration Key | The Integration key value you took note of when you created the Admin API application |
| Base URL | The API hostname you took note of when you created the Admin API application Example https://api-XXXXXXXX.duosecurity.com |