# Adding Jira organization to GitProtect

#### Adding Jira organization to GitProtect 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 — **GitProtect does not support scoped tokens**.
{% endhint %}

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

{% stepper %}
{% step %}
Log in to **GitProtect Management Service**, open the **DevOps** tab on the left side of the window, and select **Jira** from the list.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FQwui2htsUERq7A99H0k1%2Fimage.png?alt=media&#x26;token=af83c915-11ec-43fc-956d-4f2c807cd721" 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://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FdcKjqEKM3zxebPKhCIYK%2Fimage.png?alt=media&#x26;token=c052c639-09c1-4417-a7a5-40c824745664" 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" %}
**GitProtect** 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.gitprotect.io/backup-and-recovery/jira/integration/custom-domains).
{% endhint %}

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Ff04UHkLRmTCn80vLzJhC%2Fimage.png?alt=media&#x26;token=ad10efdc-d9fd-4991-a122-878155184d9c" 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://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FYqEyeOb33B1O5yydQmBq%2Fimage.png?alt=media&#x26;token=53abd3da-a53b-487c-8f39-43cb6666d578" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Your **Jira** organization has now been successfully added to **GitProtect** — 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 **GitProtect**.
{% endhint %}

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2F5x2s4l69h8vNPiSljfod%2Fimage.png?alt=media&#x26;token=9744652c-0aeb-4b11-8a79-c5d7fba0611f" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Useful links and items

{% content-ref url="required-permissions" %}
[required-permissions](https://helpcenter.gitprotect.io/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/>" %}