Single Sign-On con Google
Saldo necessario Tunnel HTTP
In questa pagina 4 sezioni
Permetti ai visitatori di accedere con il loro account Google prima di poter aprire un tunnel HTTP. Crei un client OAuth in Google Cloud, lo aggiungi a Localtonet come provider, poi lo attivi per il tunnel.
Prima di iniziare #
- Un tunnel HTTP e del Saldo sul tuo account. Vedi la panoramica di Single Sign-On.
- Un account Google con accesso alla console di Google Cloud e un progetto al suo interno.
Passaggi #
-
Crea un client OAuth in Google Cloud #
Google cambia la sua console di tanto in tanto. La sua guida ufficiale è Manage OAuth Clients. In breve:
- Nella console di Google Cloud apri Google Auth Platform per il tuo progetto. Se il progetto è nuovo, la console ti chiede prima di configurare l'app: un nome dell'app, un'email di supporto, il pubblico e le informazioni di contatto.
- Sotto Audience scegli chi può accedere. Vedi la tabella qui sotto.
- Apri Clients e seleziona Create client.
- Imposta Application type su Web application e dai un nome al client.
- Sotto Authorized redirect URIs aggiungi l'URI di reindirizzamento qui sotto. Authorized JavaScript origins può restare vuoto.
- Seleziona Create, poi copia il Client ID e il Client secret. Google mostra il secret completo solo in questo momento.
URI di reindirizzamento autorizzatohttp://auth.localtonet.com/auth/callbackAudience in Google Chi può accedere Internal Solo i membri della tua organizzazione Google Cloud. External, stato di pubblicazione Testing Gli utenti di test che elenchi in Google, fino a 100. Google fa un'eccezione per le app che richiedono solo il nome, l'indirizzo email e il profilo dell'utente: in quel caso gli utenti non devono essere nell'elenco. Non fare affidamento sull'elenco degli utenti di test per tenere fuori le persone; usa le regole di accesso di Localtonet. External, stato di pubblicazione In production Chiunque abbia un account Google. Usa le regole di accesso di Localtonet per restringere la platea. La richiesta di accesso chiede gli scope
openid,emaileprofile. Se Google ti chiede di scegliere gli scope per l'app, questi tre bastano.Google indica che una modifica a un client può richiedere da 5 minuti a qualche ora per avere effetto.
-
Aggiungi il provider in Localtonet #
Apri I miei tunnel › HTTP e seleziona SSO in cima alla pagina. Nella finestra Provider SSO seleziona Aggiungi provider.
Campo Valore Nome del provider Un nome qualsiasi, ad esempio Company Google. Lo vedi nelle impostazioni del tunnel.Tipo di provider Google. Cambiare il tipo di un provider salvato svuota Client ID, quindi inserisci di nuovo il client ID e il client secret. Attivo Attivo Client ID Il client ID di Google. Client secret Il client secret di Google. Non viene più mostrato dopo il salvataggio. Sotto Endpoint e callback gli indirizzi standard di Google vengono compilati automaticamente. Lasciali così come sono:
Campo Valore compilato Endpoint di autorizzazione https://accounts.google.com/o/oauth2/v2/authEndpoint del token https://oauth2.googleapis.com/tokenEndpoint delle informazioni utente https://openidconnect.googleapis.com/v1/userinfoPercorso di callback /auth/callback/googleFacoltativamente compila Regole di accesso per email. Per ammettere solo la tua azienda, inserisci il suo dominio, ad esempio
example.com, sotto Domini email consentiti. Seleziona Salva provider. -
Attivalo per un tunnel #
Sotto I tuoi tunnel seleziona Impostazioni sul tunnel, poi Gestisci accanto a Provider SSO. Nella finestra Single sign-on attiva Richiedi l'accesso e l'interruttore del tuo provider Google. Seleziona Salva.
Gli elenchi sotto Chi può accedere e i Percorsi di accesso sono facoltativi. Sono spiegati nella panoramica.
-
Provalo #
Apri l'URL del tunnel in una finestra privata del browser. Localtonet mostra Sign in to continue con un pulsante per il tuo provider. Dopo l'accesso su Google, vieni rimandato al tunnel e il tuo servizio si carica.
Risoluzione dei problemi #
Google segnala redirect_uri_mismatch
L'URI di reindirizzamento nella richiesta non è tra gli Authorized redirect URIs del client. Aggiungi esattamente http://auth.localtonet.com/auth/callback al client in Google e attendi un po' perché la modifica abbia effetto.
La console di Google non accetta l'URI di reindirizzamento
Google verifica gli URI di reindirizzamento con le sue regole di validazione. Il messaggio accanto al campo indica la regola non rispettata.
Google rifiuta l'account, ad esempio con org_internal
Google ha rifiutato l'account prima che Localtonet lo vedesse. Con l'audience Internal possono accedere solo i membri della tua organizzazione, e Google segnala org_internal per tutti gli altri. Con External in Testing, controlla l'elenco degli utenti di test in Google.
Google segnala invalid_client
Google non accetta il client. Controlla il Client ID e il Client secret salvati in Localtonet e verifica che il client esista ancora in Google. Incolla di nuovo entrambi e seleziona Salva provider. Se non hai più il secret, creane uno nuovo in Google.
"403 - Access Denied" dopo un accesso Google riuscito
Una regola di Localtonet ha rifiutato l'account. Confronta l'indirizzo con cui il visitatore ha effettuato l'accesso con Domini email consentiti, Domini email bloccati e Indirizzi email bloccati del provider, e con Chi può accedere sul tunnel.
Nella pagina di accesso non c'è il pulsante Google
Il provider non è attivato per questo tunnel, oppure è impostato come inattivo. Controlla entrambe le cose.