# Adding Azure DevOps organization to GitProtect

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

***

## Using OAuth

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2F3ibFN2tDICNz4UnwvXdk%2Fimage.png?alt=media&#x26;token=506e7435-8a52-478f-8cb9-07af35bd348b" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FQ69Vu7QK7MkHdIA2gQBD%2Fimage.png?alt=media&#x26;token=de388e87-3921-42ae-8bb8-fca35ed7ea90" 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://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fx73jgqKwDXunTMbrjRcN%2Fimage.png?alt=media&#x26;token=6da761d9-d37b-4203-8c77-de603f150b47" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FKFpcdhZXknp6sITo62er%2Fimage.png?alt=media&#x26;token=e93cea97-a09b-4da4-afc0-ff8e13a84b96" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FtAOWgL8JAeJF2Uiw7fCq%2Fimage.png?alt=media&#x26;token=c5ec4585-359b-4098-9195-97cadc68e76c" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Using a Personal Access Token (PAT)

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FvujqA8A8N5Sww986ZdWl%2Fimage.png?alt=media&#x26;token=e126c808-8be7-42a1-bb42-2e68e25879be" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fc1J45JwaPGctgcQh4PwZ%2Fimage.png?alt=media&#x26;token=305c789c-3c1d-430c-a95c-91d7aa687e64" 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 **GitProtect** should automatically add new repositories to your backup.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FVTq2zbAnTNMj1x3AsDz8%2Fimage.png?alt=media&#x26;token=be9008e3-2d9b-4044-b5f9-32b595a003ca" 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://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2F2j2SyHYY3cJjLhT2TARM%2Fimage.png?alt=media&#x26;token=b93551ea-e679-4fc3-8952-d19e1edce307" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FILSvKCcZWcw0Qk8t37gb%2Fimage.png?alt=media&#x26;token=73adc1a1-ca61-4794-b27f-126d3c281643" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Additional browser permissions

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FDgsE0uZB9afeCXywt8B1%2F1.PNG?alt=media&#x26;token=99e80efd-a57c-4578-8fcf-f7a4e2994937" 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.