Ir para o conteúdo
Localtonet Localtonet Painel

Login único (SSO) com a Microsoft

Exige Saldo Túneis HTTP

Ajuda com esta página
Nesta página 6 seções
  1. Antes de começar
  2. Passos
  3. Registre um aplicativo no Microsoft Entra
  4. Adicione o provedor no Localtonet
  5. Ative para um túnel
  6. Teste
  7. Tipos de conta e endpoints
  8. O que o Localtonet lê da Microsoft
  9. Solução de problemas
  10. Páginas relacionadas

Permita que os visitantes entrem com uma conta corporativa ou de estudante do Microsoft Entra ID, ou com uma conta pessoal da Microsoft, antes de poderem abrir um túnel HTTP. Você registra um aplicativo no Microsoft Entra, o adiciona ao Localtonet como provedor e depois o ativa no túnel.

Antes de começar #

Passos #

  1. Registre um aplicativo no Microsoft Entra #

    Os guias da própria Microsoft são Register an app in Microsoft Entra ID, Add a redirect URI e Add app credentials (em inglês). Em resumo:

    1. No centro de administração do Microsoft Entra, vá para Entra ID › App registrations e selecione New registration.
    2. Informe um Name. Os visitantes o veem quando entram.
    3. Em Supported account types, escolha quem pode usar o aplicativo e depois selecione Register.
    4. Na página Overview, copie o Application (client) ID. Para um aplicativo de locatário único, copie também o Directory (tenant) ID.
    5. Em Manage, abra Authentication, selecione Add Redirect URI, escolha a plataforma Web, informe o URI de redirecionamento abaixo e selecione Configure.
    6. Abra Certificates & secrets › Client secrets e selecione New client secret. Adicione uma descrição, escolha uma expiração e selecione Add. Copie o Value do segredo imediatamente: a Microsoft nunca o exibe novamente depois que você sai da página.
    URI de redirecionamento (plataforma: Web)
    http://auth.localtonet.com/auth/callback

    Um segredo do cliente expira. A Microsoft limita a vida útil dele a 24 meses. Quando ele expira, o login deixa de funcionar até que você crie um novo segredo e o salve no provedor do Localtonet.

  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 Microsoft. Você o vê nas configurações do túnel.
    Tipo de provedorMicrosoft. 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 Application (client) ID do Microsoft Entra.
    Chave secreta do clienteO Value do segredo, não o Secret ID. Ele nunca é exibido depois de salvo.

    Abra Endpoints e callback. Estes valores são preenchidos automaticamente:

    CampoValor preenchidoAlterar?
    Endpoint de autorizaçãohttps://login.microsoftonline.com/common/oauth2/v2.0/authorizeSubstitua common conforme a tabela da próxima seção.
    Endpoint de tokenhttps://login.microsoftonline.com/common/oauth2/v2.0/tokenSubstitua common pelo mesmo valor acima.
    Endpoint de informações do usuáriohttps://graph.microsoft.com/oidc/userinfoNão. Ele não contém locatário.
    Caminho de callback/auth/callback/microsoftNão.

    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 Microsoft. Selecione Salvar.

    As listas em Quem pode entrar e os Caminhos de login são opcionais. Elas 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. Depois de entrar na Microsoft, você é enviado de volta ao túnel e o seu serviço é carregado.

Tipos de conta e endpoints #

A parte do endereço da Microsoft depois de login.microsoftonline.com/ controla quem pode entrar. Ela deve corresponder aos Supported account types do seu aplicativo. O Endpoint de autorização e o Endpoint de token sempre recebem o mesmo valor. O Endpoint de informações do usuário nunca muda.

Supported account types no Microsoft EntraUse no lugar de commonQuem pode entrar
Single tenant onlyO seu Directory (tenant) IDUsuários e convidados do seu próprio locatário.
Multiple Entra ID tenantsorganizationsContas corporativas ou de estudante de qualquer organização.
Any Entra ID Tenant + Personal Microsoft accountsMantenha commonContas corporativas ou de estudante e contas pessoais da Microsoft.
Personal accounts onlyconsumersContas pessoais da Microsoft.

Exemplo para um aplicativo de locatário único. Substitua <TENANT_ID> pelo seu Directory (tenant) ID:

Locatário único
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint:         https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint:     https://graph.microsoft.com/oidc/userinfo

Um aplicativo de locatário único não funciona com common. A Microsoft responde com o erro AADSTS50194. Coloque o ID do seu locatário nos dois endpoints ou mude o aplicativo para um tipo de conta multilocatário.

Com um tipo de conta multilocatário ou pessoal, pessoas de fora da sua organização podem entrar na Microsoft. Use Domínios de e-mail permitidos no provedor, ou Quem pode entrar no túnel, para admitir apenas as pessoas que você quiser.

O que o Localtonet lê da Microsoft #

O endpoint de informações do usuário da Microsoft só retorna um endereço de e-mail quando há um associado à conta, então uma conta sem endereço de e-mail pode não passar em regras que se baseiam em e-mail.

Solução de problemas #

AADSTS50011: the reply URL does not match

O URI de redirecionamento da requisição não está registrado para o aplicativo. A mensagem mostra o endereço que foi enviado. Ele deve ser idêntico a um URI de redirecionamento na página Authentication do registro do aplicativo, na plataforma Web, inclusive em maiúsculas e minúsculas. Registre exatamente http://auth.localtonet.com/auth/callback.

AADSTS50194: the application is not configured as a multitenant application

O aplicativo é de locatário único, mas os endpoints ainda contêm common. Substitua common pelo seu Directory (tenant) ID no Endpoint de autorização e no Endpoint de token e selecione Salvar provedor.

AADSTS700016: the application was not found in the directory

O ID do cliente está errado, ou os endpoints apontam para um locatário em que o aplicativo não existe. Confira o Application (client) ID e o ID do locatário nos endpoints.

AADSTS7000215 ou AADSTS7000222: segredo do cliente inválido ou expirado

Crie um novo segredo do cliente em Certificates & secrets, cole o Value dele em Chave secreta do cliente no Localtonet e selecione Salvar provedor.

A Microsoft pede aprovação do administrador

O seu locatário não permite que os usuários consintam com aplicativos por conta própria. Um administrador do locatário precisa conceder o consentimento ao aplicativo no centro de administração do Microsoft Entra.

“403 - Access Denied” após um login bem-sucedido na Microsoft

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

Suporte