# Adding Jira organization to Xopero ONE

#### Adding Jira organization to Xopero ONE connects your environment to the platform so you can start protecting its data.

***

## Using an API token

{% hint style="danger" %}
For **Jira**, use the classic token — **Xopero ONE does not support scoped tokens**.
{% endhint %}

{% hint style="warning" %}
Before adding your **Jira** organization to **Xopero ONE**, [check if your account has the required permissions](https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/jira/integration/required-permissions) for all spaces (projects) you want to protect.
{% endhint %}

{% stepper %}
{% step %}
Log in to [**XMS**](#user-content-fn-1)[^1], open the **DevOps** tab on the left side of the window, and select **Jira** from the list.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FVqElbeqVxOwGMtiOnWH5%2Fimage.png?alt=media&#x26;token=d960e853-4c5f-45d8-a2ad-1af0632ef239" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Connect** button under **Jira Software** or **Jira Service Management** (depending on your needs).

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FsLcKSaXlpuBay1KmuSoi%2Fimage.png?alt=media&#x26;token=a22adba0-ee33-45b5-b1a5-35d8e084015b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter your **instance URL** (for example, <kbd><https://mycompanyjira.atlassian.net></kbd>) and your **Jira** login, then add or select an [API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token) from the **Password Manager**.

{% hint style="success" %}
**Xopero ONE** can secure organizations that have a custom domain added, but you must add the instance using its original URL, which you can find in <https://admin.atlassian.com> > **App URLs** > **Custom domains** > **Actions** > **Show details**. Learn more about custom domains in [this article](https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/jira/integration/custom-domains).
{% endhint %}

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FgumJUtlJGoqYuqLuAe8T%2Fimage.png?alt=media&#x26;token=32de81c4-800f-46a5-b6b1-5bb235e0f951" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure your spaces sync and default worker — specify hours for synchronization, or set a time interval for automatic updates. Once done, click **Proceed**.

{% hint style="warning" %}
The account used for the authorization process must have **at least site admin permissions**.
{% endhint %}

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FYhdrzVlMEFPemLvX3LDb%2Fimage.png?alt=media&#x26;token=2b7b29fa-3745-4668-897e-22c03603a450" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Your **Jira** organization has now been successfully added to **Xopero ONE** — click **Custom policy** to adjust your backup policy settings, or click **Run backup** to execute the backup immediately using the current policy configuration.

{% hint style="info" %}
Granular backup is the default policy configuration applied to any new **Jira** organization you add to **Xopero ONE**.
{% endhint %}

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fi6Gq7xawYue3RKZuITIj%2Fimage.png?alt=media&#x26;token=700667df-6d6d-4a76-8530-370ad4cbea58" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Useful links and items

{% content-ref url="required-permissions" %}
[required-permissions](https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/jira/integration/required-permissions)
{% endcontent-ref %}

{% embed url="<https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/>" %}

[^1]: Xopero ONE Management Service