> 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

Niniejszy artykuł wyjaśnia, jak przygotować i dodać dodatkowe poświadczenia GitHub i GitHub Enterprise w celu zapobiegania ograniczeniom żądań.

## 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/w890ev4aJohRIjNySXI2/beta.PNG" 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="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FcLZDc4HCJP1gEgdoce0E%2Fimage.png?alt=media&amp;token=8ce2ac70-aea0-43bf-a9b3-d52292e94b3c" alt="" width="335"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FYAouduhX66GwL7DHVoSp%2Fimage.png?alt=media&amp;token=d4a84a3a-3964-4000-94a9-9faa2f355b22" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FmfdBoYNIMoDeipN3sC91%2Fimage.png?alt=media&amp;token=2fafcdfb-9d7c-4a14-9be8-5f2bff2b09d3" 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="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FHRngGw6Ory9xEvL2UY8a%2Fimage.png?alt=media&amp;token=d3083249-61b1-4ba9-abce-c09878ac10bc" 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="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FNAKQogmTEx3UQoOjREfK%2Fimage.png?alt=media&amp;token=1cec1524-e508-4572-871f-cbded4335d7b" 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="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FXBzR5TR0Gm0MHweGrRPL%2Fimage.png?alt=media&amp;token=86542671-b9c8-4c53-9955-75e0276500dc" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2Fz3ldNMKaRcs4T5StHXIZ%2Fimage.png?alt=media&amp;token=10c047fc-de5a-44f3-8ea9-0616dfe74b4c" 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="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FA2C1UWY28IjmVeBl0OyP%2Fimage.png?alt=media&amp;token=d397b833-aa31-4e18-b64f-d767b07974df" 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