# 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 %}