Zum Inhalt springen
Localtonet Localtonet Dashboard

Single Sign-On mit Google

Guthaben erforderlich HTTP-Tunnel

Hilfe zu dieser Seite
Auf dieser Seite 4 Abschnitte
  1. Bevor Sie beginnen
  2. Schritte
  3. Einen OAuth-Client in Google Cloud erstellen
  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 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 #

Schritte #

  1. 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:

    1. Ö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.
    2. Legen Sie unter Audience fest, wer sich anmelden darf. Siehe die Tabelle unten.
    3. Öffnen Sie Clients und wählen Sie Create client.
    4. Setzen Sie Application type auf Web application und geben Sie dem Client einen Namen.
    5. Fügen Sie unter Authorized redirect URIs die untenstehende Redirect-URI hinzu. Authorized JavaScript origins können leer bleiben.
    6. 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 URI
    http://auth.localtonet.com/auth/callback
    Audience in GoogleWer sich anmelden darf
    InternalNur Mitglieder Ihrer Google-Cloud-Organisation.
    External, Veröffentlichungsstatus TestingDie 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 productionJeder mit einem Google-Konto. Schränken Sie das mit den Zugriffsregeln von Localtonet ein.

    Die Anmeldung fordert die Scopes openid, email und profile an. 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.

  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 Company Google. Sie sehen ihn in den Tunneleinstellungen.
    AnbietertypGoogle. 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.
    AktivAn
    Client-IDDie Client-ID von Google.
    Client-SecretDas 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:

    FeldEingetragener Wert
    Autorisierungs-Endpunkthttps://accounts.google.com/o/oauth2/v2/auth
    Token-Endpunkthttps://oauth2.googleapis.com/token
    Userinfo-Endpunkthttps://openidconnect.googleapis.com/v1/userinfo
    Callback-Pfad/auth/callback/google

    Fü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.

  3. 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.

  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. 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.

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

Support