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

# Duo

> Follow these steps to connect Duo via the StackOne Hub successfully.

<Warning>
  Ensure you have the Owner role within Duo.
</Warning>

If you've been directed to StackOne to integrate with Duo, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Get Your Duo Integration Credentials

<Steps>
  <Step title="Log in to Duo Admin">
    When logged in to your [Duo Admin](https://admin.duosecurity.com), click Applications.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Duo Admin Applications" src="https://mintcdn.com/stackone-hub/jJJwouxQZP5GatHi/images/duo/image1.png?fit=max&auto=format&n=jJJwouxQZP5GatHi&q=85&s=8c79a703e8a38a8ff5a60e804bf901e6" width="466" height="594" data-path="images/duo/image1.png" />
    </Frame>
  </Step>

  <Step title="Protect an Application">
    Click the Protect an Application button on the right.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Protect an Application" src="https://mintcdn.com/stackone-hub/jJJwouxQZP5GatHi/images/duo/image2.png?fit=max&auto=format&n=jJJwouxQZP5GatHi&q=85&s=50c1b9c97b6f6bdd5ca3747f3a9963cd" width="1906" height="796" data-path="images/duo/image2.png" />
    </Frame>
  </Step>

  <Step title="Select Admin API">
    Scroll down to Admin API and click the Protect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Admin API" src="https://mintcdn.com/stackone-hub/jJJwouxQZP5GatHi/images/duo/image3.png?fit=max&auto=format&n=jJJwouxQZP5GatHi&q=85&s=f575154c127c98bfc55e811ac19cb5dd" width="1587" height="743" data-path="images/duo/image3.png" />
    </Frame>
  </Step>

  <Step title="Copy Credentials">
    Copy and safely store each of the following credentials displayed. These will be required for connection:

    <ul>
      <li>Integration key</li>
      <li>Secret key</li>
      <li>API hostname</li>
    </ul>

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Credentials" src="https://mintcdn.com/stackone-hub/jJJwouxQZP5GatHi/images/duo/image4.png?fit=max&auto=format&n=jJJwouxQZP5GatHi&q=85&s=17f4b1e97b82b624e9e70d9259569973" width="1918" height="908" data-path="images/duo/image4.png" />
    </Frame>
  </Step>

  <Step title="Set Permissions">
    Scroll down to Permissions, and ensure that the following are enabled:

    <ul>
      <li>Grant administrators</li>
      <li>Grant read information</li>
      <li>Grant settings</li>
      <li>Grant read resource</li>
      <li>Grant write resource</li>
    </ul>

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Permissions" src="https://mintcdn.com/stackone-hub/jJJwouxQZP5GatHi/images/duo/image5.png?fit=max&auto=format&n=jJJwouxQZP5GatHi&q=85&s=3b77575f6f40b88d7d74f989677807d8" width="1119" height="578" data-path="images/duo/image5.png" />
    </Frame>
  </Step>

  <Step title="Save Changes">
    Scroll down to click the Save changes button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Save Changes" src="https://mintcdn.com/stackone-hub/jJJwouxQZP5GatHi/images/duo/image6.png?fit=max&auto=format&n=jJJwouxQZP5GatHi&q=85&s=0e215e401140862be08a4df0246a7752" width="1588" height="933" data-path="images/duo/image6.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter the credentials you stored in the previous step:

    <ul>
      <li>Integration Key</li>
      <li>Secret Key</li>
      <li>Hostname</li>
    </ul>

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub/u-H1QhLRqf-fRM_1/images/duo/image7.png?fit=max&auto=format&n=u-H1QhLRqf-fRM_1&q=85&s=4d36a19a7d5f3ed703500bb00c14c566" width="524" height="751" data-path="images/duo/image7.png" />
    </Frame>
  </Step>

  <Step title="Connect">
    Proceed by clicking the Connect button.
  </Step>
</Steps>

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
  <li>Groups</li>
</ul>

## Useful Links

<Card title="API Reference" icon="link" href="https://duo.com/docs/adminapi#administrators">
  [https://duo.com/docs/adminapi#administrators](https://duo.com/docs/adminapi#administrators)
</Card>