Single Sign-On con GitLab
Saldo necessario Tunnel HTTP
In questa pagina 4 sezioni
Consenti ai visitatori di accedere con il proprio account GitLab prima di poter aprire un tunnel HTTP. Funziona con GitLab.com e con un'istanza GitLab self-managed. Crei un'applicazione OAuth in GitLab, 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 GitLab su GitLab.com o sulla tua istanza.
- Per un'istanza self-managed: il suo indirizzo deve essere raggiungibile da internet. I browser dei tuoi visitatori aprono la sua pagina di accesso e l'host di accesso di Localtonet chiama direttamente i suoi endpoint del token e dell'utente.
Passaggi #
-
Crea un'applicazione OAuth in GitLab #
La guida di GitLab è Configure GitLab as an OAuth 2.0 authentication identity provider. Un'applicazione può appartenere a un utente, a un gruppo o all'intera istanza:
Proprietario Dove crearla Il tuo utente Seleziona il tuo avatar, poi Edit profile, poi Access › Applications e Add new application. Un gruppo Apri il gruppo, poi Settings › Applications. L'istanza (self-managed, solo amministratori) Admin › Applications e New application. Compila il modulo e seleziona Save application:
Campo di GitLab Valore Name Un nome che i tuoi visitatori riconoscono. GitLab lo mostra quando chiede loro di autorizzare. Redirect URI http://auth.localtonet.com/auth/callbackConfidential Lascialo selezionato. Scopes read_userGitLab mostra poi l'Application ID e il Secret. Copiali subito entrambi: GitLab mostra il secret solo subito dopo la creazione dell'applicazione.
Lo scope
read_userdà accesso in lettura al profilo dell'utente che ha effettuato l'accesso tramite l'endpoint/api/v4/user, che è l'Endpoint delle informazioni utente compilato da Localtonet. È l'unico scope richiesto dall'accesso, quindi l'applicazione non ha bisogno di altri scope. -
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, per esempio Company GitLab. Lo vedi nelle impostazioni del tunnel.Tipo di provider GitLab. Cambiare il tipo di un provider salvato svuota il Client ID, quindi inserisci di nuovo il client ID e il client secret. Attivo Attivato Client ID L'Application ID di GitLab. Client secret Il Secret di GitLab. Non viene mai mostrato dopo il salvataggio. Apri Endpoint e callback. Gli indirizzi di GitLab.com vengono compilati automaticamente. Per un'istanza self-managed, sostituisci
gitlab.comcon il nome host della tua istanza nei primi tre campi.GitLab.com
Campo Valore compilato Endpoint di autorizzazione https://gitlab.com/oauth/authorizeEndpoint del token https://gitlab.com/oauth/tokenEndpoint delle informazioni utente https://gitlab.com/api/v4/userPercorso di callback /auth/callback/gitlabSelf-managed
Campo Valore da inserire Endpoint di autorizzazione https://<YOUR_GITLAB_HOST>/oauth/authorizeEndpoint del token https://<YOUR_GITLAB_HOST>/oauth/tokenEndpoint delle informazioni utente https://<YOUR_GITLAB_HOST>/api/v4/userPercorso di callback /auth/callback/gitlab(invariato)Il Redirect URI nell'applicazione GitLab resta l'indirizzo Localtonet del passaggio 1. Non contiene il tuo host GitLab.
Se vuoi, compila le Regole di accesso per email, poi 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 GitLab. Seleziona Salva.
Su GitLab.com chiunque può creare un account. Senza una regola, ogni utente di GitLab.com 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 del browser privata. Localtonet mostra Sign in to continue con un pulsante per il tuo provider. La prima volta GitLab ti chiede di autorizzare l'applicazione. Dopodiché vieni rimandato al tunnel e il tuo servizio si carica.
Risoluzione dei problemi #
GitLab dice che il redirect URI incluso non è valido
Nessun Redirect URI dell'applicazione GitLab corrisponde all'indirizzo inviato. Inserisci esattamente http://auth.localtonet.com/auth/callback come Redirect URI dell'applicazione.
GitLab dice che lo scope richiesto non è valido, è sconosciuto o è malformato
Uno scope richiesto non è selezionato nell'applicazione GitLab. Modifica l'applicazione e seleziona read_user.
GitLab dice che l'autenticazione del client non è riuscita
Il Client ID o il Client secret salvato in Localtonet non corrisponde all'applicazione GitLab. Incolla di nuovo l'Application ID e il Secret e seleziona Salva provider. Se rinnovi il secret in GitLab, l'applicazione smette di funzionare finché non salvi il nuovo secret in Localtonet.
L'accesso con un'istanza self-managed non si completa mai
Controlla che i tre endpoint non contengano errori di battitura e assicurati che l'istanza risponda da internet. Se usa HTTPS, ha bisogno di un certificato di cui i client pubblici si fidano. Un'istanza raggiungibile solo all'interno della tua rete non può essere usata.
"403 - Access Denied" dopo un accesso a GitLab riuscito
Una regola di Localtonet ha rifiutato l'account. Controlla le Regole di accesso per email sul provider e Chi può accedere sul tunnel. Dopo aver corretto una regola, attendi un minuto e ricarica.
Non c'è alcun pulsante GitLab nella pagina di accesso
Il provider non è attivato per questo tunnel, oppure è impostato come inattivo. Controlla entrambe le cose.