GitHub

GitHub wird mit einem Personal Access Token (fine-grained oder classic) verbunden. Es gibt keine OAuth- oder GitHub-App-Option, und auf GitHub-Seite wird außer dem Token nichts registriert.

AppArch spricht mit api.github.com, daher wird nur github.com unterstützt. GitHub Enterprise Server wird nicht unterstützt.

Verbinden

1. Öffnen Sie auf GitHub Settings → Developer settings → Personal access tokens und erstellen Sie ein Token.
2. Öffnen Sie in AppArch Credentials → Add credential → GitHub, fügen Sie das Token ein und speichern Sie. Organisations- oder Benutzername ist optional.
3. Verbinden Sie Projekte aus den Repositories, die das Token sieht.

Berechtigungen

• Classic Token: der Scope repo. Ein classic Token ohne repo wird beim Speichern abgelehnt. AppArch liest Scopes und Ablaufdatum bei GitHub aus, bevor das Token gespeichert wird.
• Fine-grained Token: Lesezugriff auf die zu prüfenden Repositories. Fine-grained Tokens melden keine Scopes, daher entscheidet der Verbindungstest. Damit ArchPilot kommentieren kann, braucht das Token zusätzlich Pull requests: Read and write.

Was es ermöglicht

• ArchPilot kommentiert Pull Requests.
• ArchScan / ArchSecurity-Ergebnisse aus CI-Läufen erscheinen im Panel.

Ein Token kann keine Webhooks empfangen; AppArch erfährt von Änderungen an Pull Requests daher per Polling statt über sofortige Ereignisse.

Ablauf

Das von GitHub gemeldete Ablaufdatum wird am Zugang angezeigt. Ein abgelaufenes Token funktioniert nicht mehr; erstellen Sie ein neues Token und fügen Sie es als neuen Zugang hinzu.

CI

Binden Sie den Runner in GitHub Actions ein - siehe Runner in die CI einbinden.

Hinweis

Kommentare werden von dem Konto gepostet, dem das Token gehört; ein eigenes Bot-Konto hält sie von der Aktivität einer Person getrennt. Siehe ArchPilot aktivieren.