Login único (SSO) com o GitHub
Exige Saldo Túneis HTTP
Nesta página 4 seções
Permita que os visitantes entrem com a conta do GitHub antes de poderem abrir um túnel HTTP. Você registra um aplicativo OAuth no GitHub, o adiciona ao Localtonet como provedor e depois o ativa no 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 do GitHub. Para registrar o aplicativo para uma organização, você precisa de acesso às configurações dessa organização.
Passos #
-
Registre um aplicativo OAuth no GitHub #
O guia do próprio GitHub é Creating an OAuth app (em inglês). Em resumo:
- No GitHub, abra o menu sob a sua foto de perfil e selecione Settings, depois Developer settings e depois OAuth apps.
- Selecione New OAuth App. Se você ainda não tem nenhum aplicativo, o botão se chama Register a new application.
- Preencha o formulário com os valores abaixo e selecione Register application.
- Na página do novo aplicativo, copie o Client ID, depois selecione Generate a new client secret e copie o segredo imediatamente.
Campo do GitHub Valor Application name Um nome que os seus visitantes reconheçam. O GitHub o mostra quando pede que eles autorizem. Homepage URL Um endereço web que descreva o aplicativo, por exemplo o seu site. Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow Deixe desativado. Você não seleciona escopos no GitHub. A requisição de login os informa:
read:usereuser:email. O GitHub pede que o visitante os aprove na primeira vez que ele entra. -
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 GitHub. Você o vê nas configurações do túnel.Tipo de provedor GitHub. Alterar o tipo de um provedor salvo esvazia o ID do cliente, então informe novamente o ID do cliente e a chave secreta do cliente. Ativo Ativado ID do cliente O Client ID do GitHub. Chave secreta do cliente O client secret do GitHub. Ele nunca é exibido depois de salvo. Em Endpoints e callback, os endereços padrão do GitHub são preenchidos automaticamente. Deixe-os como estão:
Campo Valor preenchido Endpoint de autorização https://github.com/login/oauth/authorizeEndpoint de token https://github.com/login/oauth/access_tokenEndpoint de informações do usuário https://api.github.com/userCaminho de callback /auth/callback/githubSe 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), ative Exigir login e a chave do seu provedor GitHub. Selecione Salvar.
Qualquer pessoa pode criar uma conta do GitHub. Sem uma regra, todo usuário do GitHub que conheça 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 GitHub pede que você autorize o aplicativo na primeira vez. Depois disso, você é enviado de volta ao túnel e o seu serviço é carregado.
Solução de problemas #
O GitHub informa uma divergência no URI de redirecionamento
O erro do GitHub é redirect_uri_mismatch: "The redirect_uri MUST match the registered callback URL for this application." Nenhum callback URL do aplicativo OAuth corresponde ao endereço enviado. Defina Authorization callback URL no GitHub exatamente como http://auth.localtonet.com/auth/callback.
Um visitante é recusado embora o endereço dele esteja na lista
O Endpoint de informações do usuário padrão, https://api.github.com/user, pode não retornar nenhum endereço de e-mail quando o usuário do GitHub não definiu um e-mail público no perfil. Peça ao visitante que verifique qual endereço está definido como e-mail público no perfil dele no GitHub e compare com as suas listas.
“403 - Access Denied” após um login bem-sucedido no GitHub
Uma regra do Localtonet recusou a conta. Confira 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.
O login falha antes ou depois da página de autorização do GitHub
Compare o ID do cliente e a Chave secreta do cliente salvos no Localtonet com os do aplicativo OAuth. Cole o Client ID novamente, gere um novo client secret no GitHub, cole-o no provedor e selecione Salvar provedor.
Não há botão do GitHub na página de login
O provedor não está ativado neste túnel ou está definido como inativo. Verifique os dois.