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

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.

---

Przygotowanie osobistego tokenu dostępu

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.

Musisz używać tokenów (klasycznych) — Xopero ONE nie obsługuje tokenów o precyzyjnej kontroli (fine-grained tokens). Może się to zmienić, gdy tokeny te wyjdą z wersji beta.

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.

Więcej szczegółów na temat tworzenia osobistego tokenu dostępu można znaleźć w oficjalnej dokumentacji GitHub.

---

Dodawanie poświadczeń GitHub do Xopero ONE

Dodanie nowych poświadczeń do Xopero ONE nie integruje ich automatycznie z zadaniami backupu — musisz zatwierdzić korzystanie z tych poświadczeń w planie backupu.

1

Zaloguj się do XMS, otwórz zakładkę GitHub i kliknij Edytuj w lewym dolnym rogu kafelka organizacji GitHub.

2

Przejdź do sekcji Zapobieganie ograniczeniom żądań i kliknij Zarządzaj kontami.

3

Kliknij przycisk Dodaj i wybierz jedną z dostępnych opcji:

4

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.

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.

Aby dowiedzieć się jak dodać PAT do Managera haseł, zobacz ten artykuł.

5

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.

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ę.

IMPORTANT! Możesz dodać dodatkową aplikację GitHub tylko gdy spełnione są poniższe warunki:

1. Konto instalujące ma wystarczające uprawnienia w GitHub— instalacja nie może 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*.

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

*Jeśli warunek 1 nie zostanie spełniony, komunikat o błędzie wskaże, że nie masz wymaganych uprawnień do ukończenia instalacji.

**Jeśli warunek 2 nie zostanie spełniony, komunikat o błędzie wyświetli monit o wcześniejsze zarejestrowanie konta w organizacji w systemie.

---

Włączanie poświadczeń GitHub dla backupu

1

W XMS, otwórz kartę plany i kliknij Dodaj plan, albo wybierz opcję Edytuj plan jeśli już go posiadasz.

2

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

3

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.

4

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).