Duo Security

Duo provides two-factor authentication, endpoint remediation, and secure single sign-on tools. The Sumo Logic App for Duo Security helps you monitor your Duo account’s authentication logs, administrator logs, and telephony logs. The dashboards provide insight into failed and successful authentications, events breakdown by applications, factors, and users, geo-location of events, admin activities, outliers, threat analysis of authentication, and administrator events.

Log Types

The Duo Security App uses following logs. See Duo documentation for details of the log schema.

When you generate the Duo credentials, you should do it for the Admin API application.

• Authentication Logs
• Administrator Logs
• Telephony Logs

Collecting Logs for the Duo Security App

To collect logs from the Duo Security App, use the new Cloud to Cloud Integration for Duo Security App to create the source and use the same source category while installing the app.

Installing the Duo Security App and View the Dashboards

This section provides instructions on how to install the Duo Security App, as well as an example of each of the App dashboards. The App dashboards provide insight into failed and successful authentications, administrator events, and outlier events.

The Duo Security App helps you monitor your Duo account’s authentication, administrator, and telephony logs.

To install the app:

1. From the left nav, select App Catalog.
   
2. Search for your app name and select it.
3. When you get to your app page:
   • If you want to see a preview of the dashboards included with the app before installing, scroll down to Dashboard Preview.
   • If your Sumo Logic app has multiple versions (not all apps do), select the version of the service you're using.
     
   • Click Add Integration.
     
4. On the next configuration page, Select Data Source for your App, complete the following fields:
   • Data Source. Select one of the following options:
     • Choose Source Category, and select a source category from the list; or
     • Choose Enter a Custom Data Filter, and enter a custom source category beginning with an underscore. For example, _sourceCategory=MyCategory.
   • Folder Name. You can retain the existing name or enter a custom name of your choice for the app.
   • All Folders (optional). Default location is the Personal folder in your Library. If desired, you can choose a different location and/or click New Folder to add it to a new folder.
5. Click Next.
   
6. You'll see a dialog confirming that the app was installed successfully.
   

Once an app is installed, it will appear in your Personal folder, or other folder that you specified. From here, you can share it with your organization.

Panels will start to fill automatically. It's important to note that each panel slowly fills with data matching the time range query and received since the panel was created. Results won't be available immediately, but within 20 minutes, you'll see full graphs and maps.

Viewing the Duo Security Dashboards

Overview

Overview of Duo Events including events breakdown by type, geographic location, one-day time comparison of events, and admin activity.

Administrator Events

Geographic location of admin events, one-day time comparison of events, login errors, admin activity over time, and events breakdown by action.

Success Authentications

Geographic location of successful authentication events, one-day time comparison of events, breakdown of events by Application, Factor, Users, Country, State, and City.

Failed Authentications

Geographic location of failed authentication events, one-day time comparison of failed events, breakdown of events by Application, Factor, Users, Country, State, and City.

Outliers and Threat Analysis

Outliers and threat analysis of Duo events.