GitHub
Standardowy formularz konektora, opisany ogólnie w Konektorach. Obsługiwany jest zarówno github.com, jak i GitHub Enterprise.
| Pole | Co wpisać | Przykład |
|---|---|---|
| Adres URL API konektora | adres API instancji | https://api.github.com albo https://github.firma.pl/api/v3 |
| Nazwa użytkownika | login konta, na którym wygenerowano token | q247-service |
| Osobisty token dostępu (PAT) | token z uprawnieniem odczytu repozytoriów | ghp_xxxxxxxx albo $$GITHUB_TOKEN |
| ID organizacji (opcjonalne) | nazwa organizacji, gdy skanowanie ma się do niej ograniczyć | firma |
Pole ID organizacji jest tutaj opcjonalne. Bez niego konektor odkryje wszystkie repozytoria, do których ma dostęp konto serwisowe. Podanie organizacji zawęża zakres, co przydaje się, gdy konto należy jednocześnie do kilku organizacji.
Nazwę użytkownika i token można podać wprost albo wskazać zmienną środowiskową hosta wtyczki, zapisem $$GITHUB_TOKEN. Drugi wariant trzyma poświadczenie poza bazą Q247 i opisany jest szerzej w Konektorach.
Token generuje się w ustawieniach konta GitHub, w sekcji Developer settings. Wystarczy uprawnienie odczytu repozytoriów. Przy tokenie klasycznym odpowiada mu zakres repo ograniczony do odczytu; przy tokenie drobnoziarnistym uprawnienie Contents na poziomie Read-only.
Zobacz też
- Konektory: wspólny formularz, uprawnienia tokenu, statusy
- Uruchomienie analizy kodu: co zrobić po zapisaniu konektora