Activity Insights - Duo

To display activity data from Activity Insights, you first must create an API client in Duo. You’ll then connect the following required sources so that IdentityNow can gather your Duo account information and activity data.

Connector	Description
Duo	The identity governance connector allows you to manage your Duo accounts and groups in IdentityNow.
Activity Insights - Duo	The Activity Insights connector works with your Duo identity governance connector to provide activity data for identities.

Registering an API Client

You must have the Owner role to create or modify an API application within the Duo Admin panel.

1. Go to the Duo Admin panel.

2. Select Applications > Protect Applications from the navigation menu.

3. Enter admin_api in the search bar and select Protect beside the Admin API option.

4. In the Details section, copy the information from the Integration key, Secret key, and API hostname fields. You’ll need this information when you connect Duo to IdentityNow.

5. In the Settings section, enter a name for the Admin API application.

6. Grant the Admin API application the following permission:

   Permissions	Description
   Grant read log	The Admin API application can read authentication, offline access, telephony, and administrator action log information.

7. Select Save Changes to create the application.

You can now enter the credentials from the Admin API application into IdentityNow.

Connecting Duo to IdentityNow for Activity Insights

To connect Duo to IdentityNow, you’ll need to configure the following sources in IdentityNow. This will allow IdentityNow to gather account information and activity data from Duo.

Configuring the Duo Identity Governance Source

Follow the directions to configure your Duo source in IdentityNow. You can also edit an existing source.

Configuring the Activity Insights - Duo Source

To display activity data from Activity Insights, you must configure the Activity Insights - Duo source in IdentityNow.

1. Go to Admin > Connections > Sources.
2. Select Create New to create a new source.
3. Search for and select the Activity Insights - Duo connector.
4. Enter a name and description for the source.
5. In the Source Owner field, begin typing the name of an owner. Matches appear after you type two letters.
6. (Optional) Select a governance group for source management.
7. Select Continue to create the source.
8. Select Configuration from the left panel.

9. Enter the following information:

   • Integration Key - The Integration key from Duo.
   • Secret Key - The Secret key from Duo.
   • API Host - The API hostname from Duo.

10. Select Save to save these settings.

11. Select Review and Test from the left panel.
12. Select Test Connection to test the connection between the applications. You must have a successful connection for IdentityNow to gather activity data. If the test is unsuccessful, retry your credentials or contact SailPoint Support.

To gather account data, you must correlate accounts and run an aggregation for the Duo identity governance source. Your activity data will begin syncing immediately but may take up to 24 hours to display. Data will then update daily.

Required Permissions

Your account must have the Owner role to create or modify an API application within the Duo Admin panel.

Requested Scopes

IdentityNow requests the following scopes:

Scope	Description
Grant read log	The Admin API application can read authentication, offline access, telephony, and administrator action log information.

User Metadata

IdentityNow pulls the following user metadata from Duo.

Field	Description
Groups	The groups the user belongs to in Duo.
Status	The user’s status in Duo. For example, a user’s status can be “Active”, “Disabled”, or “Locked out”.