Soziale Anmeldung mit GitHub einrichten
Der offizielle Logto-Connector für die GitHub-Sozialanmeldung.
Diese Anleitung setzt voraus, dass du ein grundlegendes Verständnis von Logto Connectors hast. Für diejenigen, die damit nicht vertraut sind, verweisen wir auf die Connectors Anleitung, um loszulegen.
Erste Schritte
Der GitHub-Connector ermöglicht es Endbenutzern, sich über ihre eigenen GitHub-Konten mithilfe des GitHub OAuth 2.0-Authentifizierungsprotokolls bei deiner Anwendung anzumelden.
Mit GitHub-Konto anmelden
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.
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 (natürlich 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 haben die GitHub-Mobile-App nicht auf ihren Telefonen installiert, was den Anmeldevorgang blockieren könnte. Bitte ignoriere unsere Empfehlung, wenn du erwartest, dass Endbenutzer ihren Anmeldevorgang 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 in der vorherigen Sektion erwähnten Detailseiten der OAuth-App 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, Sozialen Connector in der Anmeldeerfahrung aktivieren.
Referenz
GitHub - Entwickler - Apps
GitHub - Entwickler - Apps - Erstellen einer OAuth-App