Ir para o conteúdo
Localtonet Localtonet Painel

Login único (SSO) com o GitLab

Exige saldo Túneis HTTP

Ajuda com esta página
Nesta página 4 seções
  1. Antes de começar
  2. Passos
  3. Crie um aplicativo OAuth no GitLab
  4. Adicione o provedor no Localtonet
  5. Ative para um túnel
  6. Teste
  7. Solução de problemas
  8. Páginas relacionadas

Deixe os visitantes entrarem com a conta GitLab antes de poderem abrir um túnel HTTP. Funciona com o GitLab.com e com uma instância GitLab auto-hospedada. Você cria um aplicativo OAuth no GitLab, o adiciona ao Localtonet como provedor e depois o ativa para o túnel.

Antes de começar #

  • Um túnel HTTP e saldo na sua conta. Veja a visão geral do Login único (SSO).
  • Uma conta GitLab no GitLab.com ou na sua própria instância.
  • Para uma instância auto-hospedada: o endereço dela precisa ser acessível pela internet. Os navegadores dos seus visitantes abrem a página de login dela, e o host de login do Localtonet chama diretamente os endpoints de token e de usuário dela.

Passos #

  1. Crie um aplicativo OAuth no GitLab #

    O guia do próprio GitLab é Configure GitLab as an OAuth 2.0 authentication identity provider. Um aplicativo pode pertencer a um usuário, a um grupo ou à instância inteira:

    ProprietárioOnde criar
    O seu usuárioSelecione o seu avatar, depois Edit profile, depois Access › Applications e Add new application.
    Um grupoAbra o grupo e depois Settings › Applications.
    A instância (auto-hospedada, somente administradores)Admin › Applications e New application.

    Preencha o formulário e selecione Save application:

    Campo do GitLabValor
    NameUm nome que os seus visitantes reconheçam. O GitLab o mostra quando pede que eles autorizem.
    Redirect URIhttp://auth.localtonet.com/auth/callback
    ConfidentialDeixe selecionado.
    Scopesread_user

    O GitLab então mostra o Application ID e o Secret. Copie os dois imediatamente: o GitLab mostra o secret somente logo depois que o aplicativo é criado.

    O escopo read_user dá acesso de leitura ao perfil do usuário conectado pelo endpoint /api/v4/user, que é o Endpoint de informações do usuário que o Localtonet preenche. É o único escopo que o login solicita, então o aplicativo não precisa de nenhum outro.

  2. Adicione o provedor no Localtonet #

    Abra Meus túneis › HTTP e selecione SSO no topo da página. Na caixa de diálogo Provedores SSO, selecione Adicionar provedor.

    CampoValor
    Nome do provedorQualquer nome, por exemplo Company GitLab. Você o vê nas configurações do túnel.
    Tipo de provedorGitLab. Mudar o tipo de um provedor salvo esvazia o ID do cliente, então informe de novo o ID do cliente e a chave secreta do cliente.
    AtivoLigado
    ID do clienteO Application ID do GitLab.
    Chave secreta do clienteO Secret do GitLab. Ele nunca é exibido depois de salvo.

    Abra Endpoints e callback. Os endereços do GitLab.com são preenchidos automaticamente. Para uma instância auto-hospedada, substitua gitlab.com pelo nome de host da sua instância nos três primeiros campos.

    GitLab.com

    CampoValor preenchido
    Endpoint de autorizaçãohttps://gitlab.com/oauth/authorize
    Endpoint de tokenhttps://gitlab.com/oauth/token
    Endpoint de informações do usuáriohttps://gitlab.com/api/v4/user
    Caminho de callback/auth/callback/gitlab

    Auto-hospedado

    CampoValor a informar
    Endpoint de autorizaçãohttps://<YOUR_GITLAB_HOST>/oauth/authorize
    Endpoint de tokenhttps://<YOUR_GITLAB_HOST>/oauth/token
    Endpoint de informações do usuáriohttps://<YOUR_GITLAB_HOST>/api/v4/user
    Caminho de callback/auth/callback/gitlab (sem alteração)

    O Redirect URI no aplicativo do GitLab continua sendo o endereço do Localtonet do passo 1. Ele não contém o host do seu GitLab.

    Se quiser, preencha as Regras de acesso por e-mail e depois selecione Salvar provedor.

  3. Ative para um túnel #

    Em Seus túneis, selecione Configurações no túnel e depois Gerenciar ao lado de Provedores SSO. Na caixa de diálogo Login único (SSO), ligue Exigir login e o interruptor do seu provedor GitLab. Selecione Salvar.

    No GitLab.com, qualquer pessoa pode criar uma conta. Sem uma regra, todo usuário do GitLab.com que souber o endereço pode abrir o túnel. Preencha Quem pode entrar no túnel, ou Domínios de e-mail permitidos no provedor. As listas são explicadas na visão geral.

  4. Teste #

    Abra a URL do túnel em uma janela privada do navegador. O Localtonet mostra Sign in to continue com um botão para o seu provedor. O GitLab pede que você autorize o aplicativo na primeira vez. Depois disso, você é enviado de volta ao túnel e o seu serviço carrega.

Solução de problemas #

O GitLab diz que o redirect URI incluído não é válido

Nenhum Redirect URI do aplicativo do GitLab corresponde ao endereço que foi enviado. Informe exatamente http://auth.localtonet.com/auth/callback como Redirect URI do aplicativo.

O GitLab diz que o escopo solicitado é inválido, desconhecido ou malformado

Um escopo que foi solicitado não está selecionado no aplicativo do GitLab. Edite o aplicativo e selecione read_user.

O GitLab diz que a autenticação do cliente falhou

O ID do cliente ou a Chave secreta do cliente salvos no Localtonet não correspondem ao aplicativo do GitLab. Cole de novo o Application ID e o Secret e selecione Salvar provedor. Se você renovar o secret no GitLab, o aplicativo deixa de funcionar até que você salve o novo secret no Localtonet.

O login com uma instância auto-hospedada nunca termina

Verifique se os três endpoints têm erros de digitação e se a instância responde pela internet. Se ela usa HTTPS, precisa de um certificado em que clientes públicos confiem. Uma instância acessível apenas dentro da sua rede não pode ser usada.

"403 - Access Denied" depois de um login bem-sucedido no GitLab

Uma regra do Localtonet recusou a conta. Verifique as Regras de acesso por e-mail no provedor e Quem pode entrar no túnel. Depois de corrigir uma regra, espere um minuto e recarregue.

Não há botão do GitLab na página de login

O provedor não está ativado para este túnel, ou está definido como inativo. Verifique os dois.

Suporte