Zum Hauptinhalt springen

Soziale Anmeldung mit GitHub einrichten

Der offizielle Logto-Connector für die GitHub-Sozialanmeldung.

tipp

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

NameTyp
clientIdstring
clientSecretstring
scopestring

GitHub-Connector testen

Das war's. Der GitHub-Connector sollte jetzt verfügbar sein. Vergiss nicht, den sozialen Connector in der Anmeldeerfahrung zu aktivieren.

Referenz