# Adding Azure DevOps organization to Xopero ONE

#### Adding an Azure DevOps organization to Xopero ONE connects your environment to the platform, enabling secure backup of projects, repositories, and related data.

***

## Using OAuth

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

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F0iMDNKYM60w6WCcwxUjf%2Fimage.png?alt=media&#x26;token=c3b21703-e885-4c36-9597-35e5cab9efd6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Connect** button under **Azure DevOps**.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FSbrzoIO2T7wAoxRelSHY%2Fimage.png?alt=media&#x26;token=c6b1ed13-8749-4d82-9177-e16494306f16" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
[In the window that pops-up](#additional-browser-permissions), log in with a user account which has the required permissions for the repositories or projects to protect. If your **Azure** login session is active in a different tab, the login will complete automatically.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F2lsLYuriXXd2emTvfhf2%2Fimage.png?alt=media&#x26;token=efbc145b-f16d-49d9-a738-b48d39c3d495" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Check the **Consent on behalf of your organization** checkbox and click **Accept** to proceed.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FkiVhu3npQOcuPJx4DQgy%2Fimage.png?alt=media&#x26;token=b71f6f80-7065-4371-9d04-94a9b1152ff7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Your **Azure DevOps** 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.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F0Vp7D3jqUCfWs56uP693%2Fimage.png?alt=media&#x26;token=b5fc83c0-4b17-430e-b034-6bc21bcc48d9" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Using a Personal Access Token (PAT)

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

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FgPRvv1kzpmkZmBc742Im%2Fimage.png?alt=media&#x26;token=69d4d6c2-4f9a-44d6-9363-8394e39d009c" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **advanced mode** link under **Azure DevOps** and **Azure DevOps Server** tiles.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Ffl9dG2bpl4Il9XxPj1I5%2Fimage.png?alt=media&#x26;token=b4755bbb-c59a-47ff-9f5b-9e7adf1ff9b8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Set your authentication method.

1. In **Authentication**, select **Azure DevOps**.
2. For **Connect using**, choose **Username and Personal Access Token**.
3. Add or select **PAT** from the **Password Manager**.
4. Choose whether **Xopero** should automatically add new repositories to your backup.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FgCkpWyia60cWJvDgOdlH%2Fimage.png?alt=media&#x26;token=7c7b6301-04a7-489f-9e09-6620ec4eeccf" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure your repository sync and default worker. Specify hours for synchronization, or set a time interval for automatic updates.

{% hint style="warning" %}
Cloud workers cannot access local network storage. Choose a device with the necessary access if backing up locally.
{% endhint %}

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fxao0KkYPmITcz661POOw%2Fimage.png?alt=media&#x26;token=eb8b7bc6-b555-4db7-b22b-4c036a87d414" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Proceed** to complete adding your **Azure DevOps** organization and grant **Xopero ONE** access to the specified resources.
{% endstep %}

{% step %}
Your **Azure DevOps** 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.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FFlenYoisOK9a0af5A09W%2Fimage.png?alt=media&#x26;token=3e32f456-0751-43ba-88b2-af3313865ebd" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Additional browser permissions

When adding an organization, you may be prompted to grant additional permissions to the **Xopero ONE** application — make sure your browser allows **Xopero** to open pop-up windows.

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/92JwIolq3nNcqZWYoX80/1.PNG" alt=""><figcaption></figcaption></figure>

Depending on your browser, you can either adjust the settings to allow pop-ups or permit the authorization window to open once.

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/yMSRLkEP2cPAsr3MksgJ/Pop-ups%20xone.png" alt="Mozilla pop-up allowance"><figcaption></figcaption></figure>

[^1]: Xopero ONE Management Service
