# Authenticating Xray

To authenticate Xray in Avo Assure, perform the following actions:

1. On the **Home page**, under **Projects**, select the required Project.
2. From **Settings** tile, select **Manage Integrations**.&#x20;

<figure><img src="/files/3jprJ9mGmSCvBuFtj59y" alt=""><figcaption></figcaption></figure>

3. Select **Test Management** tab, and then select **Xray** option.

<figure><img src="/files/qXosQ2ZAQt2GAcOz6nqL" alt=""><figcaption></figcaption></figure>

4. Enter the required details in the following fields:
   * **Username**: Enter the username.
   * **API Token**: Enter the API token.
   * **URL**: Enter the Atlassian URL.
   * **Client ID**: Enter the client ID.
   * **Client Secret**: Enter the encrypted client secret.

{% hint style="info" %}
**Information**: The **Client ID** and **Client Secret** are credentials used to access Xray data through APIs. The Client Secret is encrypted for security. Together, these credentials are required to generate authentication tokens, which are then used to validate requests for retrieving or updating data in Xray.
{% endhint %}

5. Select **Remember Credentials** checkbox to store the credentials.
6. Select the **Login** button to complete the authentication.

{% hint style="info" %}
**Note:** Select the **Reset** button to clear all input values.
{% endhint %}

<figure><img src="/files/3Af9TcslDXZKcKXYNajg" alt=""><figcaption></figcaption></figure>


---

# 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.avoautomation.com/avo-assure/integrations-in-avo-assure/test-management/xray/authenticating-xray.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.
