Skip navigation
Documentation

Deploying a Proof of Concept

Contents

Deploying a "proof-of-concept" installation takes just a few minutes, and is the best way to learn the basics of administering Duo two-factor authentication.

Overview

We strongly suggest deploying Duo to a small subset of users before releasing it to your entire user base. Deploying a "proof-of-concept" installation using this quick-start guide takes just a few minutes, and will familiarize you with application administration, as well as Duo's bulk self-enrollment tool and new user policy features. Once you are comfortable with Duo administration, you can easily expand your pilot installation to protect additional users or services.

Proof of Concept Deployment

Here's how to set up your proof-of-concept:

  1. Log in to the Duo Admin Panel, go to Applications (on the left sidebar), and click the + Protect an Application button at the top of the page.

    Protect an Application

  2. Locate the type of application for your proof of concept from the list (you can filter the list by typing in a keyword), then click Protect this Application. You'll automatically be sent to the properties page for your new application. (See our Protecting Applications documentation for more details.)

    Filter Application List

  3. By default, all users are asked to enroll with Duo when they log in for the first time after installation. You'll want to change this behavior so that users who aren't part of the proof of concept will continue to log in normally. To change the new user policy, scroll down to the "Policy" section on the application's properties page and select Allow Access. Then scroll to the bottom of the page and click the Save Changes button.

    New User Policy

    From now on, only users who are participating in the proof of concept and have completed enrollment (as in step 6) will be asked to provide secondary authentication. Unenrolled users will log in as usual, with no two-factor authentication dialog.

  4. Next you'll invite the users participating in the two-factor proof of concept to enroll in Duo. To do this, click on Users in the left sidebar of the Duo Admin Panel. Now click the Bulk Enroll Users button at the top of the Users page.

    Bulk Enroll Button

  5. On the Bulk Enroll Users page, enter the usernames and email addresses of the participating users. These users will receive an email informing them that their administrator has requested they enroll in a two-factor authentication service. That email includes an individualized link so the user can enroll immediately. You can edit the text of this email. When you're ready to send the enrollment email, click the Send Enrollment Links button at the bottom of the page. See the Bulk Self-Enrollment documentation for more detailed instructions.

    Bulk Enroll Users

  6. Once these users click on the link in the email message and complete enrollment they'll be enrolled in Duo's service. These users will now be able to securely log in using Duo's two-factor authentication system.

    Bulk Enroll Users

  7. Configure your system to use Duo two-factor authentication with the application created in step 2 by and the documentation specific to your device or service.

  8. Ask the newly enrolled proof-of-concept users to log in to the Duo protected service. They will now see the Duo prompt and be asked to complete secondary authentication. Unenrolled users will not be prompted for secondary authentication.

    Cisco SSL VPN with Duo Authentication

Next Steps

Expand your successful proof-of-concept by enrolling additional users with bulk enrollment, AD sync, or another method, or by adding additional applications to protect your other services.

When you're ready to protect all your users with Duo two-factor authentication, be sure to edit your application's properties to change the new user policy back to Require Enrollment (or to Deny Access if your preference is to email your users enrollment links instead of allowing them to self-enroll in Duo when logging in to your protected system).

Troubleshooting

Need some help? Try searching our Knowledge Base articles or Community discussions. For further assistance, contact Support.

Ready to Get Started?

Sign Up Free