Single Sign-On mit Google
Guthaben erforderlich HTTP-Tunnel
Auf dieser Seite 4 Abschnitte
Lassen Sie Besucher sich mit ihrem Google-Konto anmelden, bevor sie einen HTTP-Tunnel öffnen können. Sie erstellen in Google Cloud einen OAuth-Client, fügen ihn in Localtonet als Anbieter hinzu und schalten ihn dann für den Tunnel ein.
Bevor Sie beginnen #
- Ein HTTP-Tunnel und Guthaben auf Ihrem Konto. Siehe die Übersicht zu Single Sign-On.
- Ein Google-Konto mit Zugriff auf die Google-Cloud-Konsole und ein Projekt darin.
Schritte #
-
Einen OAuth-Client in Google Cloud erstellen #
Google ändert seine Konsole von Zeit zu Zeit. Die eigene Anleitung von Google ist Manage OAuth Clients. Kurz gesagt:
- Öffnen Sie in der Google-Cloud-Konsole Google Auth Platform für Ihr Projekt. Ist das Projekt neu, bittet die Konsole Sie zuerst, die App einzurichten: einen App-Namen, eine Support-E-Mail-Adresse, die Zielgruppe und Kontaktinformationen.
- Legen Sie unter Audience fest, wer sich anmelden darf. Siehe die Tabelle unten.
- Öffnen Sie Clients und wählen Sie Create client.
- Setzen Sie Application type auf Web application und geben Sie dem Client einen Namen.
- Fügen Sie unter Authorized redirect URIs die untenstehende Redirect-URI hinzu. Authorized JavaScript origins können leer bleiben.
- Wählen Sie Create und kopieren Sie dann die Client ID und das Client secret. Google zeigt das vollständige Secret nur an dieser Stelle.
Authorized redirect URIhttp://auth.localtonet.com/auth/callbackAudience in Google Wer sich anmelden darf Internal Nur Mitglieder Ihrer Google-Cloud-Organisation. External, Veröffentlichungsstatus Testing Die Testnutzer, die Sie in Google auflisten, bis zu 100. Google macht eine Ausnahme für Apps, die nur Name, E-Mail-Adresse und Profil des Nutzers anfordern: Dann müssen Nutzer nicht auf der Liste stehen. Verlassen Sie sich nicht auf die Testnutzerliste, um Personen auszuschließen; verwenden Sie die Zugriffsregeln von Localtonet. External, Veröffentlichungsstatus In production Jeder mit einem Google-Konto. Schränken Sie das mit den Zugriffsregeln von Localtonet ein. Die Anmeldung fordert die Scopes
openid,emailundprofilean. Fragt Google Sie nach den Scopes für die App, genügen diese drei.Laut Google kann es von 5 Minuten bis zu einigen Stunden dauern, bis eine Änderung an einem Client wirksam wird.
-
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.
Feld Wert Anbietername Ein beliebiger Name, zum Beispiel Company Google. Sie sehen ihn in den Tunneleinstellungen.Anbietertyp Google. Wenn Sie den Typ eines gespeicherten Anbieters ändern, wird die Client-ID geleert; geben Sie daher die Client-ID und das Client-Secret erneut ein. Aktiv An Client-ID Die Client-ID von Google. Client-Secret Das Client-Secret von Google. Es wird nach dem Speichern nie wieder angezeigt. Unter Endpunkte & Callback werden die Standardadressen von Google automatisch eingetragen. Lassen Sie sie unverändert:
Feld Eingetragener Wert Autorisierungs-Endpunkt https://accounts.google.com/o/oauth2/v2/authToken-Endpunkt https://oauth2.googleapis.com/tokenUserinfo-Endpunkt https://openidconnect.googleapis.com/v1/userinfoCallback-Pfad /auth/callback/googleFüllen Sie optional die E-Mail-Zugriffsregeln aus. Um nur Ihr Unternehmen zuzulassen, geben Sie unter Erlaubte E-Mail-Domains dessen Domain ein, zum Beispiel
example.com. Wählen Sie Anbieter speichern. -
Für einen Tunnel einschalten #
Wählen Sie unter Ihre Tunnel beim Tunnel Einstellungen und dann neben SSO-Anbieter die Option Verwalten. Schalten Sie im Dialog Single Sign-On die Option Anmeldung verlangen und den Schalter Ihres Google-Anbieters ein. Wählen Sie Speichern.
Die Listen unter Wer sich anmelden darf und die Anmeldepfade sind optional. Sie werden in der Übersicht erklärt.
-
Testen #
Öffnen Sie die Tunnel-URL in einem privaten Browserfenster. Localtonet zeigt Sign in to continue mit einer Schaltfläche für Ihren Anbieter. Nachdem Sie sich bei Google angemeldet haben, werden Sie zum Tunnel zurückgeleitet, und Ihr Dienst wird geladen.
Fehlerbehebung #
Google meldet redirect_uri_mismatch
Die Redirect-URI in der Anfrage gehört nicht zu den Authorized redirect URIs des Clients. Fügen Sie dem Client in Google genau http://auth.localtonet.com/auth/callback hinzu und warten Sie etwas, bis die Änderung wirksam wird.
Die Google-Konsole akzeptiert die Redirect-URI nicht
Google prüft Redirect-URIs anhand seiner Validierungsregeln. Die Meldung neben dem Feld nennt die Regel, die fehlgeschlagen ist.
Google lehnt das Konto ab, zum Beispiel mit org_internal
Google hat das Konto abgelehnt, bevor Localtonet es sah. Mit der Audience Internal können sich nur Mitglieder Ihrer Organisation anmelden, und Google meldet für alle anderen org_internal. Prüfen Sie bei External im Status Testing die Testnutzerliste in Google.
Google meldet invalid_client
Google akzeptiert den Client nicht. Prüfen Sie die in Localtonet gespeicherte Client-ID und das Client-Secret sowie, ob der Client in Google noch existiert. Fügen Sie beide erneut ein und wählen Sie Anbieter speichern. Haben Sie das Secret nicht mehr, erstellen Sie in Google ein neues.
„403 - Access Denied“ nach erfolgreicher Google-Anmeldung
Eine Localtonet-Regel hat das Konto abgelehnt. Vergleichen Sie die Adresse, mit der sich der Besucher angemeldet hat, mit den Erlaubten E-Mail-Domains, den Blockierten E-Mail-Domains und den Blockierten E-Mail-Adressen des Anbieters sowie mit Wer sich anmelden darf beim Tunnel.
Auf der Anmeldeseite gibt es keine Google-Schaltfläche
Der Anbieter ist für diesen Tunnel nicht eingeschaltet oder auf inaktiv gesetzt. Prüfen Sie beides.