Duo
Visualize Duo users and access management, and monitor changes through queries and alerts.
- Installation
- Data Model
- Types
Installation
You will need to create an API Key (Integration Key + Secret Key) key on Duo. See
their documentation for more information.
The Duo integration requires (at minimum) the following API permissions enabled:
Grant administratorsGrant settingsGrant read resource
Configuration in JupiterOne
To install the Duo integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Duo. Click New Instance to begin configuring your integration.
Creating an instance requires the following:
-
The Account Name used to identify the Duo account in JupiterOne. Ingested entities will have this value stored in
tag.AccountNamewhen theAccountNametoggle is enabled. -
Description to assist in identifying the integration instance, if desired.
-
Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as
DISABLEDand manually execute the integration. -
Your Duo API Hostname.
-
The Duo
Integration KeyandSecret Key(both configured for read access).
Click Create once all values are provided to finalize the integration.
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Entities
The following entities are created:
| Resources | Entity _type | Entity _class |
|---|---|---|
| Account | duo_account | Account |
| Admin | duo_admin | User |
| Device | duo_phone | Device |
| Group | duo_group | UserGroup |
| Integration | duo_integration | Application |
| MFA Token | mfa_device | AccessKey |
| User | duo_user | User |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
|---|---|---|
duo_account | HAS | duo_group |
duo_account | HAS | duo_admin |
duo_account | HAS | duo_user |
duo_account | HAS | duo_integration |
duo_group | HAS | duo_user |
duo_user | ASSIGNED | mfa_device |
duo_user | USES | duo_phone |
Duo Account
duo_account inherits from Account
| Property | Type | Description | Specifications |
|---|---|---|---|
siteId | string | ||
webLink | string |
Duo Phone
duo_phone inherits from Device
| Property | Type | Description | Specifications |
|---|---|---|---|
activated | boolean | ||
email | string | ||
encrypted | boolean | ||
phoneNumber | string | ||
platform | string | ||
tampered | boolean | ||
userId | string | ||
username | string |
Duo User
duo_user inherits from User
| Property | Type | Description | Specifications |
|---|---|---|---|
active | boolean | ||
createdOn | number | ||
lastLogin | number | ||
notes | array of strings |