Soziale Anmeldung mit GitHub einrichten
Der offizielle Logto-Connector für die GitHub-Sozialanmeldung.
In diesem Leitfaden gehen wir davon aus, dass du grundlegende Kenntnisse über Logto Connectors hast. Falls nicht, schaue dir den Leitfaden Connectors konfigurieren an, um loszulegen.
Erste Schritte
Der GitHub-Connector ermöglicht Endbenutzern, sich über ihre eigenen GitHub-Konten mithilfe des GitHub OAuth 2.0-Authentifizierungsprotokolls bei deiner Anwendung anzumelden.
Anmeldung mit GitHub-Konto
Gehe zur GitHub-Website und melde dich mit deinem GitHub-Konto an. Du kannst ein neues Konto registrieren, wenn du noch keines hast.
OAuth-App erstellen und konfigurieren
Folge der Anleitung zum Erstellen einer OAuth-App und registriere eine neue Anwendung.
Benenne deine neue OAuth-Anwendung im Feld Application name und fülle die Homepage URL der App aus. Du kannst das Feld Application description leer lassen und die Authorization callback URL als ${your_logto_origin}/callback/${connector_id}
anpassen. Die connector_id
findest du in der oberen Leiste der Logto Admin Console auf der Seite mit den Connector-Details.
Hinweis: Wenn du die Fehlermeldung "The redirect_uri MUST match the registered callback URL for this application." beim Anmelden erhältst, versuche, die Authorization Callback URL deiner GitHub OAuth-App und die Redirect-URL deiner Logto-App (einschließlich des Protokolls) abzugleichen, um das Problem zu lösen.
Wir empfehlen, das Kästchen vor Enable Device Flow nicht zu aktivieren, da Benutzer, die sich mit GitHub auf mobilen Geräten anmelden, die anfängliche Anmeldeaktion in der GitHub-App bestätigen müssen. Viele GitHub-Benutzer installieren die GitHub-Mobile-App nicht auf ihren Telefonen, was den Anmeldefluss blockieren könnte. Bitte ignoriere unsere Empfehlung, wenn du erwartest, dass Endbenutzer ihren Anmeldefluss bestätigen. Siehe Details zum Device Flow.
Verwaltung von OAuth-Apps
Gehe zur OAuth-Apps-Seite, wo du vorhandene OAuth-Apps hinzufügen, bearbeiten oder löschen kannst. Du kannst auch Client ID
finden und Client secrets
auf den Detailseiten der OAuth-App generieren.
Konfiguriere deinen Connector
Fülle die Felder clientId
und clientSecret
mit der Client ID und dem Client Secret aus, die du auf den Detailseiten der OAuth-App im vorherigen Abschnitt erhalten hast.
scope
ist eine durch Leerzeichen getrennte Liste von Berechtigungen (Scopes). Wenn nicht angegeben, ist die Standardberechtigung read:user
.
Konfigurationstypen
Name | Typ |
---|---|
clientId | string |
clientSecret | string |
scope | string |
GitHub-Connector testen
Das war's. Der GitHub-Connector sollte jetzt verfügbar sein. Vergiss nicht, den sozialen Connector in der Anmeldeerfahrung zu aktivieren.