1. Introducción
Esta guía está diseñada para ayudarte a configurar el inicio de sesión único (SSO) para las aplicaciones de tu organización utilizando Microsoft Entra.
Nota Importante: Antes de comenzar, asegúrate de tener los permisos necesarios. Si no estás seguro, por favor contacta al soporte técnico o al administrador de tu empresa.
2. Tabla de Contenidos
- Comprender Términos Clave
- Comenzando
- Configuración Paso a Paso de SSO
- Pruebas y Confirmación
- Solución de Problemas y Soporte
- Recursos Adicionales
3. Comprender Términos Clave
Microsoft Entra: Anteriormente conocido como Azure Active Directory, es el directorio de identidad en línea de Microsoft utilizado para gestionar el acceso de usuarios a recursos. • SSO (Inicio de Sesión Único): Un método seguro que te permite acceder a varias aplicaciones con un solo conjunto de credenciales (nombre de usuario y contraseña). • Aplicación: Cualquier herramienta o servicio en línea que utiliza tu organización (por ejemplo, correo electrónico, herramientas de colaboración).
4. Comenzando
Antes de comenzar a configurar SSO, por favor asegúrate de:
• Tener acceso de administrador a Microsoft Entra (o pregunta a tu equipo de TI si es necesario).
• El protocolo de SSO será SAML2
• Indicar el valor que se usará como nombre de usuario. Para el acceso SSO, Cyber Guru desea usar el ID de objeto del usuario. Eso significa que, si precargas al usuario en nuestra plataforma, deben tener el objectID como nombre de usuario.
• Verificar la presencia en el perfil de usuario de Microsoft de los campos obligatorios: nombre de usuario, correo electrónico, nombre, apellido
• Verificar la política de acceso a la aplicación SSO para los usuarios. Usar grupos sería lo mejor.
• Proporcionar un usuario para Cyberguru en Microsoft Entra para la solución de problemas
5. Configuración Paso a Paso de SSO
5.1. Paso 1:
Iniciar sesión en Microsoft Entra
Ve a la página de inicio de sesión de Microsoft Entra con rol de administrador
5.2. Paso 2: Navegar a la Sección de Aplicaciones Empresariales
Una vez que hayas iniciado sesión, busca un panel de navegación (generalmente a la izquierda).
Haz clic en la opción etiquetada como “Aplicaciones Empresariales” o “Apps”.
Esta sección muestra todas las aplicaciones disponibles para la integración de SSO.
5.3. Paso 3: Agregar una Nueva Aplicación
En la parte superior de la página de “Aplicaciones Empresariales”, generalmente hay un botón que dice “Nueva Aplicación” o “Agregar Aplicación”.
Haz clic en ese botón.
Haz clic en “Crear tu propia aplicación”
Asegúrate de que el botón de opción esté seleccionado en “Integrar cualquier otra aplicación que no encuentres en la galería (No en galería)
inserta un nombre para la aplicación y haz clic en “Guardar”
5.4. Paso 4: Configurar SSO para la Aplicación
En la página de resumen de la aplicación,
busca un botón o enlace que diga "Inicio de sesión único" o "Configurar inicio de sesión único".
Haz clic en este botón. Serás llevado a la página de configuración de SSO.
Podrías ver diferentes métodos de SSO (como SAML, OpenID Connect, etc.). Haz clic en "SAML".
5.5. Paso 5: enviar Metadatos Idp a Cyber Guru
Ubica el panel n.3 en la página de la aplicación.
Copia la URL de App FederationMetadata y envíala a CSM Cyber Guru.
5.6. Paso 6: Configuración de Cyber Guru
Cyber Guru completará la configuración de su lado y enviará de vuelta la URL de los metadatos SP.
N.B. Abre la URL de los metadatos SP recibida en un navegador y guárdala como un archivo XML
5.7. Paso 7: subir metadatos SP
Haz clic en "Actualizar archivo de metadatos", en la esquina superior izquierda de la página de la aplicación y
proporciona el archivo xml de metadatos SP guardado en el paso anterior.
Tan pronto como se suba el archivo, obtendrás la página de revisión de metadatos
haz clic en "Guardar"
5.8. Paso 8: Añadir reclamaciones de Cyber Guru a la respuesta SAML
Cyber Guru reclama los siguientes atributos obligatorios en la respuesta SAML
• nombre de usuario
• nombre
• apellido
• correo electrónico
Para una lista completa de atributos que Cyber Guru puede recibir en la respuesta, por favor consulta el artículo dedicado "Atributos Idp"
Tan pronto como se cree la aplicación, encontrarás las reclamaciones predeterminadas de la siguiente manera
Puedes modificar las reclamaciones adicionales existentes o eliminarlas todas y crear nuevas. A continuación se detalla cada atributo obligatorio:
Al final de la configuración de reclamaciones deberías ver lo siguiente. Revisa cuidadosamente el mapeo y presta atención a los atributos con nombres sensibles a mayúsculas y minúsculas (nombre, apellido)
5.9. Paso 9 Revisar la Configuración
Tómate un momento para revisar la información. Si algo no parece correcto, puedes volver atrás y hacer ajustes.
Nota: Es una buena idea guardar una nota en papel o una copia digital de estas configuraciones para referencia futura.
6. Prueba y Confirmación
Una vez que la configuración de SSO esté completa, prueba que funcione correctamente:
Autoriza al usuario para la prueba en la aplicación. El usuario debe estar previamente cargado en la plataforma de Cyber Guru.
Abre una nueva ventana del navegador (o una ventana de incógnito/privada).
Navega a la URL de inicio de sesión de la aplicación
https://<dominio del cliente>.platform.cyberguru.eu
Haz clic en el botón “Iniciar sesión con SSO” — tu navegador debería redirigirte a la página de inicio de sesión de Microsoft Entra.(*)
Introduce las credenciales de inicio de sesión.
Confirma que has iniciado sesión en la aplicación sin necesidad de ingresar credenciales adicionales.
Si todo funciona correctamente, verás un mensaje de éxito o el panel de la aplicación.
(*) Este botón puede ser eliminado por Cyber Guru, por lo que, tan pronto como dirijas tu navegador a https://<dominio del cliente>.platform.cyberguru.eu, la plataforma redirigirá automáticamente al usuario a la página de inicio de sesión de Microsoft.
7. Solución de Problemas y Soporte
Si encuentras problemas durante la configuración:
- Verifica dos veces la información ingresada en cada campo.
- Asegúrate de que las URLs e identificadores coincidan con los proporcionados por tu equipo de TI o proveedor de la aplicación.
- Busca mensajes de error en la pantalla, a menudo incluyen pistas sobre lo que está mal.
- Usa un rastreador SAML en el navegador para rastrear los valores de las afirmaciones en la respuesta SAML.
Si aún tienes problemas, anota el mensaje de error y contacta a tu soporte de TI y/o al servicio de ayuda de Cyberguru.
8. Recursos Adicionales
Documentación de Microsoft Entra:
Visita el sitio web oficial de Microsoft para guías detalladas y preguntas frecuentes:
https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal-setup-sso
Contacta al Soporte de TI: Comunícate con el equipo de TI de tu organización para obtener ayuda con configuraciones específicas.