Configurando SSO SAML com Microsoft Azure AD ou Entra ID

🎯 Objetivo

Aprenda a configurar a integração de SSO via SAML entre o netLex e o Microsoft Azure AD. Essa integração permite que seus usuários acessem o netLex com as credenciais da Microsoft, garantindo segurança, praticidade e gestão centralizada de acessos. 🚀

Este artigo contém as seções:

• O que é a funcionalidade?
• Como configurar o SSO com Azure AD
• Testando o SSO
• Tour guiado
• Dúvidas frequentes
  
  

💡 O que é a funcionalidade?

Com a integração de SSO via SAML entre o netLex e o Azure AD, seus usuários podem acessar o netLex utilizando as mesmas credenciais corporativas que já utilizam para outros serviços Microsoft.

Isso melhora a experiência de login e aumenta a segurança da sua organização, com autenticação centralizada e controle total dos acessos pelo administrador do Azure. 🔐

🛠️ Como configurar o SSO com Azure AD

Siga o passo a passo abaixo para realizar a configuração:

6. No netLex, acesse Configurações > Single Sign-On.
   Atenção: é necessário ter o perfil de admin no netLex para realizar esta configuração.
7. Habilite a opção SAML.
   
   
   
   
8. Clique em "Obter Metadados SAML" ou copie o link abaixo (substituindo <dominio-netlex-empresa> pelo domínio da sua empresa no netLex) e acesse-o para baixar os metadados do netLex:
   

   https://<dominio-netlex-empresa>/api/auth/saml-sp-metadata

9. Salve o arquivo como .xml em sua máquina, clicando com o botão direito do mouse > "Salvar como".
10. Agora, acesse o Azure/Microsoft Entra com um perfil de administrador.
11. Acesse Azure Active Directory > Application/Aplicativos > Enterprise Application/Aplicativos empresariais.
    
    
    
12. Crie um novo aplicativo personalizado clicando em + Novo aplicativo > Criar seu próprio aplicativo.
13. Dê um nome para a aplicação e selecione a opção Integrar qualquer outro aplicativo que não esteja na galeria (sem galeria).
    
    
14. Clique em "Criar".
15. Após a criação, vá até a seção Single sign-on/Configurar logon único.
    
    
    
    
16. Escolha o método SAML e selecione Carregar arquivo de metadados.
17. Importe o arquivo de metadados do netLex que você baixou anteriormente.
18. Clique em "Adicionar" e, depois, em "Salvar".
    
    
    
    
19. Dentro das informações "Certificados SAML", copie o link da URL de metadados de federação de aplicativos.
    
    
    
    
20. Cole o link da URL de metadados de federação de aplicativos em outra aba do seu navegador.
21. Copie o link dentro do "Entity ID" nos metadados e cole ele em "Entity ID" no netLex.
    
    
    
    
    
    
22. Copie o link dentro de "Location" nos metadados e cole ele em "URL do serviço de single sign-on" no netLex.
23. Copie o certificado dentro de "Certificate" entre <> nos metadados e cole ele em "Certificado da Entidade" no netLex.
    
    
    
    
24. Aperte "ctrl + f" para buscar "/displayname", copie o link e cole em "Atributo de nome" no netLex.
    
    
    
    
    
    
25. Aperte "ctrl + f" para buscar "/email", copie o link e cole em "Atributo de login" no netLex.
26. Salve as configurações no netLex.

💡 Dica: Caso você utilize o netLex em ambientes separados (Homologação e Produção), recomendamos criar aplicações distintas no Azure AD, com nomes que identifiquem o ambiente.

✅ Testando o SSO

Com as configurações salvas no netLex e a aplicação configurada no Azure AD:

• Abra uma janela anônima e acesse sua URL do netLex.
• Você será redirecionado para a tela de login via Microsoft.
• Faça login com suas credenciais da empresa.

Se tudo estiver certo, você será autenticado com sucesso! 🎉

🎥 Tour guiado

Confira o passo a passo completo nesse tour interativo:

❓ Dúvidas frequentes

• É obrigatório restringir o acesso por grupo?
  Não. Você pode liberar o acesso para todos os usuários ou limitar a um grupo específico, conforme a política da empresa.

• Ao configurar o SSO no ambiente de homologação, ele também se aplica ao ambiente de produção?
  Não. O passo a passo é o mesmo, mas ele precisa ser realizado separadamente. Um app para o ambiente de homologação e outro para o ambiente de produção.
  
  
• O botão de login com Microsoft não aparece. E agora?
  Verifique se o SSO está ativado no netLex, se os atributos estão corretos e se o app está liberado para seu grupo de usuários no Azure.