Używając OAuth

Podczas dodawania organizacji może zostać wyświetlony monit o nadanie aplikacji Xopero ONE dodatkowych uprawnień — upewnij się, że Twoja przeglądarka zezwala Xopero na otwieranie wyskakujących okien (pop-up windows).

W zależności od przeglądarki możesz dostosować ustawienia tak, aby zezwalały na wyskakujące okna, lub zezwolić na jednokrotne otwarcie okna autoryzacji.

GitHub można zintegrować z Xopero ONE za pomocą kilku metod autoryzacji, w tym poprzez GitHub App, co zapewnia bezpieczny i skalowalny sposób łączenia organizacji GitHub na potrzeby operacji backupu i odzyskiwania danych. Dzięki granularnym uprawnieniom, dostępowi na poziomie repozytoriów oraz krótkoterminowym tokenom uwierzytelniającym, GitHub Apps pomagają chronić repozytoria i powiązane metadane, jednocześnie wspierając zautomatyzowane procesy tworzenia kopii zapasowych, synchronizację repozytoriów oraz usprawnione zarządzanie w środowisku Xopero ONE.

Informacje ogólne

GitHub App to typ integracji, który można zbudować w celu interakcji z GitHubem oraz rozszerzania jego funkcjonalności. GitHub App zapewnia elastyczność i uproszczenie procesów, bez konieczności logowania się użytkowników ani tworzenia konta serwisowego.

Podobnie jak aplikacje OAuth, GitHub Apps wykorzystują OAuth 2.0 i mogą działać w imieniu użytkownika. W przeciwieństwie do aplikacji OAuth, mogą również działać niezależnie od użytkownika.

Zalety korzystania z GitHub App

Kluczowe zalety korzystania z GitHub App do integracji z Xopero ONE obejmują zwiększone bezpieczeństwo, lepsze zarządzanie limitami zapytań (rate limits) oraz bardziej niezawodne zarządzanie repozytoriami.

Bezpieczeństwo

GitHub Apps zapewniają większą kontrolę i wyższy poziom bezpieczeństwa w porównaniu z OAuth. Zamiast szerokich zakresów uprawnień, GitHub Apps wykorzystują precyzyjnie określone uprawnienia, co daje administratorom lepszą kontrolę nad tym, do czego aplikacja ma dostęp i jakie operacje może wykonywać:

• Granularne uprawnienia — GitHub Apps żądają wyłącznie tych uprawnień, które są im niezbędne, w przeciwieństwie do aplikacji OAuth, które opierają się na szerszych zakresach uprawnień.

• Dostęp na poziomie repozytoriów — użytkownicy lub właściciele organizacji mogą wybrać, do których repozytoriów aplikacja GitHub ma dostęp, podczas gdy aplikacje OAuth mogą uzyskać dostęp do wszystkich repozytoriów dostępnych dla użytkownika autoryzującego.

• Krótkotrwałe tokeny — GitHub Apps używają tokenów o krótkim czasie ważności, co zmniejsza ryzyko ich niewłaściwego użycia. Dla porównania, tokeny aplikacji OAuth pozostają ważne do momentu ich ręcznego unieważnienia.

Te funkcje sprawiają, że GitHub Apps są odpowiedniejsze dla organizacji o rygorystycznych wymogach bezpieczeństwa, oferując silniejszą ochronę przed potencjalnymi zagrożeniami.

Aplikacje GitHub korzystające z tokenów dostępu do instalacji domyślnie mają limit 5 000 zapytań na godzinę. Limit ten może zostać zwiększony w określonych warunkach:

• Organizacje GitHub Enterprise Cloud — instalacje powiązane z organizacją GitHub Enterprise Cloud mają limit 15 000 zapytań na godzinę.

• Skalowanie według liczby repozytoriów i użytkowników — dla instalacji, które nie należą do organizacji GitHub Enterprise Cloud:

  • Organizacje posiadające więcej niż 20 repozytoriów otrzymują dodatkowe 50 zapytań na godzinę za każde repozytorium powyżej tego progu.

Powyższe zasady zostały zaprojektowane tak, aby zapewnić równomierne wykorzystanie zasobów przy jednoczesnym utrzymaniu stabilności i bezpieczeństwa systemu.

GitHub Apps mogą być instalowane przez użytkowników na ich kontach osobistych oraz przez właścicieli organizacji w ramach organizacji, którymi zarządzają. Dodatkowo administratorzy repozytoriów w organizacji mogą instalować aplikacje GitHub, pod warunkiem, że są one ograniczone do repozytoriów, którymi administrują, oraz nie żądają uprawnień wpływających na całą organizację ani związanych z administracją repozytorium.

Właściciele organizacji mają jednak możliwość ograniczenia takich instalacji dokonywanych przez zewnętrznych współpracowników pełniących rolę administratorów repozytoriów. Jeśli członkowie organizacji, którzy nie są właścicielami ani administratorami, wybiorą organizację podczas procesu instalacji aplikacji, zamiast bezpośredniej instalacji GitHub powiadomi właściciela organizacji, który będzie musiał zatwierdzić instalację.

Po zainstalowaniu GitHub App może być konieczne również jej autoryzowanie. Instalacja pozwala określić, do których repozytoriów aplikacja ma mieć dostęp, oraz przyznaje jej uprawnienia do korzystania z określonych zasobów organizacji.

Podczas instalacji aplikacja wyświetla do weryfikacji i zatwierdzenia. Po autoryzacji aplikacja może również działać w Twoim imieniu.

Throttling ogranicza liczbę wywołań API lub operacji w określonym oknie czasowym, aby zapobiec nadmiernemu wykorzystaniu zasobów i zapewnić stabilność serwera. Jeśli limity throttlingu zostaną przekroczone, kolejne wysyłane żądania mogą zostać tymczasowo ograniczone, co może wydłużyć czas wykonywania kopii zapasowych.

Xopero ONE może wykorzystywać do 10 dodatkowych aplikacji w celu zwiększenia limitu zapytań i zmniejszenia wpływu throttlingu.

W nadchodzącym wydaniu Xopero ONE (planowanym na maj 2026) wprowadzamy obsługę issue types w GitHubie.

Aby móc korzystać z tej funkcji, GitHub wymaga ręcznej aktualizacji uprawnień GitHub App. Twoje istniejące plany backupu będą nadal działać bez zakłóceń — ta ręczna akceptacja nowych, wymaganych dostępów jest niezbędna, aby odblokować nowe możliwości systemu oraz zapewnić kompatybilność z jego przyszłymi wersjami.

Poniżej znajduje się dokładny opis procesu zatwierdzania żądania aktualizacji uprawnień, krok po kroku.

Integracja GitHuba z Xopero ONE wymaga odpowiednich uprawnień umożliwiających dostęp do repozytoriów i powiązanych z nimi metadanych oraz ich ochronę. Zakres wymaganych uprawnień zależy od wybranej metody autoryzacji (na przykład GitHub App lub token dostępu osobistego (PAT)) oraz typu chronionych danych.

Uprawnienia konta

Do integracji GitHuba z Xopero ONE na potrzeby tworzenia kopii zapasowych i przywracania repozytoriów, projektów oraz ich metadanych wymagane jest konto z uprawnieniami administratora.

Dokładne role i uprawnienia mogą różnić się w zależności od ustawień repozytoriów, konfiguracji projektów oraz polityk bezpieczeństwa organizacji. Poniższe zestawienie przedstawia przykładowe role, przypisane im uprawnienia oraz zakres możliwości, jakie zapewniają one w Xopero ONE.

Uprawnienia aplikacji OAuth

Do poprawnej integracji i działania aplikacja OAuth Xopero ONE* wymaga następujących uprawnień:

• Pełna kontrola nad projektami.

• Odczyt dyskusji zespołów.

• Odczyt członkostwa w organizacji i zespołach, odczyt projektów organizacji.

• Odczyt pełnego profilu użytkownika.

• Pełna kontrola nad prywatnymi repozytoriami.

• Dostęp do adresów e-mail użytkowników (tylko do odczytu).

• Aktualizacja przepływów pracy GitHub Actions.

_{*Aplikacja OAuth Xopero ONE nosi nazwę GitProtect.}

Instalacja GitHub App Xopero ONE* wymaga następujących uprawnień:

• Odczyt akcji, deploymentów, metadanych i projektów repozytorium.

• Odczyt i zapis w zakresie administracji, kodu, issues, pull requestów, hooków repozytorium i przepływów pracy.

_{*GitHub App Xopero ONE nosi nazwę GitProtect.}

W serwisie GitHub, osobiste tokeny dostępu (PAT) generuje się w ustawieniach konta (Settings > Developer settings > Personal access tokens), przypisując im odpowiednie zakresy uprawnień.

Rejestracja aplikacji Xopero ONE oraz obsługa pełnego backupu i przywracania repozytoriów wymaga tokena z uprawnieniami co najmniej repo i workflow.

Poniższa lista przedstawia uprawnienia wymagane do tworzenia kopii zapasowych metadanych repozytoriów w ramach organizacji:

• repo (dostęp do repozytoriów)

• project (odczyt projektów powiązanych z repozytorium)

• admin:org (odczyt projektów organizacji)

• read:discussion (odczyt dyskusji zespołów)