Login único (SSO) com o GitLab
Exige saldo Túneis HTTP
Nesta página 4 seções
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 #
-
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ário Onde criar O seu usuário Selecione o seu avatar, depois Edit profile, depois Access › Applications e Add new application. Um grupo Abra 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 GitLab Valor Name Um nome que os seus visitantes reconheçam. O GitLab o mostra quando pede que eles autorizem. Redirect URI http://auth.localtonet.com/auth/callbackConfidential Deixe selecionado. Scopes read_userO 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_userdá 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. -
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.
Campo Valor Nome do provedor Qualquer nome, por exemplo Company GitLab. Você o vê nas configurações do túnel.Tipo de provedor GitLab. 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. Ativo Ligado ID do cliente O Application ID do GitLab. Chave secreta do cliente O 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.compelo nome de host da sua instância nos três primeiros campos.GitLab.com
Campo Valor preenchido Endpoint de autorização https://gitlab.com/oauth/authorizeEndpoint de token https://gitlab.com/oauth/tokenEndpoint de informações do usuário https://gitlab.com/api/v4/userCaminho de callback /auth/callback/gitlabAuto-hospedado
Campo Valor a informar Endpoint de autorização https://<YOUR_GITLAB_HOST>/oauth/authorizeEndpoint de token https://<YOUR_GITLAB_HOST>/oauth/tokenEndpoint de informações do usuário https://<YOUR_GITLAB_HOST>/api/v4/userCaminho 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.
-
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.
-
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.