Login único para túneis HTTP
Requer saldo Túneis HTTP
Nesta página 10 seções
O login único (SSO) coloca uma página de login na frente de um túnel HTTP. Antes que qualquer requisição chegue ao seu serviço, os visitantes entram com um provedor de identidade que você escolhe, como Google, GitHub, Microsoft ou GitLab, ou com um usuário e uma senha que você define.
Quando usar #
Enquanto não for protegido, um túnel HTTP fica aberto a qualquer pessoa que tenha o endereço dele. O SSO é a proteção certa quando as pessoas abrem o túnel em um navegador e você quer decidir quem elas são: um painel de administração, um dashboard, uma ferramenta interna, um site de staging. Seu serviço não muda e nunca vê uma senha.
O SSO foi feito para navegadores. Uma requisição que não traz o cookie de login é redirecionada para a página de login, então scripts, webhooks e clientes de API não conseguem passar. Para esses casos, proteja apenas alguns caminhos (veja Caminhos de login) ou use as opções de Controle de acesso.
Como funciona #
- Um visitante abre a URL do túnel. Uma requisição por HTTP é redirecionada primeiro para HTTPS.
- O visitante ainda não fez login, então o servidor Localtonet redireciona o navegador para a página de login em
auth.localtonet.com. A página tem o título Sign in to continue e oferece os provedores que você ativou para este túnel. - O visitante escolhe um provedor e entra por ele. Para um provedor de usuário e senha, o formulário fica na própria página de login.
- O Localtonet verifica as suas regras de acesso e envia o visitante de volta ao endereço que ele pediu. O login fica guardado em um cookie para o nome de host do túnel. É um cookie de sessão do navegador, enviado somente por HTTPS.
- A partir daí, as requisições são encaminhadas ao seu serviço normalmente. Quando o login deixa de ser válido, o visitante é enviado novamente à página de login.
Um visitante que faz login, mas não é permitido pelas suas regras, vê 403 - Access Denied com o texto "You do not have permission to access this tunnel."
Os caminhos sob /.well-known nunca ficam atrás do login.
Antes de começar #
- Um túnel HTTP. Veja HTTP / HTTPS.
- Saldo na sua conta. Sem ele, salvar um provedor ou ativar o login falha com "Você precisa comprar saldo para usar este recurso." Veja Planos e Saldo e Preços.
- Para um provedor externo: uma conta nele que permita registrar um aplicativo OAuth.
O SSO é configurado no seu painel pessoal. O botão SSO e a configuração Provedores SSO não aparecem para túneis de equipe.
Provedores #
Estes guias cobrem as escolhas mais comuns, passo a passo:
A lista Tipo de provedor no painel contém: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon e Yahoo. Para todos os tipos, exceto Username-Password e Custom, os endpoints são preenchidos para você. Para OpenID Connect, os endereços preenchidos são exemplos que você substitui pelos endpoints do seu provedor.
Configure #
São duas partes. Você adiciona um provedor uma vez, e ele fica disponível para todos os seus túneis HTTP. Depois, você o ativa em cada túnel que quiser proteger. Um provedor salvo não protege nada até que um túnel o use.
-
Adicione um provedor #
Abra Meus túneis › HTTP e selecione SSO no alto da página (a dica dele diz Configurações do provedor SSO). A caixa de diálogo Provedores SSO abre. Selecione Adicionar provedor, preencha o formulário e selecione Salvar provedor. Cada provedor é salvo separadamente.
Campo O que é Observações Nome do provedor Um nome para identificar este provedor nas configurações do seu túnel. Obrigatório. Por exemplo, Company Google.Tipo de provedor O método de login. Um provedor novo começa como Google. Alterar o tipo de um provedor salvo esvazia o ID do cliente, então digite novamente o ID do cliente e a chave secreta do cliente. Ativo Torna o provedor disponível para os túneis. Quando você muda um provedor para inativo e salva, ele também é desativado em todos os túneis que o usavam. ID do cliente O ID do aplicativo que você registrou no provedor. Obrigatório para todos os tipos, exceto Username-Password e Custom. Chave secreta do cliente A chave secreta desse aplicativo. Nunca é exibida depois de salva. Deixe em branco depois para manter a chave salva. Endpoints e callback Endpoint de autorização, Endpoint de token, Endpoint de informações do usuário e Caminho de callback. Preenchidos automaticamente para os provedores padrão. Altere-os somente quando um guia disser para fazer isso. Regras de acesso por e-mail Domínios de e-mail permitidos, Domínios de e-mail bloqueados e Endereços de e-mail bloqueados. Opcional. Veja Regras de acesso. Usuários de login Nomes de usuário e senhas. Somente para os tipos Username-Password e Custom. Para remover um provedor, selecione Excluir provedor. Isso o remove da sua conta e das configurações de SSO dos seus túneis.
-
Ative para um túnel #
Em Seus túneis, selecione Configurações no túnel. No painel Configurações do túnel, encontre Provedores SSO e selecione Gerenciar. A caixa de diálogo Login único (SSO) abre.
Configuração O que faz Exigir login Ativa o SSO neste túnel. Os visitantes que não fizeram login são enviados primeiro à página de login. Provedores Uma chave para cada um dos seus provedores ativos. Ative pelo menos um. Se vários estiverem ativados, o visitante escolhe na página de login. Quem pode entrar Listas opcionais de Endereços de e-mail, Domínios de e-mail e Nomes de usuário para este túnel. Caminhos de login e logout Caminhos de login e um Caminho de logout, ambos opcionais. Selecione Salvar.
-
Teste #
Abra a URL do túnel em uma janela privada do navegador. Você deve chegar à página Sign in to continue e, depois de entrar, ao seu serviço.
O URI de redirecionamento #
Um provedor externo pergunta para onde pode enviar as pessoas depois que elas entram. Para todo túnel, esse é um endereço no host de login do Localtonet, não o endereço do seu túnel. Registre exatamente este valor:
http://auth.localtonet.com/auth/callbackCada guia de provedor diz onde digitá-lo.
| Valor | Onde vai |
|---|---|
| O URI de redirecionamento acima | No provedor: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab). |
Caminho de callback, por exemplo /auth/callback/google | No Localtonet, em Endpoints e callback. Ele é preenchido para você. Deixe como está. |
O provedor compara o URI de redirecionamento com o valor registrado de forma exata, então copie-o como aparece aqui.
Regras de acesso #
Entrar prova quem é o visitante. As regras decidem se essa pessoa pode abrir o túnel. Há dois níveis, e os dois valem.
| Onde | Lista | O que o painel diz |
|---|---|---|
| Provedor | Domínios de e-mail permitidos | Deixe em branco para não restringir por domínio. Os curingas dependem do provedor. |
| Provedor | Domínios de e-mail bloqueados | Bloqueia logins desses domínios de e-mail. |
| Provedor | Endereços de e-mail bloqueados | Bloqueia estes endereços de e-mail individuais. |
| Túnel | Endereços de e-mail, Domínios de e-mail, Nomes de usuário | Deixe uma lista vazia para ignorar essa verificação. As listas valem para todos os provedores ativados no túnel. |
Digite um item por linha ou separe os itens com vírgulas. Um domínio é digitado sem @, por exemplo example.com.
Depois que você altera uma regra, um visitante que já havia entrado pode manter o acesso por até cinco minutos. Um visitante que foi recusado é verificado de novo após um minuto.
Caminhos de login e caminho de logout #
| Configuração | Comportamento | Exemplo |
|---|---|---|
| Caminhos de login | Vazio: todos os caminhos do túnel exigem login. Preenchido: somente as requisições cujo caminho começa com uma das entradas exigem login. | /admin cobre /admin e /admin/users, mas não /administrator. |
| Caminho de logout | Abri-lo remove o login deste túnel e envia o visitante à página inicial do túnel, ou ao endereço indicado em um valor de consulta returnUrl. | /sso/logout |
Os caminhos começam com uma barra. Maiúsculas e minúsculas não fazem diferença.
Uma lista de Caminhos de login preenchida deixa todo o resto aberto. Com /admin na lista, somente /admin é protegido e todos os outros caminhos ficam acessíveis sem login. Deixe a lista vazia para proteger o túnel inteiro.
O caminho de logout encerra a sessão do visitante apenas no túnel. Ele não encerra a sessão no Google, no GitHub nem em outro provedor de identidade.
Solução de problemas #
"Você precisa comprar saldo para usar este recurso."
O SSO exige saldo. Adicione saldo e salve de novo. Sem saldo, você ainda pode abrir a caixa de diálogo e desativar Exigir login.
"Adicione um provedor antes de ativar o login."
Você ainda não tem nenhum provedor ativo. Selecione Adicionar um provedor na caixa de diálogo ou use o botão SSO no alto da página HTTP.
"Ative pelo menos um provedor ou desative o login."
Exigir login está ativado, mas nenhuma chave de provedor está ligada. Um provedor que você define como inativo é desativado nos túneis dele e deixa de aparecer na lista.
A página de login diz "No authentication providers are currently configured for this tunnel."
O login é obrigatório, mas nenhum provedor está ativado neste túnel. Abra Provedores SSO › Gerenciar no túnel e ative um.
O túnel abre sem pedir login
Verifique se Exigir login está ativado e salvo. Se Caminhos de login estiver preenchido, somente esses caminhos são protegidos. Teste também em uma janela privada: o seu próprio navegador pode ainda estar com a sessão iniciada.
"403 - Access Denied" depois de entrar
O login funcionou, mas uma regra recusou a conta. Verifique as Regras de acesso por e-mail do provedor e as listas de Quem pode entrar do túnel. Depois de corrigir uma regra, aguarde um minuto e recarregue.
Um webhook ou cliente de API recebe um redirecionamento em vez de uma resposta
As requisições sem o cookie de login são redirecionadas para a página de login. Coloque em Caminhos de login apenas as páginas feitas para pessoas, ou use um túnel separado para o tráfego de máquinas.
Automação #
Os provedores e as configurações de SSO dos túneis também podem ser gerenciados pela API, em /api/v2/sso-providers, e pelo servidor MCP.