> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/pl/kopia-zapasowa-i-przywracanie/devops/gitlab/integracja/wymagane-uprawnienia.md).

# Wymagane uprawnienia

## Konto

Aby zalogować się na Twoje konto, **Xopero ONE** wymaga następujących uprawnień:

1. **Dostęp do API uwierzytelnionego użytkownika** — **Xopero** potrzebuje dostępu do **odczytu i zapisu** do **API**, w tym:
   1. Wszystkich grup i projektów.
   2. Rejestru kontenerów (Container Registry).
   3. Rejestru pakietów (Package Registry).

***

## Osobisty token dostępu (PAT)

{% hint style="info" %}
**GitLab** można zintegrować z **Xopero ONE** przy użyciu osobistego tokena dostępu (PAT) przypisanego nie tylko do zwykłego konta użytkownika **GitLab**, ale również do konta serwisowego będącego członkiem danego projektu. Wymagania dotyczące uprawnień są takie same jak w przypadku zwykłego konta użytkownika, jednak konto serwisowe **musi dodatkowo posiadać przynajmniej rolę maintainer**.
{% endhint %}

{% hint style="warning" %}
**Xopero ONE** obsługuje tokeny starszego typu (legacy tokens); dla prawidłowego działania systemu zaleca się ich używanie zamiast tokenów o szczegółowych uprawnieniach (fine-grained tokens).
{% endhint %}

Minimalne uprawnienia wymagane do zarejestrowania aplikacji **Xopero ONE** na Twoim koncie i uzyskania dostępu do repozytoriów:

* [x] **read\_api**
* [x] **read\_repository**

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

Tworząc **Osobisty token dostępu (PAT)**, możesz przypisać różne typy uprawnień. Poniższe uprawnienia pozwalają na backup metadanych repozytorium w Twojej organizacji:

* [x] **read\_api** - Uprawnienie do odczytu, wymagane do przypisania organizacji do GitLab.
* [x] **api** - Udziela pełnego dostępu do odczytu/zapisu do API, w tym wszystkich grup i projektów.
* [x] **read\_repository** - Wymagane do uzyskania dostępu do listy repozytoriów i wykonywania backupów.
* [x] **write\_repository** - Wymagane do przywracania repozytorium.
* [x] **read\_registry** - Udziela dostępu do odczytu obrazów **Rejestru Kontenerów (Container Registry)**, gdy projekt jest prywatny i wymagana jest autoryzacja.

{% hint style="info" %}
Aby uzyskać więcej informacji na temat osobistych tokenów dostępu, odwiedź [oficjalną stronę GitLab](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html).
{% endhint %}