Vendor Integrations
      Back to home
      1. Gradient Support Center
      2. Vendor Integrations
      3. Vendor Integrations

      Duo Security

      A step-by-step guide to getting started with the Duo Security integration with Synthesize.

      Products Integrated Duo User License

      Note with the exception of users in the Trash folder or users in Pending Deletion status, users consume a seat license once they are added to the Duo Admin Panel. Click here for more information.

      Connecting the Duo Security Integration

      1. Generate Vendor API Keys
      2. Connect the integration.
      3. Map Accounts and Services
      4. Reconcile

      Disconnecting the Duo Security Integration

      1. Disconnect the Integration

      Step 1: Generate Vendor API Keys

      The Duo Security integration requires the following credentials across the Admin API and Accounts API:

      • Integration Key
      • Secret Key
      • API Hostname (e.g., api-xxxxxxxx.duosecurity.com)

      Note that only administrators with the Owner role in the parent may contact Duo Support to request access to the Accounts or Admin API application, or can create or modify an API application in the Duo Admin Panel.

      Accounts API

      1. Log in to the Duo Admin Panel and navigate to Applications.
      2. Click Protect an Application and locate the entry for Accounts API in the applications list. Click Protect to the far-right to configure the application and get your integration key, secret key, and API hostname. You'll need this information to complete your setup. See Protecting Applications for more information about protecting applications in Duo and additional application options.

      Optional specify which IP addresses or ranges are allowed to use this Accounts API application in Networks for API Access. If you do not specify any IP addresses or ranges, this Accounts API application may be accessed from any network. Click here for more information.

      Admin API

      1. Log in to the Duo Admin Panel and navigate to Applications.
      2. Click Protect an Application and locate the entry for Admin API in the applications list. Click Protect to the far-right to configure the application and get your integration key, secret key, and API hostname. You'll need this information to complete your setup. See Protecting Applications for more information about protecting applications in Duo and additional application options.
      3. Apply "Grant read resource" permission to this Admin API application. This is required to read information about resource objects such as end users to retrieve seat license usage.

      Step 2: Connect the Integration

      1. Login to Synthesize and navigate to the Integrations tab.
      2. Select the Duo Security Integration card and click Connect.
      3. Choose what module you wish to connect to, and press continue.
      4. Enter your vendor details from Step 1 and press authenticate.
      5. Press Next to complete the service and account mapping.

      Note you are only able to proceed until accounts, services and the integration status is set to "Pending". You may hit the Sync status button, to check on the status of the integration.

      Step 3: Map Accounts and Services

      1. Map your accounts by dragging the card from Synthesize on the left to Duo Security on the right. When complete, press Next. 
        1. We have auto-mapped any that are exact matches. The remaining can be searched by pressing the filter button or typing in the Synthesize search bar. 
      2. Map your services by dragging the card from Synthesize on the left to Duo Security on the right. When complete, press Next. 
        1. Services can be searched by pressing the filter button or typing in the Synthesize search bar. 
      3. Review and Press Finish
      4. A pop-up will inform you that the setup is complete and that the syncing of usage can take a few seconds to several minutes.

        Tip learn more on how to map within Synthesize here.  

      Step 4: Reconcile

      1. You are now ready to start reconciling.      
      2. To view only that vendor’s results, you can select the filter option and choose the vendor to display the imported values and reconcile.

      Disconnecting the Integration

      1. Login to Synthesize and navigate to the Integrations tab.
      2. Filter to Connected Integrations
      3. Select the Duo Security Integration card and click Configure. 
      4. Press Disconnect and Confirm.
      5. Navigate to the Vendor account and turn off your API keys.

      Warning disconnecting this integration will remove the authentication settings and all account and service mapping. You'll be able to reconnect this integration, but you'll need to remap your account and services.