Single sign-on met Google
Saldo vereist HTTP-tunnels
Op deze pagina 4 secties
Laat bezoekers inloggen met hun Google-account voordat ze een HTTP-tunnel kunnen openen. Je maakt een OAuth-client aan in Google Cloud, voegt die als provider toe aan Localtonet en zet hem daarna aan voor de tunnel.
Voordat je begint #
- Een HTTP-tunnel en saldo op je account. Zie het overzicht van single sign-on.
- Een Google-account met toegang tot de Google Cloud-console en een project daarin.
Stappen #
-
Maak een OAuth-client aan in Google Cloud #
Google past zijn console af en toe aan. De eigen handleiding is Manage OAuth Clients. In het kort:
- Open in de Google Cloud-console Google Auth Platform voor je project. Als het project nieuw is, vraagt de console je eerst de app in te stellen: een appnaam, een ondersteunings-e-mailadres, de doelgroep en contactgegevens.
- Kies onder Audience wie mag inloggen. Zie de tabel hieronder.
- Open Clients en kies Create client.
- Stel Application type in op Web application en geef de client een naam.
- Voeg onder Authorized redirect URIs de onderstaande redirect-URI toe. Authorized JavaScript origins kan leeg blijven.
- Kies Create en kopieer daarna de Client ID en het Client secret. Google toont het volledige geheim alleen op dit moment.
Geautoriseerde redirect-URIhttp://auth.localtonet.com/auth/callbackDoelgroep in Google Wie kan inloggen Internal Alleen leden van je Google Cloud-organisatie. External, publicatiestatus Testing De testgebruikers die je in Google opgeeft, maximaal 100. Google maakt een uitzondering voor apps die alleen de naam, het e-mailadres en het profiel van de gebruiker opvragen: voor die apps hoeven gebruikers niet op de lijst te staan. Vertrouw er niet op dat de lijst met testgebruikers mensen buiten houdt; gebruik de toegangsregels van Localtonet. External, publicatiestatus In production Iedereen met een Google-account. Gebruik de toegangsregels van Localtonet om dit te beperken. De aanmelding vraagt de scopes
openid,emailenprofileaan. Als Google je vraagt scopes voor de app te kiezen, zijn deze drie genoeg.Volgens Google kan het 5 minuten tot enkele uren duren voordat een wijziging aan een client van kracht wordt.
-
Voeg de provider toe in Localtonet #
Open Mijn tunnels › HTTP en kies bovenaan de pagina SSO. Kies in het dialoogvenster SSO-providers de optie Provider toevoegen.
Veld Waarde Providernaam Een willekeurige naam, bijvoorbeeld Company Google. Je ziet hem in de tunnelinstellingen.Providertype Google. Als je het type van een opgeslagen provider wijzigt, wordt Client-ID leeggemaakt, dus vul het client-ID en het clientgeheim opnieuw in. Actief Aan Client-ID Het client-ID van Google. Clientgeheim Het clientgeheim van Google. Het wordt na het opslaan nooit meer getoond. Onder Endpoints & callback worden de standaardadressen van Google automatisch ingevuld. Laat ze zoals ze zijn:
Veld Ingevulde waarde Autorisatie-endpoint https://accounts.google.com/o/oauth2/v2/authToken-endpoint https://oauth2.googleapis.com/tokenGebruikersinfo-endpoint https://openidconnect.googleapis.com/v1/userinfoCallbackpad /auth/callback/googleVul eventueel Toegangsregels voor e-mail in. Om alleen je bedrijf toe te laten, vul je het domein ervan in, bijvoorbeeld
example.com, onder Toegestane e-maildomeinen. Kies Provider opslaan. -
Zet hem aan voor een tunnel #
Kies onder Je tunnels de optie Instellingen bij de tunnel en daarna Beheren naast SSO-providers. Zet in het dialoogvenster Single sign-on de optie Inloggen vereisen aan, en de schakelaar van je Google-provider. Kies Opslaan.
De lijsten onder Wie kan inloggen en de Inlogpaden zijn optioneel. Ze worden uitgelegd in het overzicht.
-
Test het #
Open de tunnel-URL in een privévenster van de browser. Localtonet toont Sign in to continue met een knop voor je provider. Nadat je bij Google bent ingelogd, word je teruggestuurd naar de tunnel en laadt je service.
Probleemoplossing #
Google meldt redirect_uri_mismatch
De redirect-URI in het verzoek is niet een van de Authorized redirect URIs van de client. Voeg precies http://auth.localtonet.com/auth/callback toe aan de client in Google en geef de wijziging even de tijd om van kracht te worden.
De Google-console accepteert de redirect-URI niet
Google controleert redirect-URI's aan de hand van zijn validatieregels. De melding naast het veld noemt de regel die mislukte.
Google weigert het account, bijvoorbeeld met org_internal
Google heeft het account geweigerd voordat Localtonet het zag. Bij de doelgroep Internal kunnen alleen leden van je organisatie inloggen, en Google meldt org_internal voor alle anderen. Controleer bij External in Testing de lijst met testgebruikers in Google.
Google meldt invalid_client
Google accepteert de client niet. Controleer het Client-ID en het Clientgeheim die in Localtonet zijn opgeslagen, en of de client nog bestaat in Google. Plak beide opnieuw en kies Provider opslaan. Heb je het geheim niet meer, maak dan een nieuw geheim aan in Google.
"403 - Access Denied" na een geslaagde Google-aanmelding
Een regel van Localtonet heeft het account geweigerd. Vergelijk het adres waarmee de bezoeker is ingelogd met Toegestane e-maildomeinen, Geblokkeerde e-maildomeinen en Geblokkeerde e-mailadressen van de provider, en met Wie kan inloggen bij de tunnel.
Er staat geen Google-knop op de inlogpagina
De provider is niet aangezet voor deze tunnel, of staat op inactief. Controleer beide.