# 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/6M4ZuvenH9LzOCzAGR5o/PAT%20permissions.png" 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.xopero.com/xopero-one-en/pl/kopia-zapasowa-i-przywracanie/devops/github/integracja/wymagane-uprawnienia.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.