Pular para o conteúdo principal

Adicionar Azure AD como um provedor SAML

Este guia explica como permitir que os usuários façam login no Casdoor com suas contas do Azure AD (Microsoft Entra ID) via SAML.


Resultados de aprendizagem​

  • Crie uma aplicação empresarial para o Casdoor no Azure AD.
  • Adicione o Azure AD como um provedor SAML no Casdoor.
  • Atribua usuários e teste o login.

O que você precisa​

  • Um tenant do Azure AD com permissões para criar aplicações empresariais
  • Acesso de administrador ao console de administração do Casdoor

Criar uma aplicação empresarial​

  1. No portal do Azure, acesse Azure Active Directory > Enterprise applications.
  2. Clique em New application > Create your own application.
  3. Insira um nome, por exemplo Casdoor, selecione Integrate any other application you don't find in the gallery (Non-gallery) e clique em Create.

Configurar o single sign-on​

  1. Na aplicação empresarial, acesse Single sign-on e selecione SAML.

  2. Em Basic SAML Configuration, clique em Edit e insira:

    FieldValue
    Identifier (Entity ID)https://<your-casdoor-domain>/api/acs, for example https://door.example.com/api/acs
    Reply URL (Assertion Consumer Service URL)The same URL

    O Azure AD envia a resposta via HTTP POST, requisito do endpoint /api/acs.

  3. Clique em Save.

  4. Mantenha os padrões de Attributes & Claims ou altere-os:

    ClaimDefault source
    Unique User Identifieruser.userprincipalname
    emailaddressuser.mail
    nameuser.userprincipalname

    Se nenhum atributo de nome de usuário estiver mapeado, o Casdoor usará o endereço de e-mail ou o NameID da asserção como nome de usuário.

  5. Baixe o Federation Metadata XML da seção SAML Certificates. Alternativamente, anote o Certificate (Base64) e, na seção Set up Casdoor, o Login URL, o Azure AD Identifier e o Logout URL.

Adicionar o provedor no Casdoor​

  1. No console de administração do Casdoor, acesse Identity > Providers e adicione um provedor.
  2. Defina Category como SAML e Type como Custom.
  3. Cole os metadados de federação em Metadata e clique em Parse.
  4. Salve o provedor.
  5. Abra a página de edição da sua aplicação, adicione o provedor na aba Providers e salve.

Atribuir usuários​

Na aplicação empresarial no Azure AD, acesse Users and groups e atribua os usuários ou grupos que podem fazer login no Casdoor.

Verificar o resultado​

Abra a página de login da aplicação e clique no botão do Azure AD. Você também pode testar pelo Azure AD usando o botão Test da configuração SAML.

Consulte também​