Ir para o conteúdo
Localtonet Localtonet Painel

Login único (SSO) com o GitHub

Exige Saldo Túneis HTTP

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

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 #

  1. Registre um aplicativo OAuth no GitHub #

    O guia do próprio GitHub é Creating an OAuth app (em inglês). Em resumo:

    1. No GitHub, abra o menu sob a sua foto de perfil e selecione Settings, depois Developer settings e depois OAuth apps.
    2. Selecione New OAuth App. Se você ainda não tem nenhum aplicativo, o botão se chama Register a new application.
    3. Preencha o formulário com os valores abaixo e selecione Register application.
    4. Na página do novo aplicativo, copie o Client ID, depois selecione Generate a new client secret e copie o segredo imediatamente.
    Campo do GitHubValor
    Application nameUm nome que os seus visitantes reconheçam. O GitHub o mostra quando pede que eles autorizem.
    Homepage URLUm endereço web que descreva o aplicativo, por exemplo o seu site.
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device FlowDeixe desativado.

    Você não seleciona escopos no GitHub. A requisição de login os informa: read:user e user:email. O GitHub pede que o visitante os aprove na primeira vez que ele entra.

  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 GitHub. Você o vê nas configurações do túnel.
    Tipo de provedorGitHub. 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.
    AtivoAtivado
    ID do clienteO Client ID do GitHub.
    Chave secreta do clienteO 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:

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

    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), 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.

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

Suporte