Close
logodocs

Set up MFA with Duo

Duo Security is available as a multi-factor authentication (MFA) option for your strongDM users. This guide describes how to set up and configure MFA using Duo.

Set Up Duo

The first part of the setup process takes place in the Duo Admin panel. Log in as an administrator of your Duo account and perform the following steps.

  1. Go to Applications and then Protect an Application.
    Duo/Applications
    Duo/Applications
  2. From the list of application types, find Web SDK and click Protect.
    Web SDK
    Web SDK
  3. Be sure to note the client ID, client secret, and API hostname, as they are needed later.
    Details/Keys
    Details/Keys
  4. Under Settings, set up the policy, name, voice greeting, and other options according to your organization's preferences.
  5. Save changes.

You are done here. Keep this browser window open to copy the key and API information when setting up strongDM in the next section.

Set Up strongDM

The setup continues in the strongDM Admin UI.

  1. Go to Settings, then Security, and scroll down to Multi-factor Authentication.

  2. Click to unlock the fields and allow changes. Then select Duo from the dropdown menu.

  3. Using the values you noted in the Duo Admin panel, paste the client ID into the Integration Key field, the client secret into the Secret Key field, and API hostname into the Duo API URL field.

    MFA Setup
    MFA Setup
  4. Click Test MFA to test the MFA settings. This requires your admin account to be registered as a user in Duo.

    MFA Test Success
    MFA Test Success
  5. Click Activate to enable Duo MFA. This displays a warning message that users cannot log in without MFA enrollment going forward.

    MFA Warning
    MFA Warning

    Ensure that Test MFA is successful before activating MFA or your admin account may become locked out!

Log in With Duo MFA Enabled

The login process once Duo MFA is enabled includes only one change. After entering the username and password, the login page contains a "Waiting for MFA..." message, which displays until the Duo challenge is accepted. The process of logging in to the GUI or the CLI with Duo MFA enabled is similarly altered.

Register a New User With Duo MFA Enabled

When Duo MFA is enabled, the new user registration process halts when the user clicks the link in the invitation email, then displays a link to the Duo self-enrollment process. Once the enrollment steps are complete, the user can return to the strongDM window to finalize the login process.

Troubleshoot MFA With Duo

You may run into issues authenticating your strongDM account with Duo MFA enabled. The following topics can help you troubleshoot any errors you receive while logging in.

Duo username mismatch with strongDM username

If a username in Duo does not match a strongDM username (which is typically an email address), you need to create an alias in Duo for that user. These usernames must match to take advantage of Duo MFA for a particular user.

When is MFA authentication triggered?

When MFA is enabled in strongDM, you are prompted to authenticate in the following circumstances:

  • strongDM Desktop App

    • Idle timeout (configurable in Settings > Authentication)
    • IP address change
    • On wake
    • On login
  • Admin UI

    • Idle timeout (configurable in Settings > Authentication)
    • On login

When you set up an SSO provider to authenticate with strongDM and also enable Duo MFA in the Admin UI, Duo prompts during logins do not occur. In this scenario, Duo only plays a role to re-authenticate users when the strongDM Desktop App locks due to inactivity, not during normal login attempts.

If using SSO, we recommend setting up MFA through your SSO provider to trigger MFA prompts during user logins.

Authentication errors with Duo

ErrorIssueResolution
Invalid MFA configurationYour organization's MFA configuration is not correct.Contact your strongDM administrator.
MFA refused to authenticate this userDuo has preemptively denied authentication.Contact your Duo administrator.
MFA denied accessWhen the push alert arrived, you denied access.Log in again and accept when the push arrives.
User not enrolled in MFAYou are not enrolled with Duo.Contact your Duo administrator.
MFA did not return a response in timeDuo did not receive an accept/deny from your device in time.Try logging in again and accept/deny when the push arrives.
Could not find a valid MFA deviceYour Duo-configured device cannot receive push alerts.Contact your Duo administrator to register another device.
Could not push a notification to MFA deviceDuo was not able to send a push to your device.Contact your Duo administrator.

New device setup or reset

If you get a new mobile device or have to reset your existing device, you may be unable to log in to your Duo-protected account. If this situation occurs, please contact your organization's Duo administrator to provision your device.

Unfortunately, strongDM is unable to assist with provisioning your Duo devices.

Previous
Authentication
Next
Passwords