# Dodatkowe poświadczenia GitHub

## Przygotowanie konta  GitHub <a href="#preparing_an_additional_account" id="preparing_an_additional_account"></a>

Możesz dodać dowolną osobę do swojej organizacji GitHub (lub GitHub Enterprise), a stanie się ona jej członkiem. Aby to zrobić, postępuj zgodnie z instrukcjami na [oficjalnej stronie GitHub](https://docs.github.com/en/enterprise-server@3.4/organizations/managing-membership-in-your-organization/adding-people-to-your-organization).

***

## Przygotowanie [osobistego tokenu dostępu](#user-content-fn-1)[^1] <a href="#preparing_personal_access_token" id="preparing_personal_access_token"></a>

#### Aby utworzyć osobisty token dostępu (PAT) w **GitHub**:

1. Kliknij swoje **zdjęcie profilowe** w prawym górnym rogu dowolnej strony i wybierz **Settings**.
2. W lewym pasku bocznym kliknij **Developer settings**.
3. Wybierz **Personal access tokens**.
4. Kliknij **Generate new token**.
5. Wprowadź opisową nazwę dla tokenu.

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

{% hint style="danger" %}
Musisz używać tokenów (**klasycznych**) — **Xopero ONE nie obsługuje** tokenów o precyzyjnej kontroli (**fine**-**grained tokens**).
{% endhint %}

{% hint style="warning" %}
Należy pamiętać, że wersja beta mogła ulec zmianie. Po pełnym wydaniu nasi administratorzy będą potrzebować czasu na przeanalizowanie możliwości obsługi tego typu tokenów.
{% endhint %}

{% hint style="info" %}
Więcej szczegółów na temat tworzenia osobistego tokenu dostępu można znaleźć w [oficjalnej dokumentacji GitHub](https://docs.github.com/en/enterprise-server@3.4/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).
{% endhint %}

***

## Dodawanie poświadczeń GitHub do Xopero ONE

{% hint style="danger" %}
Dodanie nowych poświadczeń do **Xopero ONE** nie integruje ich automatycznie z zadaniami backupu — <mark style="color:$danger;">**musisz**</mark> zatwierdzić korzystanie z tych poświadczeń w planie backupu.
{% endhint %}

{% stepper %}
{% step %}
Zaloguj się do [**XMS**](#user-content-fn-2)[^2], otwórz zakładkę **GitHub** i kliknij **Edytuj** w lewym dolnym rogu kafelka organizacji **GitHub**.

<figure><img src="/files/c2FEM3ACeSFEvAMi2eHX" alt="" width="335"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Przejdź do sekcji **Zapobieganie ograniczeniom żądań** i kliknij **Zarządzaj kontami**.

<figure><img src="/files/WJBVyItD38bUb2gcVRLc" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Kliknij przycisk **Dodaj** i wybierz jedną z dostępnych opcji:

<figure><img src="/files/qw6GZpXwFYyrXULjoPbv" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Dla tokena dostępu (Access Token):

Wprowadź nazwę użytkownika konta i dodaj lub wybierz **PAT** z **Managera haseł**, a następnie potwierdź wybór. Możesz dodać dowolną liczbę kont do swojej organizacji.

{% hint style="warning" %}
Korzystamy ze szczegółowo określonego użytkownika i jego limitów, dlatego zalecany jest dedykowany użytkownik do backupu. Zapobiega to sytuacjom, w których faktyczni użytkownicy mogą przekroczyć swoje limity **API**.
{% endhint %}

{% hint style="info" %}
Aby dowiedzieć się jak dodać **PAT** do **Managera haseł,** zobacz [ten artykuł](/xopero-one-en/pl/zarzadzanie/manager-hasel.md).
{% endhint %}

<figure><img src="/files/3r5Z2K159LpYvaIjbnPw" alt="" width="368"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Dla aplikacji GitHub (GitHub App):

Z listy rozwijanej wybierz aplikację (#1–#10) i zainstaluj ją w odpowiedniej organizacji. Proces jest taki sam, jak podczas dodawania głównej aplikacji **GitHub**.

{% hint style="info" %}
Konto jest używane wyłącznie do instalacji aplikacji. Po jej zakończeniu konto nie jest już wykorzystywane do żadnych operacji, ponieważ wszystkie kolejne działania są wykonywane przez zainstalowaną aplikację.
{% endhint %}

<mark style="color:$danger;">**IMPORTANT!**</mark> Możesz dodać dodatkową **aplikację** **GitHub** <mark style="color:$danger;">tylko</mark> gdy spełnione są poniższe warunki:

1. Konto instalujące ma wystarczające uprawnienia w **GitHub**— instalacja <mark style="color:$danger;">nie może</mark> wymagać wysłania i zatwierdzenia żądania instalacji (może się tak zdarzyć, na przykład, gdy konto nie ma uprawnień administratora repozytorium lub ma inną rolę niż **Właściciel** (**Owner**) w organizacji).\
   Aby dowiedzieć się więcej, zobacz artykuł [Instalowanie aplikacji GitHub od osób trzecich– GitHub Docs](https://docs.github.com/en/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)**\***.
2. Organizacja w systemie **Xopero** posiada główne poświadczenia dla konta **GitHub**, na którym instalowana jest dodatkowa **Aplikacja GitHub\*\***:
   1. Jeśli organizacja została zarejestrowana za pomocą **Aplikacji GitHub**, dodatkowe **Aplikacje GitHub** można dodać tylko dla kont, które mają już zarejestrowaną główną **Aplikację GitHub**. Dodatkowe **Aplikacje** **GitHub** dla innych kont osobistych nie są dozwolone.
   2. Jeśli organizacja została zarejestrowana za pomocą **OAuth** lub **PAT**, dodatkową **Aplikację GitHub** można dodać dla dowolnego konta, w tym innych kont osobistych

{% hint style="danger" %}
\*Jeśli warunek 1 nie zostanie spełniony, komunikat o błędzie wskaże, że nie masz wymaganych uprawnień do ukończenia instalacji.
{% endhint %}

{% hint style="danger" %}
\*\*Jeśli warunek 2 nie zostanie spełniony, komunikat o błędzie wyświetli monit o wcześniejsze zarejestrowanie konta w organizacji w systemie.
{% endhint %}

<figure><img src="/files/KK7oyJWOhWKjTyMStIyG" alt="" width="360"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Włączanie poświadczeń GitHub dla backupu

{% stepper %}
{% step %}
W [**XMS**](#user-content-fn-2)[^2], otwórz kartę plany i kliknij **Dodaj plan**, albo wybierz opcję **Edytuj plan** jeśli już go posiadasz.

<figure><img src="/files/MZClCLLdUASWhMRixMWh" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Przewiń do sekcji **Ustawienia zaawansowane**, kliknij **Edytuj**, i włącz przełącznik **Dodatkowe konta Git**.

<figure><img src="/files/0xIX7vzTUIgpezhQBsmA" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
System wyświetli wszystkie dodatkowe konta dostępne dla wybranej organizacji. Przełącz przełącznik na **WŁ**. (**ON**) obok kont, których chcesz użyć, a następnie kliknij przycisk **Zapisz**.

<figure><img src="/files/lovu1WwYWrbLsDZMEUjP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Wróć do panelu **Edycji planu backupu**, kliknij przycisk **Zapisz**, aby zapisać ustawienia planu backupu. Plan backupu będzie teraz działał, używając wybranych dodatkowych kont **GitHub** (lub **GitHub Enterprise**).
{% endstep %}
{% endstepper %}

[^1]: personal access token

[^2]: Xopero ONE Management Service


---

# 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/zarzadzanie-ryzykiem-i-zgodnoscia/zapobieganie-ograniczeniom-zadan/dodatkowe-poswiadczenia-github.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.