> 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/github/integracja/wymagane-uprawnienia.md).

# Wymagane uprawnienia

## Konto

Aby zainstalować aplikację **Xopero ONE**, musisz użyć konta z **wystarczającymi uprawnieniami**, zazwyczaj **konta administratora**. Ponadto, aby aplikacja działała poprawnie, wymaga następujących uprawnień:

* [x] Pełna kontrola nad projektami.
* [x] Odczyt dyskusji zespołów.
* [x] Odczyt członkostwa w organizacji i zespołach, odczyt projektów organizacji.
* [x] Odczyt wszystkich danych profilu użytkownika.
* [x] Pełna kontrola nad prywatnymi repozytoriami.
* [x] Dostęp do adresów e-mail użytkowników (tylko do odczytu).
* [x] Aktualizacja **GitHub Action** workflows.

Te uprawnienia zapewniają bezproblemową integrację i prawidłowe działanie aplikacji w zamierzonym środowisku.

💡 Poniżej znajdziesz przykłady różnych typów uprawnień razem z ich objaśnieniem.

<details>

<summary>Uprawnienia</summary>

<table><thead><tr><th width="236">TYP</th><th width="132.4444580078125">Poziom</th><th>Objaśnienie</th></tr></thead><tbody><tr><td><strong>Owner</strong></td><td>default</td><td>Pełny backup i przywracanie.</td></tr><tr><td></td><td>admin</td><td>Pełny backup i przywracanie.</td></tr><tr><td></td><td>write</td><td>Pełny backup i przywracanie.</td></tr><tr><td></td><td>read</td><td>Pełny backup. Przywracanie tylko na konto prywatne.</td></tr><tr><td><strong>Member</strong></td><td>admin</td><td>Pełny backup. Przywracanie tylko na konto prywatne.</td></tr><tr><td></td><td>maintain</td><td>Pełny backup. Przywracanie tylko na konto prywatne.</td></tr><tr><td></td><td>write</td><td>Pełny backup. Przywracanie tylko na konto prywatne.</td></tr><tr><td></td><td>triage</td><td>Backup (z wyłączeniem współpracowników). Przywracanie tylko na konto prywatne.</td></tr><tr><td><strong>Collaborator</strong> (zewnętrzny, wewnątrz organizacji)</td><td>read</td><td>Backup (z wyłączeniem współpracowników). Przywracanie tylko na konto prywatne.</td></tr><tr><td><strong>Collaborator</strong> (poza organizacją)</td><td>default</td><td>Backup (z wyłączeniem współpracowników). Przywracanie tylko na konto prywatne.</td></tr></tbody></table>

</details>

***

## Osobisty Token Dostępu (PAT)

Minimalne uprawnienia autoryzacyjne wymagane dla tokenu do zarejestrowania aplikacji **Xopero ONE** oraz wykonywania backupu i przywracania repozytorium to: `repo` i `workflow`.

<figure><img src="/files/rSV5xLCHQP9U38dNvGj3" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Przy minimalnych uprawnieniach niektóre metadane mogą nie zostać uwzględnione w procesie backupu. Wybierz niezbędne uprawnienia w oparciu o konkretne dane, które chcesz chronić.
{% endhint %}

Możesz wygenerować [**osobisty token dostępu** ](#user-content-fn-1)[^1]w sekcji **Developer settings** > **Personal access tokens** na Twoim koncie **GitHub**. Podczas tworzenia **PAT** możesz przypisać różne typy uprawnień — poniższa lista wyszczególnia uprawnienia wymagane do backupu określonych **metadanych** repozytorium w Twojej organizacji:

1. `admin:org` — pozwala na odczyt projektów organizacji.
2. `project` — pozwala na odczyt projektów, z których pochodzi repozytorium.
3. `read:discussion` — pozwala na odczyt dyskusji zespołów.
4. `read:public_key` — udziela dostępu do kluczy.
5. `read:repo_hook` — udziela dostępu do webhooków.
6. `repo` — udziela dostępu do repozytoriów.

{% hint style="info" %}
Dowiedz się więcej o tokenach dostępu użytkowników w [oficjalnej dokumentacji GitHub](https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app).
{% endhint %}

{% hint style="warning" %}
Jeśli nadasz tylko uprawnienia [**do odczytu**](#user-content-fn-2)[^2], będziesz mógł wykonać backup, ale przywracanie danych będzie wymagało wygenerowania nowego tokena z uprawnieniami [**do zapisu**](#user-content-fn-3)[^3].
{% endhint %}

[^1]: PAT

[^2]: read

[^3]: write