A integração perfeita entre o Auth0 e o Azure Active Directory (AD) é crucial para permitir que usuários, tanto de dentro quanto de fora da sua empresa, acessem sua aplicação de forma segura. Este guia detalhado apresentará passo a passo como realizar essa integração de maneira eficiente.
Registrar sua Aplicação no Azure AD
-
Acesse o portal Azure e registre sua aplicação, obtendo o Application (client) ID na tela de Overview.
-
Crie um segredo de cliente para autenticação, garantindo que tenha anotado o valor gerado. Caso seja configurado para expirar, atente-se à data de renovação.
-
Adicione as permissões necessárias, como User.Read e Directory.Read.All, para garantir que sua aplicação possa acessar dados relevantes.
Configurar a Conexão no Auth0
-
No painel Auth0, vá para Authentication > Enterprise e selecione Microsoft Azure AD. Clique em '+' para criar uma nova conexão.
-
Preencha os detalhes, incluindo Connection name, Microsoft Azure AD Domain, Client ID e Client Secret obtidos durante o registro no Azure AD.
-
Opte por usar o common endpoint se desejar aceitar usuários de diretórios novos dinamicamente.
-
Configure as permissões, escolhendo quais atributos básicos e estendidos deseja acessar no perfil do usuário.
-
Selecione a opção para sincronizar automaticamente os atributos do perfil a cada login para manter os dados atualizados.
-
Na seção Login Experience, defina os detalhes de como os usuários podem se autenticar.
-
Caso tenha permissões administrativas no Azure AD, prossiga e dê consentimento à aplicação.
Habilitar a Conexão no Auth0 Application
Para utilizar a nova conexão Azure AD, ative-a para suas aplicações no Auth0.
Testar a Conexão
Certifique-se de que tudo está configurado corretamente testando a conexão entre o Auth0 e o Azure AD.
Solução de Problemas Comuns
-
Se não visualizar sua aplicação no Azure AD, verifique se está no diretório correto durante o registro.
-
Caso enfrente o erro "Access cannot be granted," ajuste as configurações de Supported account types no Azure AD.
-
Para resolver problemas de acesso inválido, certifique-se de que o segredo do cliente no Azure AD está válido e atualizado na conexão do Auth0.
Rollover de Chave de Assinatura no Azure AD
Entenda que as chaves de assinatura no Azure AD rolam periodicamente por razões de segurança. Não é necessário intervir, pois o Auth0 fará a transição automaticamente.
Remover o Rótulo Não Verificado
Se estiver usando um domínio personalizado, siga os passos para verificar e atribuir o domínio verificado à sua aplicação Auth0 no Azure AD.
Próximos Passos
Siga adiante integrando seu aplicativo com o Auth0 utilizando as bibliotecas fornecidas, explore a API de Autenticação do Auth0 e aprimore a experiência do usuário ajustando parâmetros adicionais conforme necessário.
Com este guia detalhado, você está pronto para realizar uma integração perfeita entre o Auth0 e o Azure AD, garantindo uma autenticação eficiente e segura para seus usuários.