# Xray

<div align="left"><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2FBd1vgAxaO6PEXNuE9HJO%2Fxray.png?alt=media&#x26;token=6a24d6eb-6158-4bbd-b49e-95ab070efd65" alt=""></div>

## Set up

### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

### **Connect Xray**

* Find the **Xray** integration module under the **Regression testing** section
* Click the **Connect** button
* Enter your **Client ID** and **Client Secret**
  * Every Xray API Key you generate will have a Client ID and Client Secret associated and displayed alongside. You can generate API Keys for Xray within Jira by going to **Settings > Apps > Xray > API Keys** (:link: [Xray Documentation - Global Settings: API Keys](https://docs.getxray.app/space/XRAYCLOUD/44568019/Global+Settings+-+API+Keys))

{% hint style="info" %}
When connected, Xray API actions will be performed on behalf of the user linked to the Xray API key being used.
{% endhint %}

* Click **Save**; you’ll be presented with a dialog in which to add any test execution naming keywords

{% hint style="warning" %}
For linking test executions to specific releases, Runway will parse your test execution names for the presence of a version string (e.g. “**2.3.0**”)
{% endhint %}

{% hint style="info" %}
You can optionally add test execution naming keywords (case insensitive) to associate test executions with a particular app, e.g. "iOS" or "Android"
{% endhint %}