Cisco Duo

Duo is a two-factor authentication solution that helps organizations boost security by verifying user identity, establishing device trust, and providing a secure connection to company networks and applications. Duo multi-factor authentication protects your organization's data at every access attempt, from any device and location. For detailed information, refer to the Cisco Duo’s official documentation.

Integration Method: API

Tables: Authentication (3002)

This integration supports the following events.

This integration supports the following versions.

Note:

Cisco Duo is a continuously updated cloud service. As of this document preparation, latest release was on March 14th, 2025.

Prerequisites

• The user should have access to the Cisco Duo platform with an account having admin privilege.

• The user should have access to DataBee console.

Configuration Overview

1. Generate an Integration Key and Secret Key from Cisco Duo Admin platform to access the APIs.

2. Add the Cisco Duo data feed in the DataBee console with the below parameters.

   DataBee Parameter	Cisco Duo Parameter
   API Base URL (<instance>)	Hostname
   Integration Key	Integration Key
   Secret Key	Secret Key

Cisco Duo Configuration

1. Sign in to the Cisco Duo Admin platform.
    

2. Navigate to Applications > Protect an Application.
    
   

3. Locate the entry for Admin API in the applications list. And click Protect.
    
   

4. Go to Permissions, and select Grant read log.
    
   

5. Click on Save Changes.
    
   

6. Copy the Integration key, Secret key and API hostname.
    

DataBee Configuration

1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
    
   

2. Search for the Cisco Duo and click it as shown below.
    
   

3. Click on the API Ingest option for collection method.
    
   

4. Enter feed contact information and click Next.
    
   

5. In the configuration page, confirm the following:

   • Authorization Method: HMAC Auth

   • API Base URL: this is the base URL that DataBee will interact with. Replace the <instance> placeholder with generated hostname.

   • Integration Key: enter the above generated Integration Key.

   • Secret Key: enter the above generated Secret Key.

   • Event Types: preselected for all the event types that integration pulls.

   

6. Click Submit.

Troubleshooting Tips

• Ensure Integration Key, Secret Key and Hostname are pasted correctly. If credentials are lost, Reset Secret Key and reconfigure the data source. Ensure no spaces or unexpected characters are included and reconfigure the DataBee feed.

• Ensure Grant Read Log Permission is provided.