Microsoft Azure
Este documento describe cómo usar Microsoft Azure (Microsoft Entra ID) como proveedor de identidades para configurar el inicio de sesión único SAML en EngageLab. Sígalo junto con el proceso de cuatro pasos de Configuración de SSO: este documento corresponde a «Paso 1: configurar EngageLab en el IdP» y «Paso 2: introducir la información devuelta por el IdP».
Requisitos previos
- Disponer de permisos de administrador de Microsoft Entra ID en Microsoft Azure (poder crear aplicaciones empresariales).
- Disponer de una cuenta de EngageLab con una organización creada, y que la organización tenga activado el beneficio de SSO. Si no lo tiene, póngase en contacto con ventas.
- Haber abierto el asistente de configuración en Centro personal > SSO > Configurar SSO de EngageLab, para poder copiar la información de SP.
Paso 1: crear una aplicación empresarial
Inicie sesión en Azure Portal y vaya a Microsoft Entra ID.

Vaya a Administrar > Aplicaciones empresariales (Enterprise applications).

Haga clic en Nueva aplicación y, a continuación, en Crear su propia aplicación.

Introduzca el nombre de la aplicación (por ejemplo, EngageLab), seleccione Integrar cualquier otra aplicación que no se encuentre en la galería (no en la galería) y haga clic en Crear. La creación tarda unos segundos.

Una vez creada, se abre la página de información general de la aplicación.

Para modificar la aplicación más adelante, búsquela por su nombre o su id. de objeto en Aplicaciones empresariales > Todas las aplicaciones.

Paso 2: asignar usuarios y grupos
Solo los usuarios asignados a la aplicación pueden iniciar sesión en EngageLab mediante Azure. Puede añadir o quitar miembros aquí en cualquier momento.
Importante: EngageLab compara el correo electrónico del perfil de Azure del miembro (atributo
En la página de información general de la aplicación, haga clic en Asignar usuarios y grupos.

Haga clic en Agregar usuario o grupo y, en Usuarios, haga clic en Ninguno seleccionado.

Marque los usuarios que necesiten iniciar sesión en EngageLab, haga clic en Seleccionar y, a continuación, en Asignar.

Una vez completada la asignación, se vuelve a la página de información general de la aplicación.

Paso 3: habilitar el inicio de sesión único SAML
En la página de información general de la aplicación, haga clic en Configurar el inicio de sesión único, o haga clic en Administrar > Inicio de sesión único en el menú de la izquierda.

Seleccione SAML.

Paso 4: introducir la información de SP de EngageLab
Copie la información de SP en el paso 1 del asistente de configuración de EngageLab.

En la sección Configuración básica de SAML de Azure, haga clic en Editar, rellene los campos según la tabla siguiente y haga clic en Guardar.

Campo de Azure Valor de EngageLab que se introduce Identificador (id. de entidad) Entity ID URL de respuesta (URL del Servicio de consumidor de aserciones) ACS URL URL de inicio de sesión Login URL URL de cierre de sesión Logout URL 
Paso 5: comprobar la notificación de correo electrónico
EngageLab identifica a los usuarios leyendo su correo electrónico en la aserción SAML. Las notificaciones predeterminadas de Azure ya incluyen el atributo de correo electrónico estándar, por lo que normalmente no es necesario modificarlas; basta con comprobarlo con los pasos siguientes.
En la sección Atributos y notificaciones (Attributes & Claims) de la página de configuración de SAML, compruebe que existe la siguiente notificación:
Nombre de la notificación Valor http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddressuser.mailSi esa notificación se ha eliminado o modificado, haga clic en Editar > Agregar nueva notificación, añádala según la tabla siguiente y haga clic en Guardar:
Campo Valor Nombre emailEspacio de nombres Dejar en blanco Origen Atributo Atributo de origen user.mail
Recomendación: Establezca también Identificador de usuario único (id. de nombre) en
user.mail, con el formato Dirección de correo electrónico, para facilitar la resolución de problemas.
Paso 6: introducir la información de Azure en EngageLab
En la sección Certificados SAML de la página de configuración de SAML, descargue Certificado (Base64).

Abra el archivo del certificado con un editor de texto, copie todo su contenido y péguelo en Certificado x509 en el paso 2 del asistente de configuración de EngageLab.

En la sección Configurar de la página de configuración de SAML, copie URL de inicio de sesión y URL de cierre de sesión e introdúzcalas, respectivamente, en URL de Inicio de Sesión IdP y URL de Cierre de Sesión IdP de EngageLab.

En EngageLab, introduzca el Nombre del Servicio SSO, haga clic en Continuar y, a continuación, complete la autorización de organizaciones y la verificación según Configuración de SSO.

Paso 7: probar en Azure
Una vez completada la configuración, puede hacer clic en Probar en la página de configuración de SAML de Azure para probar el inicio de sesión único con el usuario actual. La cuenta de prueba debe estar asignada a la aplicación y haberse unido, en EngageLab, a una organización que tenga autorizado este servicio SSO.

Preguntas frecuentes
| Síntoma | Solución |
|---|---|
| La autenticación en Azure es correcta, pero no se puede iniciar sesión en EngageLab | Compruebe si en Atributos y notificaciones hay una notificación de correo electrónico con el valor user.mail (con el nombre de atributo de correo electrónico estándar o email) y si el mail del usuario está vacío |
| Se indica que el correo electrónico no coincide | Compruebe si el correo electrónico del perfil de Azure del usuario (mail) coincide con el correo electrónico de la cuenta de EngageLab; si mail está vacío, la notificación no devuelve ningún correo electrónico |
| Azure indica que el usuario no está asignado a la aplicación | Añada el usuario en Asignar usuarios y grupos |
| Al cabo de un tiempo, los miembros no pueden iniciar sesión | El certificado de Azure ha caducado o se ha cambiado; descargue el nuevo certificado y actualícelo en los detalles del servicio SSO de EngageLab |










