Skip navigation

Duo for WordPress


Duo's WordPress plugin enables two-factor authentication for WordPress logins, complete with inline self-service enrollment and authentication prompt. The code is open-source and available on GitHub.


First Steps

  1. Sign up for a Duo account.
  2. Log in to the Duo Admin Panel and navigate to Applications.
  3. Click Protect an Application and locate WordPress in the applications list. Click Protect this Application to get your integration key, secret key, and API hostname. (See Getting Started for help.)

Install and Configure the Plugin

  1. Log in to your WordPress blog as an administrator. Navigate to PluginsAdd New in the left navigation bar. Then search for "Duo Security" and click Install Now for the Duo Two-Factor Authentication plugin.

    Plugin Search

    To install the Duo two-factor plugin without using the WordPress Plugin directory, first download the Duo plugin as a zipped package from WordPress.

    In the WordPress console go to PluginsAdd New and click the Upload Plugin button.

    Click Choose File and select the package you downloaded. Click Install Now to upload Duo's plugin to your WordPress site.

    Upload Plugin

  2. Click Activate Plugin after installing the Duo plugin:

    Activate Duo Plugin

  3. After activation, click Settings to configure the plugin.

    Plugin Search

  4. Copy and paste your integration key, secret key, and API hostname from the Duo WordPress application you created earlier. You may select which WordPress user roles need to authenticate using Duo. For example, you may only require those users with the "Administrator" role to use two-factor authentication, or require all roles to use two-factor.

    To fully secure your WordPress site Duo recommends that you disable XML-RPC. However, this will prevent use of offline Weblog clients and the WordPress mobile app.

    Plugin Search

    Click Save Changes to complete configuration.

Test Your Setup

Open a new browser (or incognito window) and try to log in to your WordPress account. You should be prompted to set up your two-factor authentication. Complete the enrollment process.

Duo Authentication Prompt


Need some help? Take a look at the WordPress Frequently Asked Questions (FAQ) page or try searching our WordPress Knowledge Base articles or Community discussions. For further assistance, contact Support.

Network Diagram

  1. WordPress connection initiated
  2. Primary authentication
  3. WordPress connection established to Duo Security over TCP port 443
  4. Secondary authentication via Duo Security’s service
  5. WordPress receives authentication response
  6. WordPress session logged in

Ready to Get Started?

Sign Up Free