> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Duo Auth

> The Duo Auth API allows adding strong two-factor authentication to your website or application.

## Creating a Duo Auth connection[​](#creating-a-duo-auth-connection "Direct link to Creating a Duo Auth connection")

## Using Secret Key[​](#using-secret-key "Direct link to Using Secret Key")

To create the connection you need:

* A Duo Auth Domain
* An Integration Key
* A Secret Key

### Obtaining the credentials[​](#obtaining-the-credentials "Direct link to Obtaining the credentials")

1. Log in to Duo's admin portal.

2. Navigate to **Application** > **Applications**.

   <img src="https://mintcdn.com/blinkops-2/CAgQojQeorlb2r8I/img/Duo/Duo-portal.png?fit=max&auto=format&n=CAgQojQeorlb2r8I&q=85&s=fc7ccbe45c247576ef9b3250df45e01d" alt="duo_portal" width="3072" height="1452" data-path="img/Duo/Duo-portal.png" />

3. Click on **+ Protect an application**.

   <img src="https://mintcdn.com/blinkops-2/CAgQojQeorlb2r8I/img/Duo/Duo-protect.png?fit=max&auto=format&n=CAgQojQeorlb2r8I&q=85&s=99cb838eb290761ce9071b94d71865f6" alt="duo_protect" width="3446" height="1590" data-path="img/Duo/Duo-protect.png" />

4. Search for the Auth API application, and click on **Protect**.

   <img src="https://mintcdn.com/blinkops-2/CAgQojQeorlb2r8I/img/Duo/duo-auth-protect.png?fit=max&auto=format&n=CAgQojQeorlb2r8I&q=85&s=e26c9294c450b921a69f1d8575744df4" alt="duo_protect_auth" width="3404" height="1446" data-path="img/Duo/duo-auth-protect.png" />

5. On the Auth application settings page, click on **Edit Global Policy**.

   <img src="https://mintcdn.com/blinkops-2/CAgQojQeorlb2r8I/img/Duo/duo-auth-policy.png?fit=max&auto=format&n=CAgQojQeorlb2r8I&q=85&s=b8aa93c4156a0e5974e246502b5072b7" alt="duo_admin_permissions" width="3424" height="1704" data-path="img/Duo/duo-auth-policy.png" />

6. On the **Authentication methods** section, choose the capabilities you want to enable on devices for authentication, and hit **Save Policy**.

   <img src="https://mintcdn.com/blinkops-2/CAgQojQeorlb2r8I/img/Duo/auth_methods.png?fit=max&auto=format&n=CAgQojQeorlb2r8I&q=85&s=8f6e75e8e12f58f5804cd49e8ed8c1c2" alt="auth_methods" width="1992" height="1554" data-path="img/Duo/auth_methods.png" />

   <Info>
     To enable capabilities that involve the **Duo Mobile** App (Duo push,
     Verified Duo Push), you need to activate it. Follow the instructions on
     [Duo's
     documentation](https://duo.com/docs/administration-users#activating-duo-mobile)
     to activate **Duo Mobile**.
   </Info>

7. Scroll up and copy the connection details.

   <img src="https://mintcdn.com/blinkops-2/CAgQojQeorlb2r8I/img/Duo/auth_creds.png?fit=max&auto=format&n=CAgQojQeorlb2r8I&q=85&s=9608ceaa1b409a931bac336f60cc17f3" alt="auth_creds" width="3452" height="1484" data-path="img/Duo/auth_creds.png" />

### Creating your connection[​](#creating-your-connection "Direct link to Creating your connection")

1. In the Blink platform, navigate to the **Connections** page > **Add connection**. A New Connection dialog box opens displaying icons of external service providers available.

2. Select the **Duo Auth** icon. A dialog box with name of the connection and connection methods appear.

3. (Optional) Edit the name of the connection. At a later stage you cannot edit the name.

4. Select **Secret Key** as the method to create the connection.

5. Fill in the parameters:

   * The Duo Auth Domain
   * The Integration Key
   * The Secret Key

6. (Optional) Click **Test Connection** to test it.

7. Click **Create connection**. The new connection appears on the **Connections** page.