Configurar el inicio de sesión con SSO personalizado
Ruta: ¡Hola! Store → Personalizado → Instalar
Visión general
La app Personalizado permite que los usuarios inicien sesión en ¡Hola! Suite mediante el proveedor de autenticación que la empresa ya usa, aunque no tenga una app propia en ¡Hola! Store. Este tipo de acceso se llama inicio de sesión único, o SSO (Single Sign-On).
El proveedor debe usar el estándar OAuth 2.0, con inicio de sesión por código de autorización. ¡Hola! Suite identifica al usuario por el correo electrónico: el correo en el proveedor debe ser el mismo correo registrado para el usuario en ¡Hola! Suite.
Para Google, Microsoft y Keycloak, prefiere las apps propias. Consulta los contenidos relacionados.
Requisitos previos
- Permiso para visualizar ¡Hola! Store en tu grupo de permisos.
- Una aplicación (cliente) registrada en el proveedor de autenticación, con ID del cliente y clave secreta.
- En el proveedor, la URI de redireccionamiento de abajo registrada, reemplazando por la dirección de tu ¡Hola! Suite:
https://endereco-do-seu-opa-suite/auth/login/sso/callback/customized - Las direcciones de autenticación, de token y de datos del usuario del proveedor.
- Usuarios registrados y activos en ¡Hola! Suite, con el mismo correo electrónico del proveedor. El SSO personalizado no crea usuarios.
- Ninguna otra app de SSO instalada. ¡Hola! Suite acepta una app de SSO a la vez.
Paso a paso
- Accede a ¡Hola! Store y abre la app Personalizado, en la categoría SSO.
- Haz clic en Instalar. Se abre la ventana Instalar SSO personalizado con tres etapas.
- En la etapa Credenciales del cliente OAuth, completa:
- ID del cliente: el identificador de la aplicación en el proveedor.
- Clave privada del cliente: la clave secreta de la aplicación.
- Haz clic en Continuar.
- En la etapa Configure las URLs de su servidor, completa:
- URL de autenticación: la dirección a la que se lleva al usuario para iniciar sesión.
- URL del token: la dirección en la que ¡Hola! Suite cambia el código de autorización por el token de acceso.
- URL de recursos: la dirección que devuelve los datos del usuario autenticado.
- Haz clic en Continuar.
- En la etapa Campos de identificación, completa:
- Campo de identificación del usuario: el dato, en la respuesta de la URL de recursos, que trae el correo electrónico del usuario (ej.:
email). - Scopes: los permisos solicitados al proveedor en el inicio de sesión (ej.:
openid profile email).
- Campo de identificación del usuario: el dato, en la respuesta de la URL de recursos, que trae el correo electrónico del usuario (ej.:
- Haz clic en Instalar SSO personalizado.
Resultado esperado
La app aparece como instalada y ¡Hola! Suite abre la pantalla de configuraciones, con la sección Datos de integración.
En la pantalla de inicio de sesión de ¡Hola! Suite pasa a aparecer, debajo de Iniciar sesión, el texto o inicie sesión con y el botón SSO. Al hacer clic, el usuario es llevado al inicio de sesión del proveedor y, después de autenticado, vuelve a ¡Hola! Suite ya conectado.
El inicio de sesión con SSO personalizado sigue las mismas reglas de seguridad del inicio de sesión común: autenticación de dos factores, límite de usuarios conectados y restricción de acceso por IP.
Configuraciones disponibles
Para modificar, accede a ¡Hola! Store → Personalizado → Acceder y edita Datos de integración: Client ID, Client Secret, URL de autenticación, URL del token, URL de recursos, Campo de identificación del usuario y Scopes.
Para eliminar el SSO personalizado, haz clic en Desinstalar App y confirma en Desinstalar.
Problemas comunes
| Síntoma o mensaje | Qué verificar |
|---|---|
| "Tu usuario no fue encontrado. Ponte en contacto con un administrador del sistema." | No existe un usuario activo en ¡Hola! Suite con el correo electrónico que vino del proveedor. Verifica que el Campo de identificación del usuario traiga el correo electrónico. |
| "No fue posible iniciar sesión con este proveedor. Ponte en contacto con el administrador del sistema." | La respuesta de la URL de recursos no trajo el Campo de identificación del usuario configurado. Verifica el campo y los Scopes. |
| "Hubo un error al recopilar los datos de tu usuario. Inténtalo de nuevo más tarde." | El proveedor rechazó el intercambio del código o la consulta de los datos. Verifica las credenciales, la URL del token y la URL de recursos. |
| El proveedor muestra un error de URI de redireccionamiento | La URI registrada en el proveedor debe ser igual a la de ¡Hola! Suite. |
| La página de la app muestra "Ya hay una app de esta categoría instalada" | Ya hay otra app de SSO instalada. Desinstálala antes. |
Buenas prácticas
- Prueba la URL de recursos con el proveedor antes de instalar, para saber el nombre exacto del campo que trae el correo electrónico.
- Verifica que el correo electrónico de cada usuario en ¡Hola! Suite sea el mismo del proveedor antes de divulgar el inicio de sesión.
- Guarda la clave secreta en un lugar seguro y cámbiala en ¡Hola! Suite siempre que se renueve en el proveedor.