So erstellen Sie eine selbst gehostete GitHub App
Wenn Sie Bencher Cloud verwenden, können Sie sich einfach anmelden oder einloggen
mit dem GitHub
Button.
Für die selbstgehostete Bencher-Variante benötigen Sie einen Bencher Plus Enterprise-Plan, müssen Ihre eigene GitHub-App erstellen und Ihre Konsolenkonfiguration sowie die API-Server-Konfiguration aktualisieren.
Eine GitHub App erstellen
- Erstellen Sie eine GitHub App
- GitHub App Name
- Wählen Sie einen eindeutigen Namen (z.B.
Bencher für Mein Unternehmen
)
- Wählen Sie einen eindeutigen Namen (z.B.
- Homepage URL
- Stellen Sie diese auf Ihre Bencher Self-Hosted Console URL ein (z.B.
https://bencher.example.com
)
- Stellen Sie diese auf Ihre Bencher Self-Hosted Console URL ein (z.B.
- Identifizierung und Autorisierung von Benutzern
- Rückruf-URL
- Setzen Sie die Rückruf-URL auf Ihre Bencher Self-Hosted Console URL mit dem Pfad
/auth/github
(z.B.https://bencher.example.com/auth/github
)
- Setzen Sie die Rückruf-URL auf Ihre Bencher Self-Hosted Console URL mit dem Pfad
- ✅ Ablauf von Benutzer-Autorisierungstokens
- ✅ Benutzer-Autorisierung (OAuth) während der Installation anfordern
- ✅ Gerätefluss aktivieren
- Rückruf-URL
- Webhook
- ❌ Aktiv - Entfernen Sie das Häkchen in diesem Kästchen
- Berechtigungen
- Kontoberechtigungen
- E-Mail-Adressen:
Nur lesen
- E-Mail-Adressen:
- Kontoberechtigungen
- Wo kann diese GitHub App installiert werden?
- 🔘 Jedes Konto
- Klicken Sie auf
GitHub App erstellen
- Jetzt unter
Allgemein
für die neu erstellte App - Notieren Sie die
Client ID
(z.B.Iv1.12864abcd1232048
) - Client-Geheimnisse
- Klicken Sie auf
Neues client secret generieren
- Notieren Sie dieses Geheimnis (z.B.
00000abcd12345wxyz123456789abcdefgh0000
)
- Klicken Sie auf
- Fügen Sie das Bencher Logo PNG unter Display-Informationen hinzu
- Private Schlüssel
- Klicken Sie auf
Privaten Schlüssel generieren
- Klicken Sie auf
GitHub App Konfiguration
Konsole UI
Setzen Sie die Umgebungsvariable GITHUB_CLIENT_ID
, wenn Sie das bencher-console
Docker-Image ausführen. (z.B. GITHUB_CLIENT_ID=Iv1.12864abcd1232048
) Wenn die Client-ID fehlt, werden die GitHub-Buttons nicht in der UI angezeigt.
API-Server
Fügen Sie die client_id
und das client_secret
zu dem plus.github
Abschnitt der Serverkonfiguration hinzu. Wenn der GitHub-Abschnitt fehlt, wird der Server alle GitHub-Authentifizierungsanfragen ablehnen.
🐰 Gratulation! Sie haben gelernt, wie man eine GitHub App einrichtet! 🎉