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
- En el portal de Azure, ve a Azure Active Directory > Enterprise applications.
- Haz clic en New application > Create your own application.
- 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
-
En la aplicación empresarial, ve a Single sign-on y selecciona SAML.
-
En Basic SAML Configuration, haz clic en Edit e introduce:
Field Value Identifier (Entity ID) https://<your-casdoor-domain>/api/acs, for examplehttps://door.example.com/api/acsReply URL (Assertion Consumer Service URL) The same URL Azure AD envía la respuesta mediante HTTP POST, lo cual requiere el endpoint
/api/acs. -
Haga clic en Save.
-
Mantén los valores predeterminados de Attributes & Claims, o cámbialos:
Claim Default source Unique User Identifier user.userprincipalnameemailaddress user.mailname user.userprincipalnameSi 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.
-
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
- En la consola de administración de Casdoor, ve a Identity > Providers y añade un proveedor.
- Establece Category en
SAMLy Type enCustom. - Pega los metadatos de federación en Metadata y haz clic en Parse.
- Guarda el proveedor.
- 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.