# Cisco Duo

## Connection Requirements

{% stepper %}
{% step %}

### Api hostname

This is the unique API server address for your Duo account. It is the URL where your application must send its API calls. It's custom-generated for each Duo account and typically follows the format `api-xxxxxxxx.duosecurity.com`.
{% endstep %}

{% step %}

### Integration key

This is a public identifier that uniquely identifies your application. It's how your application says, "This is me," when it makes an API call. It specifies which application or service is using the API.
{% endstep %}

{% step %}

### Secret key

This is a private password used to cryptographically sign your API calls. Known only to you and Duo, this key proves that the API request is genuinely from you and ensures its integrity. It should never be shared and must be kept confidential. Duo uses this Secret Key along with the Integration Key to verify the validity of the API request.

{% hint style="info" %}
To create a new Admin API connection in Duo, go to the Duo Admin Panel, navigate to the Applications section, and enter the Application Catalog. Select the Admin API and add the application. Duo will then automatically provide the necessary Integration Key, Secret Key, and API Hostname for administrative tasks like managing users and devices. Add these keys to your application's code to complete the API connection.
{% endhint %}

{% hint style="info" %}
To find the information for an Admin API you've already created, log into the Duo Admin Panel and go to the Applications section from the left-hand menu. Click on your Admin API in the list of applications to open the details page and view your Integration Key, Secret Key, and API Hostname. Note: for security, the Secret Key may only have been shown once; if you didn't save it, you may need to generate a new key.
{% endhint %}
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Please perform a connection test to ensure there is a valid connection to the host. When the discovery operation is finalized, you will be able to see the details on the Assets page.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.octoxlabs.com/adapters/adapters/cisco-duo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.