Saltar al contenido principal

Añadir Azure AD como proveedor SAML

Esta guía explica cómo permitir que los usuarios inicien sesión en Casdoor con su cuenta de Azure AD (Microsoft Entra ID) mediante SAML.


Resultados del aprendizaje​

  • Crea una aplicación empresarial para Casdoor en Azure AD.
  • Añade Azure AD como proveedor SAML en Casdoor.
  • Asigna usuarios y prueba el inicio de sesión.

Requisitos​

  • Un inquilino de Azure AD con permisos para crear aplicaciones empresariales
  • Acceso de administrador a la consola de administración de Casdoor

Crear una aplicación empresarial​

  1. En el portal de Azure, ve a Azure Active Directory > Enterprise applications.
  2. Haz clic en New application > Create your own application.
  3. Introduce un nombre, por ejemplo Casdoor, selecciona Integrate any other application you don't find in the gallery (Non-gallery) y haz clic en Create.

Configurar el inicio de sesión único​

  1. En la aplicación empresarial, ve a Single sign-on y selecciona SAML.

  2. En Basic SAML Configuration, haz clic en Edit e introduce:

    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

    Azure AD envía la respuesta mediante HTTP POST, lo cual requiere el endpoint /api/acs.

  3. Haga clic en Save.

  4. Mantén los valores predeterminados de Attributes & Claims, o cámbialos:

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

    Si no se mapea ningún atributo de nombre de usuario, Casdoor utiliza la dirección de correo electrónico o el NameID de la aserción como nombre de usuario.

  5. Descarga el Federation Metadata XML desde la sección SAML Certificates. Alternativamente, toma nota del Certificate (Base64) y, en la sección Set up Casdoor, del Login URL, el Azure AD Identifier y el Logout URL.

Añadir el proveedor en Casdoor​

  1. En la consola de administración de Casdoor, ve a Identity > Providers y añade un proveedor.
  2. Establece Category en SAML y Type en Custom.
  3. Pega los metadatos de federación en Metadata y haz clic en Parse.
  4. Guarda el proveedor.
  5. Abre la página de edición de tu aplicación, añade el proveedor en la pestaña Providers y guarda.

Asignar usuarios​

En la aplicación empresarial en Azure AD, ve a Users and groups y asigna los usuarios o grupos que pueden iniciar sesión en Casdoor.

Verificar el resultado​

Abre la página de inicio de sesión de la aplicación y haz clic en el botón de Azure AD. También puedes probarlo desde Azure AD con el botón Test de la configuración de SAML.

Véase también​