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

# 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