Integrating with Duo Security

Overview

Blumira integrates with Duo Security to stream authentication and endpoint logs and alerts to Blumira for threat detection and actionable response. We then apply threat intelligence and user entity behavior analytics to detect malicious and high-risk logins, such as geo-impossible logins.

Important: Dedicate a specific Admin API application in Duo to your Blumira integration. Do not reuse the same Duo Admin API credentials for multiple applications. Rate limits for Duo's API will cause logging delays or disruption if too many requests are processed with the same credentials.

Before you begin

Before you can add the Duo Security Cloud Connector in Blumira, you must gather your Duo Admin API credentials:

• Duo integration key
• Duo secret key
• Duo API hostname

To obtain your Duo Admin API information complete the steps in Duo Admin API: First Steps.
In Step 4, ensure that you check the boxes next to these permissions:

• Grant read information
• Grant read log
  

Providing your API credentials to Blumira

Cloud Connectors automate the configuration of your integrations without requiring you to use a sensor. After you obtain your integration's configuration parameters, you can then enable Blumira to collect your logs.

To configure your integration with Blumira Cloud Connector:

1. In the Blumira app, go to the Cloud Connectors page (Settings > Cloud Connectors).
2. Click + Add Cloud Connector.
3. In the Available Cloud Connectors window, click the connector that you want to add.
4. If you want to change the name of the Cloud Connector, type the new name in the Cloud Connector Name box.
5. Enter the API credentials that you collected in the "Before you begin" section above.
6. Click Connect.
7. On the Cloud Connectors screen, under Current Status, you can view the configuration’s progress. When the configuration completes, the status changes to Online (green dot).
   Important: If you previously deployed a Module for this integration, then you must remove it via the Sensors page (Settings > Sensors) to avoid log duplication.

Testing a Duo Detection

1. Have the Duo Admin Panel and Blumira app open.
2. Go to an application protected by Duo Security.
3. Once on the Duo Prompt (MFA) screen, select Send Me a Push to send a prompt to your mobile device or tablet.
4. Deny the push notification by tapping the red X.
5. Tap Report as Fraud.
6. Within minutes, a finding alert appears in Blumira.