Skip to main content

​
Pre-requisites

User Organization must have valid credentials to access the Duo Admin Panel.

​
Generate Duo Security Admin API

The Admin API allows you to programmatically create, retrieve, update, and delete users, phones, hardware tokens, admins, applications, and more
1

Step 1

  1. Log in to your Duo Admin Panel. images/Duo8.png
  2. Navigate to Applications → Protect an Application. images/Duo1.png
2

Step 2

Generate Admin API Credentials
  1. Search for the type of integration “Admin API”.
  2. Click Protect to the far right to configure the Auth API. images/Duo2.png
  3. Scroll down to the Permissions section.
  4. Select the required permissions (Grant read information , Grant read log, and Grant read resource .
  5. Click Save Changes. images/Duo3.png
  6. In the Details section, copy and secure the Integration Key (ikey) – Identifies your app, Secret Key (skey) – A secure credential, and API Hostname – URL to interact with Duo. images/Duo4.png
3

Step 3

Email the Integration Key (ikey), Secret Key (skey), and the API Hostname URL to AirMDR or self Configure Duo Security in AirMDR Integrations Dashboard.

​
Configure Duo Security Admin API in AirMDR Integrations Dashboard

  1. Navigate to AirMDR, provide the credentials and click Login.
  2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select Integrations. Air MDR Left Navigation Pane Pn
  3. Use the search option, enter the keyword “Duo Security”, select the Connections tab, and click Add New Connection.
  4. Enter an unique name to the Instance (e.g., your org name-DuoSecurity) and brief Description to easily identify the user connection by AirMDR. Duo9 Pn
  5. Enter the generated Integration Key (ikey), Secret Key (skey), API Hostname URL and Expiry (optional) in the Authentication Details field params, and click Save. Duo10 Pn

​
Test the Integration

  • Attempt login with a user enrolled in Duo.
  • Check if push notifications, SMS, or OTP codes work.
  • Monitor API logs in the Duo Admin Dashboard.