Single Sign-On con GitHub
Saldo necessario Tunnel HTTP
In questa pagina 4 sezioni
Permetti ai visitatori di accedere con il loro account GitHub prima di poter aprire un tunnel HTTP. Registri un'app OAuth su GitHub, la aggiungi a Localtonet come provider, poi la attivi per il tunnel.
Prima di iniziare #
- Un tunnel HTTP e Saldo sul tuo account. Vedi la panoramica di Single Sign-On.
- Un account GitHub. Per registrare l'app per un'organizzazione, ti serve l'accesso alle impostazioni di quell'organizzazione.
Passaggi #
-
Registra un'app OAuth su GitHub #
La guida di GitHub è Creating an OAuth app. In breve:
- Su GitHub, apri il menu sotto la tua immagine del profilo e seleziona Settings, poi Developer settings, poi OAuth apps.
- Seleziona New OAuth App. Se non hai ancora un'app, il pulsante riporta Register a new application.
- Compila il modulo con i valori qui sotto e seleziona Register application.
- Nella pagina della nuova app, copia il Client ID, poi seleziona Generate a new client secret e copia subito il secret.
Campo di GitHub Valore Application name Un nome che i tuoi visitatori riconoscono. GitHub lo mostra quando chiede loro di autorizzare. Homepage URL Un indirizzo web che descrive l'app, ad esempio il tuo sito web. Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow Lascialo disattivato. Su GitHub non selezioni gli scope. Li indica la richiesta di accesso:
read:usereuser:email. GitHub chiede al visitatore di approvarli la prima volta che accede. -
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 GitHub. Lo vedi nelle impostazioni del tunnel.Tipo di provider GitHub. 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 GitHub. Client secret Il client secret di GitHub. Non viene mai mostrato dopo il salvataggio. In Endpoint e callback gli indirizzi standard di GitHub vengono compilati automaticamente. Lasciali così come sono:
Campo Valore precompilato Endpoint di autorizzazione https://github.com/login/oauth/authorizeEndpoint del token https://github.com/login/oauth/access_tokenEndpoint delle informazioni utente https://api.github.com/userPercorso di callback /auth/callback/githubSe vuoi, compila Regole di accesso per email, poi seleziona Salva provider.
-
Attivalo per un tunnel #
In 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 GitHub. Seleziona Salva.
Chiunque può creare un account GitHub. Senza una regola, ogni utente GitHub che conosce l'indirizzo può aprire il tunnel. Compila Chi può accedere sul tunnel, oppure Domini email consentiti sul provider. Gli elenchi 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. GitHub ti chiede di autorizzare l'app la prima volta. Dopodiché vieni reindirizzato al tunnel e il tuo servizio si carica.
Risoluzione dei problemi #
GitHub segnala una mancata corrispondenza del redirect URI
L'errore di GitHub è redirect_uri_mismatch: “The redirect_uri MUST match the registered callback URL for this application.” Nessun callback URL dell'app OAuth corrisponde all'indirizzo inviato. Imposta Authorization callback URL su GitHub esattamente su http://auth.localtonet.com/auth/callback.
Un visitatore viene rifiutato anche se il suo indirizzo è nell'elenco
L'Endpoint delle informazioni utente predefinito, https://api.github.com/user, può non restituire alcun indirizzo email quando l'utente GitHub non ha impostato un'email pubblica nel proprio profilo. Chiedi al visitatore di verificare quale indirizzo è impostato come email pubblica nel suo profilo GitHub e confrontalo con i tuoi elenchi.
“403 - Access Denied” dopo un accesso GitHub riuscito
Una regola di Localtonet ha rifiutato l'account. Controlla Regole di accesso per email sul provider e Chi può accedere sul tunnel. Dopo aver corretto una regola, attendi un minuto e ricarica.
L'accesso non riesce prima o dopo la pagina di autorizzazione di GitHub
Confronta il Client ID e il Client secret salvati in Localtonet con l'app OAuth. Incolla di nuovo il Client ID, genera un nuovo client secret su GitHub, incollalo nel provider e seleziona Salva provider.
Nella pagina di accesso non c'è il pulsante GitHub
Il provider non è attivato per questo tunnel, oppure è impostato come inattivo. Controlla entrambe le cose.