DUO: Verifying an End-User By Sending them a Push Notification Through the DUO Mobile App
Introduction
Duo (https://duo.com) is a popular identity verification platform. You can use it in MSP Process to acheive two goals:
- To secure the login process of anyone looking to access your MSP Process account at https://app.mspprocess.com. This capability requires the Duo Web SDK to be configured. Click here for the KB article that outlines how to set this up.
- During the end-user verification process; Duo can be used instead of sending the user a verification code via e-mail or SMS. This capability requires the Duo Accounts API and Admin API to be configured.
This KB article will take you through all of the steps required to do the second scenario - to use Duo to verify your end-users, including setting up 2 entities in Duo (their Accounts API and Admin API entities) and configuring the appropriate settings within MSP Process.
Step 1: Protecting the 'Accounts API' Application in Duo
What is the Accounts API? The Accounts API allows Duo MSP partners to create, update, and delete managed Duo Security customer accounts.
Steps to Take in the Duo Admin Portal:
- Login to the Duo Admin portal (https://admin.duosecurity.com/) - you must be an Owner-level user in Duo
- From the left-hand menu, navigate to Application -> Protect an Application
- Search for "Accounts API" in the Search field
- Click on the Protect button beside Accounts API
- In the Basic Configuration section, change Name field to say "Accounts API for MSP Process"
- In the Details section, copy the Integration Key, Secret Key and API Hostname; you'll need them later
- Click Save
Steps to Take in MSP Process:
- Login to the MSP Process portal (https://app.mspprocess.com)
- Navigate to Integrations -> Security Integrations
- Click the Duo Accounts API button
- Specify a name for the integration, and then enter the Integration Key, Secret Key and API Hostname from what you setup earlier in the Duo Admin Portal.
- Click Submit when you're done.
Step 2: Protecting the 'Auth API' Application in Duo
What is the DUO Auth API? Duo Auth API is a low-level, RESTful API for adding strong two-factor authentication to your website or application.
NOTE: You'll need to repeat the steps in this section for each sub-account that you want MSP Process to be able to access.
Steps to Take in the Duo Admin Portal:
- Login to the DUO Admin portal (https://admin.duosecurity.com/)
- From the left-hand menu, navigate to Application -> Protect an Application
- Search for "Auth API" in the Search field
- Click on the Protect button beside DUO Auth API
- In the Basic Configuration section, choose the Enable for all users option
- In the Details section, copy the Integration Key, Secret Key and API Hostname; you'll need them later
- In the Settings section, change Name field to say "Auth API for MSP Process"
- Click Save
Steps to Take in MSP Process:
- In MSP Process, navigate to Integrations -> Security Integrations
- Click the Add new integration button
- Click the Duo Auth API button
- Specify a name for the integration, and then enter the Integration Key, Secret Key and API Hostname from what you setup earlier in the Duo Admin Portal.
- Click Submit when you're done.
Congratulations! You've Done It!
You've now setup the required entities in Duo, and configured MSP Process with the information it needs to start using Duo to verify the identity of your end-users.