GitHub-Anmeldung für Discourse konfigurieren

[Discourse]

Diese Anleitung erklärt, wie Sie GitHub als Anmeldeoption für Ihr Discourse-Forum einrichten, indem Sie OAuth-Anmeldeinformationen konfigurieren.

Erforderliches Benutzerniveau: Administrator

Übersicht

Die GitHub-Anmeldeintegration ermöglicht es Benutzern, sich auf Ihrer Discourse-Website mit ihren GitHub-Konten anzumelden. Dies bietet eine bequeme Authentifizierungsoption, die besonders für Entwickler-fokussierte Communities nützlich ist.

GitHub OAuth einrichten

1. Besuchen Sie die Entwicklereinstellungen von GitHub unter https://github.com/settings/developers

2. Suchen Sie im linken Menü nach OAuth Apps und klicken Sie darauf.

3. Klicken Sie auf New OAuth App (Neue OAuth-App)

4. Füllen Sie die erforderlichen Felder aus:

   • Application name (Anwendungsname): Geben Sie den Namen Ihrer Website ein
   • Homepage URL: Die Haupt-URL Ihrer Website (z. B. https://discourse.example.com)
   • Application description (Anwendungsbeschreibung) (optional): Beschreiben Sie Ihre Website kurz
   • Authorization callback URL (Autorisierungs-Rückruf-URL): Verwenden Sie die Domain Ihrer Website mit dem Pfad /auth/github/callback
     (z. B. https://discourse.example.com/auth/github/callback)

5. Klicken Sie auf Register application (Anwendung registrieren)

Discourse-Einstellungen konfigurieren

1. Nach der Registrierung zeigt GitHub Ihre Client ID auf der Einstellungsseite der App an.

2. Um ein Client Secret zu erhalten, klicken Sie auf Generate a new client secret (Neues Client-Geheimnis generieren). Kopieren Sie es sofort – es wird nur einmal angezeigt.

3. Konfigurieren Sie in Ihren Discourse-Admin-Einstellungen Folgendes:

   • Setzen Sie github_client_id auf Ihre Client ID
   • Setzen Sie github_client_secret auf Ihr Client Secret
   • Aktivieren Sie die Einstellung enable github logins (GitHub-Anmeldungen aktivieren)

Die Integration testen

1. Melden Sie sich von Ihrer Discourse-Website ab.
2. Auf der Anmeldeseite sollten Sie nun eine Anmeldeoption „mit GitHub“ sehen.
3. Testen Sie den Anmeldevorgang, um sicherzustellen, dass er wie erwartet funktioniert.

Best Practices

• Bewahren Sie Ihr Client Secret sicher auf und geben Sie es niemals öffentlich weiter.
• Überprüfen Sie regelmäßig die Einstellungen Ihrer GitHub OAuth-App.
• Erwägen Sie die Aktivierung zusätzlicher Sicherheitsfunktionen in den OAuth-App-Einstellungen von GitHub.

Häufige Probleme und Lösungen

• Wenn die Anmeldung fehlschlägt, überprüfen Sie, ob Ihre Rückruf-URL exakt mit der in GitHub konfigurierten URL übereinstimmt.
• Stellen Sie sicher, dass das SSL-Zertifikat Ihrer Website gültig ist, da GitHub HTTPS erfordert.
• Überprüfen Sie, ob sowohl Client ID als auch Secret in den Discourse-Einstellungen korrekt eingegeben wurden.

Zusätzliche Ressourcen

• Setup DiscourseConnect - Official Single-Sign-On for Discourse (sso)
• Creating an OAuth app - GitHub Docs