# Wymagane uprawnienia

## Konto <a href="#account" id="account"></a>

Przy logowaniu na konto **Bitbucket**, aplikacja prosi o następujące uprawnienia:

* [x] **Account Information** (odczyt i modyfikacja osobistych szczegółów konta).
* [x] **Administer Repositories** (pełna kontrola administracyjna nad repozytoriami).
* [x] **Authorize workspace** (przyznaje dostęp do obszaru roboczego w celu uwierzytelnienia).
* [x] **Delete Repositories** (trwałe usuwanie repozytoriów).
* [x] **Issues** (odczyt i aktualizacja Issues w repozytoriach).
* [x] **Manage runners** (dostęp i edycja Runnerów obszaru roboczego/repozytorium).
* [x] **Pipelines** (dostęp do kompilacji Pipelines i konfiguracja ich zmiennych).
* [x] **Project Settings** (odczyt i aktualizacja ustawień Projektu obszaru roboczego, w tym przenoszenia repozytoriów).
* [x] **Repositories & Pull Requests** (odczyt, aktualizacja i zarządzanie repozytoriami i Pull Requests).
* [x] **Snippets** (odczyt i modyfikacja Snippets).
* [x] **Team Membership** (odczyt i aktualizacja szczegółów członkostwa w Zespole).
* [x] **Webhooks** (odczyt i aktualizacja Webhooks repozytorium).
* [x] **Wikis** (odczyt i aktualizacja Wiki repozytoriów).

***

## Token i hasło <a href="#tokenpassword" id="tokenpassword"></a>

Poniższe uprawnienia są minimalnie wymagane do zarejestrowania aplikacji **Xopero ONE** na koncie **Bitbucket** i uzyskania dostępu do repozytoriów:

* [x] **Account** — <mark style="color:$success;">**read**</mark>
* [x] **Repositories** — <mark style="color:$success;">**read**</mark> oraz <mark style="color:$success;">**admin**</mark>

Możesz wygenerować hasło aplikacji, przechodząc do karty **App passwords** w ustawieniach konta **Bitbucket**.

{% hint style="danger" %}
Przy minimalnych uprawnieniach niektóre metadane (np. issues) mogą nie zostać uwzględnione w backupie. Wybierz niezbędne uprawnienia w oparciu o dane, które chcesz chronić — pamiętaj, że jeśli nadasz tylko uprawnienia do odczytu, backupy będą działać, ale przywracanie danych będzie wymagało wygenerowania nowego tokenu lub hasła z uprawnieniami do **zapisu**.
{% endhint %}

***

## Hasło aplikacji

Hasła aplikacji można skonfigurować z określonymi poziomami uprawnień. Poniższa lista zawiera szczegółowe informacje na temat uprawnień wymaganych do backupu metadanych repozytorium w Twojej organizacji:

* [x] **Account** — uprawnienie <mark style="color:$success;">**read**</mark> wymagane do przypisania organizacji do **Xopero ONE**.
* [x] **Issues** — uprawnienie <mark style="color:$success;">**read**</mark> wymagane do backupu Issues w repozytorium.
* [x] **Pipelines** — uprawnienie <mark style="color:$success;">**read**</mark> wymagane do backupu Pipelines, harmonogramów Pipelines, znanych hostów i ustawień Pipelines.
* [x] **Projects** — uprawnienie <mark style="color:$success;">**read**</mark> wymagane do zapisania informacji o tym, do którego Projectu należy repozytorium.
* [x] **Pull Requests** — uprawnienie <mark style="color:$success;">**read**</mark> wymagane do backupu Pull Requests w repozytorium.
* [x] **Repositories** — uprawnienia <mark style="color:$success;">**read**</mark> oraz <mark style="color:$success;">**admin**</mark> wymagane do uzyskania dostępu do repozytoriów i wykonania backupu.
* [x] **Wikis** — uprawnienie <mark style="color:$success;">**read**</mark> wymagane do backupu Wiki repozytorium.

{% hint style="danger" %}
Nadanie jedynie uprawnień do odczytu umożliwia wykonywanie backupów; jednak przywracanie danych będzie wymagało wygenerowania nowego hasła aplikacji z uprawnieniami do zapisu.
{% endhint %}

***

## Przydatne linki i materiały

{% embed url="<https://support.atlassian.com/bitbucket-cloud/docs/api-tokens>" %}