Zum Inhalt springen
Localtonet Localtonet Dashboard

Single Sign-On mit GitHub

Guthaben erforderlich HTTP-Tunnel

Hilfe zu dieser Seite
Auf dieser Seite 4 Abschnitte
  1. Bevor Sie beginnen
  2. Schritte
  3. Eine OAuth-App bei GitHub registrieren
  4. Den Anbieter in Localtonet hinzufügen
  5. Für einen Tunnel einschalten
  6. Testen
  7. Fehlerbehebung
  8. Verwandte Seiten

Lassen Sie Besucher sich mit ihrem GitHub-Konto anmelden, bevor sie einen HTTP-Tunnel öffnen können. Sie registrieren eine OAuth-App bei GitHub, fügen sie in Localtonet als Anbieter hinzu und aktivieren sie dann für den Tunnel.

Bevor Sie beginnen #

  • Ein HTTP-Tunnel und Guthaben auf Ihrem Konto. Siehe die Single-Sign-On-Übersicht.
  • Ein GitHub-Konto. Um die App für eine Organisation zu registrieren, benötigen Sie Zugriff auf die Einstellungen dieser Organisation.

Schritte #

  1. Eine OAuth-App bei GitHub registrieren #

    Die eigene Anleitung von GitHub ist Creating an OAuth app. Kurz gefasst:

    1. Öffnen Sie auf GitHub das Menü unter Ihrem Profilbild und wählen Sie Settings, dann Developer settings und dann OAuth apps.
    2. Wählen Sie New OAuth App. Wenn Sie noch keine App haben, heißt die Schaltfläche Register a new application.
    3. Füllen Sie das Formular mit den untenstehenden Werten aus und wählen Sie Register application.
    4. Kopieren Sie auf der Seite der neuen App die Client ID, wählen Sie dann Generate a new client secret und kopieren Sie das Secret sofort.
    GitHub-FeldWert
    Application nameEin Name, den Ihre Besucher wiedererkennen. GitHub zeigt ihn an, wenn es sie um die Autorisierung bittet.
    Homepage URLEine Webadresse, die die App beschreibt, zum Beispiel Ihre Website.
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device FlowLassen Sie die Option ausgeschaltet.

    Sie wählen auf GitHub keine Scopes aus. Die Anmeldeanfrage nennt sie: read:user und user:email. GitHub bittet den Besucher bei der ersten Anmeldung, ihnen zuzustimmen.

  2. Den Anbieter in Localtonet hinzufügen #

    Öffnen Sie Meine Tunnel › HTTP und wählen Sie oben auf der Seite SSO. Wählen Sie im Dialog SSO-Anbieter die Option Anbieter hinzufügen.

    FeldWert
    AnbieternameEin beliebiger Name, zum Beispiel GitHub. Sie sehen ihn in den Tunneleinstellungen.
    AnbietertypGitHub. Wenn Sie den Typ eines gespeicherten Anbieters ändern, wird die Client-ID geleert. Geben Sie daher Client-ID und Client-Secret erneut ein.
    AktivAn
    Client-IDDie Client-ID von GitHub.
    Client-SecretDas Client-Secret von GitHub. Es wird nach dem Speichern nie wieder angezeigt.

    Unter Endpunkte & Callback werden die Standardadressen von GitHub automatisch eingetragen. Lassen Sie sie unverändert:

    FeldEingetragener Wert
    Autorisierungs-Endpunkthttps://github.com/login/oauth/authorize
    Token-Endpunkthttps://github.com/login/oauth/access_token
    Userinfo-Endpunkthttps://api.github.com/user
    Callback-Pfad/auth/callback/github

    Füllen Sie optional E-Mail-Zugriffsregeln aus und wählen Sie dann Anbieter speichern.

  3. Für einen Tunnel einschalten #

    Wählen Sie unter Ihre Tunnel beim Tunnel Einstellungen und dann neben SSO-Anbieter die Option Verwalten. Aktivieren Sie im Dialog Single Sign-On die Option Anmeldung verlangen sowie den Schalter Ihres GitHub-Anbieters. Wählen Sie Speichern.

    Jeder kann ein GitHub-Konto erstellen. Ohne Regel kann jeder GitHub-Benutzer, der die Adresse kennt, den Tunnel öffnen. Füllen Sie Wer sich anmelden darf beim Tunnel oder Erlaubte E-Mail-Domains beim Anbieter aus. Die Listen werden in der Übersicht erklärt.

  4. Testen #

    Öffnen Sie die Tunnel-URL in einem privaten Browserfenster. Localtonet zeigt Sign in to continue mit einer Schaltfläche für Ihren Anbieter. GitHub bittet Sie beim ersten Mal, die App zu autorisieren. Danach werden Sie zum Tunnel zurückgeleitet, und Ihr Dienst wird geladen.

Fehlerbehebung #

GitHub meldet eine nicht übereinstimmende Redirect-URI

Der Fehler von GitHub lautet redirect_uri_mismatch: "The redirect_uri MUST match the registered callback URL for this application." Keine Callback-URL der OAuth-App stimmt mit der gesendeten Adresse überein. Setzen Sie Authorization callback URL auf GitHub genau auf http://auth.localtonet.com/auth/callback.

Ein Besucher wird abgewiesen, obwohl seine Adresse auf der Liste steht

Der standardmäßige Userinfo-Endpunkt https://api.github.com/user liefert möglicherweise keine E-Mail-Adresse, wenn der GitHub-Benutzer in seinem Profil keine öffentliche E-Mail-Adresse festgelegt hat. Bitten Sie den Besucher zu prüfen, welche Adresse in seinem GitHub-Profil als öffentliche E-Mail festgelegt ist, und vergleichen Sie sie mit Ihren Listen.

„403 - Access Denied“ nach erfolgreicher GitHub-Anmeldung

Eine Localtonet-Regel hat das Konto abgelehnt. Prüfen Sie die E-Mail-Zugriffsregeln beim Anbieter und Wer sich anmelden darf beim Tunnel. Warten Sie nach der Korrektur einer Regel eine Minute und laden Sie die Seite neu.

Die Anmeldung schlägt vor oder nach der Autorisierungsseite von GitHub fehl

Gleichen Sie die in Localtonet gespeicherte Client-ID und das Client-Secret mit der OAuth-App ab. Fügen Sie die Client-ID erneut ein, erzeugen Sie auf GitHub ein neues Client-Secret, fügen Sie es im Anbieter ein und wählen Sie Anbieter speichern.

Auf der Anmeldeseite gibt es keine GitHub-Schaltfläche

Der Anbieter ist für diesen Tunnel nicht aktiviert oder auf inaktiv gesetzt. Prüfen Sie beides.

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support