# Additional Bitbucket credentials

## Bitbucket account preparation

**GitProtect** allows authentication with multiple organization accounts during repository backups. This helps distributing the limits of sent requests (imposed by the service provider) across more accounts, which speeds up the backup process and prevents throttling.

{% hint style="danger" %}
Additional accounts require an app password for authentication.
{% endhint %}

To add additional accounts for authentication to your **Bitbucket** organization, log in to your **Bitbucket** account and add a member to your workspace. The user should belong to a group with an **Admin** role for repositories, and also have the **Administer workspace (Can administer all workspace and repository settings)** option selected.

{% hint style="danger" %}
It is necessary to enable **Bitbucket** development mode—this type of app requires development mode to be turned on in the **Bitbucket** settings.
{% endhint %}

💡 Learn more about workspace access in the [official **Bitbucket** documentation](https://support.atlassian.com/bitbucket-cloud/docs/grant-access-to-a-workspace).

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FwOKVJMwuKDkTJmPhBF9z%2Fprepare.png?alt=media&#x26;token=8ff85956-cf51-4c85-b04d-6037d14fa0b5" alt=""><figcaption></figcaption></figure>

***

## App password location and required permissions <a href="#where_to_get_the_app_password_for_authentication" id="where_to_get_the_app_password_for_authentication"></a>

You can generate multiple app passwords in the **App passwords** tab of your **Bitbucket** account.\
The minimum permissions required to authorize the **GitProtect** application to perform a repository backup are:

* [x] Account: **Read**
* [x] Repositories: **Read** and **Admin**

{% hint style="warning" %}
If you want the backup to include repository metadata as well, you need to grant additional permissions.
{% endhint %}

***

## Adding Bitbucket credentials to GitProtect

{% hint style="danger" %}
Adding additional credentials in **GitProtect** does not automatically integrate them into backup tasks—you **must** enable new credentials for use in a backup plan.
{% endhint %}

{% stepper %}
{% step %}
Login to **GitProtect Management Service** and open the **Bitbucket** tab (**DevOps** > **Bitbucket**). Find your **Bitbucket** repository and click **Edit** in the bottom-left corner of the selected tile.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fgit-blob-1980e9eed705ae93d8b00dff8a689be3bcc92f90%2Fimage%20(996).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Go to the **Additional credentials** section and click it.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fgit-blob-d8cb820917718eb1fb22226443c62f7209959292%2Fimage%20(995).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Add new** button, enter the credentials, and then click **Save** to finish.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fgit-blob-2fa158173173e75125ccb1b07fd7a4c9ff44efff%2Fimage%20(997).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Enabling Bitbucket credentials for backup

{% stepper %}
{% step %}
In **GitProtect Management Service**, open the **Plans** tab and click **Add plan**, or select **Edit plan** if you already have one.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fgit-blob-d9ad38c9fec2bcb7fa0c06bf9ee3de15c4e9332b%2Fimage%20(1012).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Scroll down to **Advanced settings**, click **Edit**, and enable the **Additional git credentials** switch.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fgit-blob-85e703d2d3dc9173663960f0947193e6018a3e94%2Fimage%20(1013).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
The system will display all additional accounts available for the selected organization. Toggle the switch **ON** next to the accounts you want to use, and then click the **Save** button.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fgit-blob-92263e39da78188bdda54a9c4c710f7a7d52f700%2Fimage%20(1003).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Back in the **Edit backup plan** panel, click the **Save** button to save your backup plan settings. The backup plan will now run using the selected additional **Bitbucket** accounts.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fgit-blob-ce109d9dbd0b738685cf44defc3b2498a4e7ea47%2Fimage%20(1014).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}
