# PaloAlto Xpanse

## Connection Requirements

{% stepper %}
{% step %}

### FQDN

Log in to Cortex Xpanse and navigate to **Settings → Configurations → Integrations → API Keys**.\
Right-click your generated API key and select **View Examples**.\
Copy the URL shown in the cURL example; the `api-{fqdn}` portion represents your tenant’s unique FQDN.
{% endstep %}

{% step %}

### API Key

From the same **API Keys** page, click **+ New Key**, choose **Standard** or **Advanced**, configure access roles (ensure **Public API** permissions are included), then click **Generate**.\
Copy the generated value immediately — this value is used in the `Authorization: {api_key}` header.
{% endstep %}

{% step %}

### API Key ID

In the **API Keys** table, locate the **ID** column corresponding to your generated key.\
This value is your API Key ID and is required in the header as `x-xdr-auth-id: {api_key_id}`.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Please perform a connection test to ensure there is a valid connection to the PaloAlto Xpanse 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/paloalto-xpanse.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.