Wymagane uprawnienia

Uprawnienia wymagane do integracji GitHuba z Xopero ONE oraz ochrony jego zasobów.

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.

ROLE I UPRAWNIENIA GITHUB

Rola w organizacji	Rola w repozytorium	Możliwości
Owner	Default	Pełny backup i przywracanie.
	Admin	Pełny backup i przywracanie.
	Write	Pełny backup i przywracanie.
	Read	Pełny backup. Przywracanie tylko do własnego konta użytkownika.
Member	Admin	Pełny backup. Przywracanie tylko do własnego konta użytkownika.
	Maintain	Pełny backup. Przywracanie tylko do własnego konta użytkownika.
	Write	Pełny backup. Przywracanie tylko do własnego konta użytkownika.
	Triage	Backup z wyłączeniem collaborators. Przywracanie tylko do własnego konta użytkownika.
Collaborator	Read	Backup z wyłączeniem collaborators. Przywracanie tylko do własnego konta użytkownika.
Outside collaborator	Default	Backup z wyłączeniem collaborators. Przywracanie tylko do własnego konta użytkownika.

---

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

---

Uprawnienia GitHub App

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

---

Uprawnienia dla osobistych tokenów dostępu (PAT)

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.

Przy minimalnym poziomie uprawnień niektóre metadane mogą nie zostać uwzględnione w kopii zapasowej. Dobierz uprawnienia odpowiednio do zakresu chronionych danych.

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)

• read:public_key (dostęp do kluczy)

• read:repo_hook (dostęp do webhooków)

Token z uprawnieniami wyłącznie do odczytu (read) umożliwia wykonywanie backupu, jednak przywracanie danych wymaga tokena z uprawnieniami do zapisu (write).

---

Przydatne linki i materiały

Managing your personal access tokens - GitHub DocsGitHub Docs