# Foreman

## Connection Requirements

{% stepper %}
{% step %}

### IP Address

IP Address of the Foreman.
{% endstep %}

{% step %}

### Port

Port number (optional, default: 443).
{% endstep %}

{% step %}

### Username

Provide the username to authenticate with Foreman.
{% endstep %}

{% step %}

### Access Token

To create a Personal Access Token in the Foreman web UI:

1. In the Foreman web UI, navigate to Administer > Users.
2. Select a user for which you want to create a Personal Access Token.
3. On the Personal Access Tokens tab, click Add Personal Access Token.
4. Enter a Name for your Personal Access Token.
5. Click Submit. You now have the Personal Access Token available to you on the Personal Access Tokens tab.
6. Copy the access token.

Ensure you copy and securely store the token immediately after creation.
{% endstep %}

{% step %}

### Is secure?

Enable this option if the connection will be established over HTTPS.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
⚠️ Attention\
Ensure to store your Personal Access Token as you will not be able to access it again after you leave the page or create a new Personal Access Token.\
You can click Copy to clipboard to copy your Personal Access Token.
{% endhint %}

{% 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/foreman.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.