# HydrantID

## Connection Requirements

{% stepper %}
{% step %}

### Domain

Enter the domain of your Hydrant ID instance. This is the URL where the service is hosted. (default acm.hydrantid.com)
{% endstep %}

{% step %}

### Port

Enter the port number required for Hawk authentication method. (default 443)
{% endstep %}

{% step %}

### Hawk ID and Hawk Key

With Hawk Auth, each user will be issued two randomly generated strings by HydrantID - an ID that will appear in the request, as well as a key that will be used to sign the request. ACM provides REST API methods to manage Hawk credentials for a user. Each user account is allowed up to 5 sets of Hawk credentials to access the REST API. It is recommended that users "roll" their credentials from the initial values set by HydrantID on an as-needed basis for security. Optional comments can be added to credentials for descriptive purposes.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
⚠️ **Attention**\
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/hydrantid.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.