> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsiam/onboard-cortex-xsiam/pair-cortex-aes-for-existing-cortex-xsiam-customers.md).

# Pair Cortex AES for existing Cortex XSIAM customers

Pair your Cortex AES tenant with an existing Cortex XSIAM tenant to manage Agentic Endpoint Security from Cortex XSIAM.

If you already have a Cortex XSIAM tenant with a Cortex XDR license and purchase the standalone AES license, you receive a separate Cortex AES tenant. To manage the Agentic Endpoint Security module from your Cortex XSIAM tenant, pair the Cortex AES tenant with your Cortex XSIAM tenant. After pairing, the Agentic Endpoint Security module from your Cortex AES tenant appears in your Cortex XSIAM tenant. To run AES on an existing agent, set **AES run-mode** to **Enabled** in the agent's Agent Settings profile.

### Prerequisites

Before you pair the tenants, make sure that:

* The Cortex XSIAM tenant includes a Cortex XDR license.
* The Cortex XSIAM tenant and the Cortex AES tenant are in the same Customer Support Portal account.
* The Cortex XSIAM tenant and the Cortex AES tenant are in the same region.
* The Cortex XSIAM tenant isn't paired with another Cortex AES tenant.
* You're an Instance Administrator on both tenants.

{% hint style="warning" %}

#### Important

Pair before you set up the Cortex AES tenant. You can pair a Cortex AES tenant only once. Pairing doesn't transfer configuration or data from the Cortex AES tenant, and agents that you install from the Cortex AES tenant stop running AES after you pair.
{% endhint %}

### Pair the tenants

1. Sign in to your Cortex AES tenant, and select **Settings** → **Configurations** → **General** → **Server Settings**.
2. In the **AES Module Pairing** section, select your Cortex XSIAM tenant from **Paired tenant selector**, and click **Pair tenant**.

   Each tenant in the list shows its tenant type, tenant ID, and tenant URL. You can't select tenants in a different region from your Cortex AES tenant.
3. Review the tenant type, URL, ID, and region of your Cortex XSIAM tenant, and click **Confirm pairing**.

   A message confirms that the pairing request was sent. If your Cortex XSIAM tenant is already paired with another Cortex AES tenant, an error message appears. Select a different tenant or contact support.

Pairing can take up to 1 hour. While pairing is in progress, the **Agentic Endpoint Security** page in your Cortex XSIAM tenant shows that your environment is being prepared. When pairing is complete, refresh the page to see the Agentic Endpoint Security module. If the page still shows that your environment is being prepared after 1 hour, contact support.

{% hint style="info" %}
After pairing, the Agentic Endpoint Security module remains in your Cortex AES tenant and shows that pairing is in progress. This is a known issue. Manage Agentic Endpoint Security from your Cortex XSIAM tenant.
{% endhint %}

After pairing is complete, set **AES run-mode** to **Enabled** in the agent's Agent Settings profile to run AES on your existing agents. For more information, see [Set up agent settings profiles](https://cortex-docs.paloaltonetworks.com/cortex-xsiam/protect-your-endpoints/endpoint-security/install-and-manage-endpoints/set-up-endpoint-protection/set-up-endpoint-profiles-and-exception-rules/set-up-agent-settings-profiles.md).

Agents that you installed from the Cortex AES tenant before pairing no longer run AES, but they still appear in the Cortex AES tenant. Uninstall these agents from your endpoints.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xsiam/onboard-cortex-xsiam/pair-cortex-aes-for-existing-cortex-xsiam-customers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
