Integration Guide: Cisco Duo Admin
Learn How to Connect the Cisco Duo Admin Integration
Published Date: June 25, 2026 | Last Updated: June 26, 2026
Overview
Tello IAM offers two separate Cisco Duo integrations. Cisco Duo Admin connects to the Duo Admin API to manage and monitor administrator accounts. Cisco Duo Users connects to the Duo Accounts API to manage end user accounts. These are distinct integrations with separate credentials and permissions — each must be connected independently.
This article covers the Cisco Duo Admin integration.
Before connecting
The Administrator completing this setup must have access to the Duo Admin Panel and permission to create Admin API applications. The Admin API application must be granted Grant administrators Read and Write permissions.
Step 1: Create an Admin API application in Duo
- Sign in to the Duo Admin Panel.
- Navigate to Applications → Protect an Application.
- Search for Admin API and select Protect.
- Under Permissions, enable Grant administrators with Read and Write access.
- Save the application. Duo displays the API Hostname, Integration Key, and Secret Key for the application.
- Copy all three values.
Important: Copy the Secret Key before leaving this page. It will not be shown again. If lost, a new Admin API application must be created.
Step 2: Connect Cisco Duo Admin in Tello IAM
- Navigate to Integrations in the left navigation.
- Select + Add Integration.
- Search for Cisco Duo Admin and select Add.
- Enter the API Hostname (for example,
api-XXXXXXXX.duosecurity.com). - Enter the Integration Key.
- Enter the Secret Key.
- Select Test Connection to verify all values are valid. A Connection successful confirmation will appear if accepted.
- Select Connect. The integration appears on the Integrations page and an initial sync begins automatically.
Verify the connection
After the initial sync completes, confirm the following on the Integrations page:
- The Cisco Duo Admin integration displays a status of
Active - A sync timestamp is present and reflects the completed sync
- User records on the Users page display detected Duo administrator permissions in the Access column
Reauthorizing the connection
If the integration loses authorization, it will display an error on the Integrations page. To reauthorize, locate the existing Admin API application in the Duo Admin Panel or create a new one, then select the integration row in Tello IAM, select Configure, and enter the updated credentials.
Related articles
- Cisco Duo Users — connect the Duo Accounts API to manage end user accounts
- Configuring Integrations — manage sync schedules, drift detection, and integration settings
- Understanding Errors — resolve integration errors and authorization failures
Seasoft Security Solutions LLC | Tello IAM