Duo Tables

The Duo integration uses the following tables

Tables

DuoAccountSettings

Stores high-level configuration settings for a Duo account/tenant (for example, security and administrative preferences that affect how Duo behaves for that account).

NameTypeDescription
IDintegerCompyl-defined ID for the object. Not provided by the API.
CallerIDstringThe caller ID phone number used for voice authentication calls.
DuoMobileOtpTypestringThe type of mobile OTP supported (e.g. TOTP and HOTP).
EmailActivityNotificationEnabledbooleanWhether email activity notifications are enabled.
EnrollmentUniversalPromptEnabledbooleanWhether enrollment universal prompt is enabled.
FraudEmailstringThe email address to receive fraud reports.
FraudEmailEnabledbooleanWhether fraud email notifications are enabled.
GlobalSspPolicyEnforcedbooleanWhether global SSP (Security Settings Policy) is enforced.
HelpdeskBypassstringThe helpdesk bypass setting (e.g. allow, deny).
HelpdeskBypassExpirationintegerThe helpdesk bypass expiration time in seconds.
HelpdeskCanSendEnrollEmailbooleanWhether helpdesk can send enrollment emails.
HelpdeskMessagestringThe helpdesk message displayed to users.

DuoAccountSummarys

Contains summary-level account metadata (a snapshot view of key account attributes and counts useful for reporting or inventory).

NameTypeDescription
IDintegerCompyl-defined ID for the object. Not provided by the API.
AdminCountintegerThe current number of admins in the account.
EditionstringThe current edition (including trials) of the account.
IntegrationCountintegerThe current number of integrations in the account.
TelephonyCreditsRemainingintegerThe current total number of telephony credits available in the account. This is the sum of all types of telephony credits.
UserCountintegerThe current number of users in the account.
UserPendingDeletionCountintegerThe current number of users pending deletion from the account (seen in the Admin Panel's Trash view).

DuoAdminLogs

Captures administrative audit events (who changed what and when) for actions performed in the Duo admin environment.

NameTypeDescription
IDintegerCompyl-defined ID for the object. Not provided by the API.
ActionstringThe action performed (e.g. user_update, admin_login_error).
DescriptionstringString detailing what changed either as free-form text or serialized JSON.
IsoTimestampdatetimeResponse is an ISO 8601 formatted timestamp converted to a DateTime object.
ObjectstringThe object that was acted on. For example: jsmith (for users) (555) 713-6275 x456 (for phones) or HOTP 8-digit 123456 (for tokens).
TimestampdatetimeGets or sets the timestamp of the admin log event. Response is a Unix timestamp (in seconds) converted to a DateTime object.
UsernamestringThe full name of the administrator who performed the action in the Duo Admin Panel. If the action was performed with the API this will be API. Automatic actions like deletion of inactive users have System for the username. Changes synchronized from Directory Sync will have a username of the form (example) AD Sync: name of directory.

DuoAdminUnits

Represents administrative “units” or scoped partitions used to segment administration (so admins can be limited to specific groups of users, integrations, or other resources).

NameTypeDescription
AdminUnitIDstringThe unique identifier for the administrative unit.
DescriptionstringThe description of the administrative unit.
NamestringThe name of the administrative unit.
RestrictByGroupsbooleanWhether the administrative unit restricts access by groups.
RestrictByIntegrationsbooleanWhether the administrative unit restricts access by integrations.
AdminsList<DuoAdminModel>Admins that are part of this unit. Note: this is not populated by the API Response but is a valid relationship to EF.

DuoAdmins

Lists Duo administrator identities, representing users who can manage Duo configuration and perform admin actions.

NameTypeDescription
AdminIDstringThe unique identifier for the administrator.
CreateddatetimeThe Unix timestamp (in seconds) of when the administrator was created.
EmailstringThe email address of the administrator.
LastDirectorySyncdatetimeThe Unix timestamp (in seconds) of the last directory sync for the administrator.
LastLogindatetimeThe Unix timestamp (in seconds) of the administrator's last login.
NamestringThe name of the administrator.
PasswordChangeRequiredbooleanWhether a password change is required for the administrator.
PhoneNumberstringThe phone number associated with the administrator.
RestrictedByAdminUnitsbooleanWhether the administrator is restricted by administrative units.
RolestringThe role of the administrator. Possible values: Owner, Administrator, User Manager, Help Desk, Billing, Read-only, Phishing Manager.
StatusstringThe status of the administrator. Possible values: active, disabled.
PhonesList<DuoPhoneModel>Navigation property (List<DuoPhoneModel>)
TokensList<DuoTokenModel>Navigation property (List<DuoTokenModel>)
WebAuthCredentialsList<DuoWebAuthCredentialModel>Navigation property (List<DuoWebAuthCredentialModel>)
AdminUnitsList<DuoAdminUnitModel>Navigation property (List<DuoAdminUnitModel>)

DuoAuthLogs

Stores authentication events generated by Duo MFA (approvals/denials, factors used, timestamps, and related context) for monitoring and investigations.

NameTypeDescription
IDintegerCompyl-defined ID for the object. Not provided by the API.
AliasstringThe alias associated with the authentication.
EmailstringThe email address of the user who authenticated.
EventTypestringThe type of event (e.g. authentication).
FactorstringThe authentication factor used (e.g. duo_push, sms, phone etc.).
IsoTimestampdatetimeThe ISO 8601 formatted timestamp of the authentication event.
ReasonstringThe reason for the authentication result.
ResultstringThe result of the authentication (e.g. success, failure, fraud, error).
TimestampdatetimeThe Unix timestamp (in seconds) of the authentication event.
TrustedEndpointStatusstringThe trusted endpoint status (e.g. not trusted, trusted).
TxidstringThe transaction ID for the authentication event.
AccessDeviceBrowserstringThe browser name from the access device (e.g. Chrome, Firefox, Safari).

DuoChildIntegrations

Tracks integrations that are linked beneath another integration or account context (useful when modeling hierarchical or delegated integration relationships).

NameTypeDescription
ChildIntegrationKeystringThe child integration key which uniquely identifies the child integration. Note: This is NOT the main Duo Integration Key
AdminApiAdminsintegerWhether the integration has permission to manage administrators via the Admin API (1 = enabled 0 = disabled).
AdminApiAdminsReadintegerWhether the integration has permission to read administrators via the Admin API (1 = enabled 0 = disabled).
AdminApiAllowToSetPermissionsintegerWhether the integration has permission to set Admin API permissions for other integrations (1 = enabled 0 = disabled).
AdminApiInfointegerWhether the integration has permission to retrieve account information via the Admin API (1 = enabled 0 = disabled).
AdminApiIntegrationsintegerWhether the integration has permission to manage integrations via the Admin API (1 = enabled 0 = disabled).
AdminApiReadLogintegerWhether the integration has permission to read logs via the Admin API (1 = enabled 0 = disabled).
AdminApiReadResourceintegerWhether the integration has permission to read resources via the Admin API (1 = enabled 0 = disabled).
AdminApiSettingsintegerWhether the integration has permission to read and change global Duo account settings via the Admin API (1 = enabled 0 = disabled).
AdminApiWriteResourceintegerWhether the integration has permission to write resources via the Admin API (1 = enabled 0 = disabled).
FramelessAuthPromptEnabledintegerWhether frameless authentication prompt is enabled (1 = enabled 0 = disabled).
GreetingstringThe greeting message displayed to users during authentication.

DuoDesktopAuthenticators

Holds records of desktop authenticator registrations/devices associated with users for MFA flows where desktop authenticators are used.

NameTypeDescription
DesktopAuthenticatorIDintegerThe unique identifier for the desktop authenticator.
DesktopAuthenticatorKeystringThe key for the desktop authenticator. Note: this is from the Duo API this is not the table key.
DeviceNamestringThe name of the device running the desktop authenticator.
DuoDesktopVersionstringThe version of Duo Desktop installed on the device.
OsFamilystringThe operating system family of the device. Possible values: Windows, Mac, Linux.
UsersList<DuoUserModel>Users that are related to this DA. Note: this is not populated by the API Response but is a valid relationship to EF.

DuoGroups

Represents Duo groups used to organize users for policy assignment, access control, and administrative scoping.

NameTypeDescription
GroupIDstringThe unique identifier for the group.
NamestringThe name of the group.
DescriptionstringThe description of the group.
MobileOtpEnabledbooleanLegacy parameter; no effect if specified and always returns false
PushEnabledbooleanWhether push authentication is enabled for this group.
SmsEnabledbooleanWhether SMS authentication is enabled for this group.
StatusstringThe status of the group. Possible values: active, bypass, disabled.
VoiceEnabledbooleanWhether voice authentication is enabled for this group.
UsersList<DuoUserModel>Users that are related to this Group. Note: this is not populated by the API Response but is a valid relationship to EF.

DuoPhones

Stores enrolled phone/device records used as second-factor devices (for example, for Duo Push, SMS, or phone call verification).

NameTypeDescription
PhoneIDstringThe unique identifier for the phone.
ActivatedbooleanWhether the phone has been activated for Duo Mobile.
AppVersionstringThe version of the Duo Mobile app installed on the phone.
CapabilitiesSerializedstringThe serialized list of phone capabilities (e.g. push, sms, phone, mobile_otp).
CreationDatedatetimeThe date when the phone was created.
EncryptedstringThe encryption status of the phone. Possible values: encrypted, unencrypted.
ExtensionstringThe phone extension if applicable.
FingerprintstringThe device fingerprint for the phone.
LastActivatedDatedatetimeThe date when the phone was last activated.
LastSeendatetimeThe date when the phone was last seen by Duo.
ModelstringThe model of the phone device.
NamestringThe name assigned to the phone.

DuoTokens

Contains hardware token records (and related token metadata) used as authentication factors for Duo MFA.

NameTypeDescription
TokenIDstringThe unique identifier for the hardware token.
SerialstringThe serial number of the hardware token.
TypestringThe type of hardware token. Possible values: h6, h8, yubikey etc.
UsersList<DuoUserModel>Users that are related to this Token. Note: this is not populated by the API Response but is a valid relationship to EF.
AdminsList<DuoAdminModel>Admins that are related to this Token. Note: this is not populated by the API Response but is a valid relationship to EF.

DuoUsers

Stores Duo user identities enrolled for MFA, including the user objects that factors (phones/tokens) attach to.

NameTypeDescription
UserIDstringThe unique identifier for the user.
FirstNamestringThe user's first name.
LastNamestringThe user's last name.
EmailstringThe email address of the user.
UserNamestringThe username of the user.
AliasesSerializedstringThe serialized list of user aliases (alias1 through alias8).
CreateddatetimeThe Unix timestamp (in seconds) of when the user was created.
DateOfBirthdatetimeThe user's date of birth.
DirectoryKeystringThe directory key if the user is synced from a directory.
EnableAutoPromptbooleanWhether automatic prompt is enabled for the user.
EntraFederatedUserIDstringThe Entra (Azure AD) federated user ID if applicable.
ExternalIDstringThe external ID of the user from the directory.

DuoWebAuthCredentials

Represents WebAuthn/FIDO2 credential registrations tied to users (passkeys/security keys) used for phishing-resistant authentication.

NameTypeDescription
WebAuthkeystringThe unique identifier (key) for the WebAuthn credential.
CredentialNamestringThe name of the WebAuthn credential.
DateAddeddatetimeThe Unix timestamp (in seconds) of when the credential was added.
DateLastUseddatetimeThe Unix timestamp (in seconds) of when the credential was last used.
LabelstringThe label for the WebAuthn credential.
UsersList<DuoUserModel>Users that are related to this WebAuthCredentials. Note: this is not populated by the API Response but is a valid relationship to EF.
AdminsList<DuoAdminModel>Admins that are related to this WebAuthCredentials. Note: this is not populated by the API Response but is a valid relationship to EF.


Did this page help you?