Vai al contenuto
Localtonet Localtonet Dashboard

Single Sign-On con GitLab

Saldo necessario Tunnel HTTP

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

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 #

  1. 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:

    ProprietarioDove crearla
    Il tuo utenteSeleziona il tuo avatar, poi Edit profile, poi Access › Applications e Add new application.
    Un gruppoApri 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 GitLabValore
    NameUn nome che i tuoi visitatori riconoscono. GitLab lo mostra quando chiede loro di autorizzare.
    Redirect URIhttp://auth.localtonet.com/auth/callback
    ConfidentialLascialo selezionato.
    Scopesread_user

    GitLab 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_user dà 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.

  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, per esempio Company GitLab. Lo vedi nelle impostazioni del tunnel.
    Tipo di providerGitLab. Cambiare il tipo di un provider salvato svuota il Client ID, quindi inserisci di nuovo il client ID e il client secret.
    AttivoAttivato
    Client IDL'Application ID di GitLab.
    Client secretIl 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.com con il nome host della tua istanza nei primi tre campi.

    GitLab.com

    CampoValore compilato
    Endpoint di autorizzazionehttps://gitlab.com/oauth/authorize
    Endpoint del tokenhttps://gitlab.com/oauth/token
    Endpoint delle informazioni utentehttps://gitlab.com/api/v4/user
    Percorso di callback/auth/callback/gitlab

    Self-managed

    CampoValore da inserire
    Endpoint di autorizzazionehttps://<YOUR_GITLAB_HOST>/oauth/authorize
    Endpoint del tokenhttps://<YOUR_GITLAB_HOST>/oauth/token
    Endpoint delle informazioni utentehttps://<YOUR_GITLAB_HOST>/api/v4/user
    Percorso 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.

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

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

Supporto