Vai al contenuto
Localtonet Localtonet Dashboard

Single Sign-On con GitHub

Saldo necessario Tunnel HTTP

Aiuto su questa pagina
In questa pagina 4 sezioni
  1. Prima di iniziare
  2. Passaggi
  3. Registra un'app OAuth su GitHub
  4. Aggiungi il provider in Localtonet
  5. Attivalo per un tunnel
  6. Provalo
  7. Risoluzione dei problemi
  8. Pagine correlate

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 #

  1. Registra un'app OAuth su GitHub #

    La guida di GitHub è Creating an OAuth app. In breve:

    1. Su GitHub, apri il menu sotto la tua immagine del profilo e seleziona Settings, poi Developer settings, poi OAuth apps.
    2. Seleziona New OAuth App. Se non hai ancora un'app, il pulsante riporta Register a new application.
    3. Compila il modulo con i valori qui sotto e seleziona Register application.
    4. Nella pagina della nuova app, copia il Client ID, poi seleziona Generate a new client secret e copia subito il secret.
    Campo di GitHubValore
    Application nameUn nome che i tuoi visitatori riconoscono. GitHub lo mostra quando chiede loro di autorizzare.
    Homepage URLUn indirizzo web che descrive l'app, ad esempio il tuo sito web.
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device FlowLascialo disattivato.

    Su GitHub non selezioni gli scope. Li indica la richiesta di accesso: read:user e user:email. GitHub chiede al visitatore di approvarli la prima volta che accede.

  2. Aggiungi il provider in Localtonet #

    Apri I miei tunnel › HTTP e seleziona SSO in cima alla pagina. Nella finestra Provider SSO, seleziona Aggiungi provider.

    CampoValore
    Nome del providerUn nome qualsiasi, ad esempio GitHub. Lo vedi nelle impostazioni del tunnel.
    Tipo di providerGitHub. Cambiare il tipo di un provider salvato svuota Client ID, quindi inserisci di nuovo il client ID e il client secret.
    AttivoAttivo
    Client IDIl client ID di GitHub.
    Client secretIl 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:

    CampoValore precompilato
    Endpoint di autorizzazionehttps://github.com/login/oauth/authorize
    Endpoint del tokenhttps://github.com/login/oauth/access_token
    Endpoint delle informazioni utentehttps://api.github.com/user
    Percorso di callback/auth/callback/github

    Se vuoi, compila Regole di accesso per email, poi seleziona Salva provider.

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

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

Supporto