Duo® Security

Duo® Security increases security with Two-Factor Authentication (2FA). 2FA using Duo Security combines traditional account credentials (like a username and password) with a code or other verification from a device like a smart phone. Requiring both to log in decreases the threat of a leaked password.

Use of Duo Security is free for up to 10 accounts, and the Duo® Mobile app is available on all major smartphone platforms.

Our Duo Security integration supports Duo Universal Prompt, which uses Duo Push by default. This pushes login or transaction details to your phone, allowing for immediate one-tap approval.

  • If you already used Duo Security with the previous integration, you must log in to the Duo portal and upgrade your API credentials to use Duo Universal Prompt.
  • Duo announced that support for the previous iframe-based Duo Prompt ended on 2024-03-30.
    • Duo’s support teams cannot troubleshoot issues with the previous Duo Prompt.
    • We strongly recommend activating Universal Prompt in your Duo admin portal to ensure continued functionality. If you do not do this, your customers may experience problems.

You can configure Duo Security as a 2FA service at Configuration () > System Settings > Two Factor Authentication.

For steps and more information about enabling 2FA globally, see Enable 2FA Globally.

Configuring Duo Security

Before you can configure Duo Security globally in WHMCS, you must perform additional steps to retrieve your Duo credentials.

To retrieve your credentials from Duo and configure Duo Security:

  1. Log in to your Duo Security account.
    You must create a Duo Security account with an account level of Duo MFA or higher in order to access the Duo API.
  2. Click Applications in the left side menu.
  3. Under Web SDK, click Protect this Application.
  4. Retrieve the Client ID, Client Secret, and API hostname values.
  5. Enter these values at Configuration () > System Settings > Two Factor Authentication when you configure Duo Security.
    Configuring Duo Security in WHMCS

Using Existing Duo Accounts

The WHMCS Duo integration uses the following format for admins that it transmits to Duo:

adminemailaddress:adminemailaddress:whmcslicensekey

You can use existing Duo accounts or users to complete 2FA into the Admin Area. To do this, use the alias function in Duo to create an alias for the admin.

For more information, see Duo’s Aliases Guide documentation.

Reactivating a user

When a user replaces or loses a 2FA device, they will need to reauthenticate Duo Security in order to enable the prompt. To achieve this, an admin will need to delete and restore the users from within the Duo dashboard.

For more information, see Duo’s documentation.
two-factor-authentication authentication duo-security

Last modified: 2025 April 3