SpotBooker SpotBooker Guide
Inicio de sesión

Inicio de sesión SAML con el directorio de la organización

Shibboleth, ADFS, Keycloak, Okta…: sus usuarios entran en SpotBooker con las credenciales de su organización.

🏛️

¿Su organización no usa Microsoft Entra ID? Casi siempre dispone de un proveedor de identidad SAML 2.0: Shibboleth en las instituciones de la federación RENATER, ADFS, Keycloak, Okta… Una vez vinculado a SpotBooker, cada uno inicia sesión con sus credenciales habituales, sin otra contraseña. El inicio de sesión SAML está incluido en la suscripción y disponible durante la prueba gratuita. Solo los administradores de su espacio lo configuran, normalmente con el servicio informático.

Paso a paso
1 Entregue las direcciones de SpotBooker a su servicio informático

Su proveedor de identidad solo conecta un servicio que conoce. El recuadro « A declarar en su proveedor de identidad » muestra el identificador de su espacio (entity ID, que es también la dirección del archivo de metadatos) y la URL de retorno. Transmita el archivo de metadatos: lo contiene todo, certificado incluido. Estas direcciones no cambian, aunque modifique la dirección pública de su espacio.

2 Describa su proveedor de identidad

Lo más sencillo: pegue sus metadatos XML, los de su propio proveedor de identidad y no el archivo de toda la federación. SpotBooker extrae de ellos su identificador, su URL de inicio de sesión y su certificado de firma. Si no, rellene estos tres campos a mano; la URL de inicio de sesión debe empezar por https://. Durante una renovación de certificado, pegue los dos certificados uno tras otro: se muestra la fecha de caducidad de cada uno.

3 Compruebe los atributos enviados

SpotBooker necesita la dirección de correo y un identificador que no cambie de un inicio de sesión a otro; nombre, apellidos y grupos son opcionales. Los nombres habituales se reconocen de entrada: eduPersonPrincipalName para el identificador (si no, un NameID persistente), mail, givenName, sn e isMemberOf, además de sus equivalentes ADFS. Rellene la correspondencia de atributos solo si su proveedor de identidad usa otros. Del lado de la organización, hay que autorizar el envío de esos atributos a SpotBooker.

4 Declare sus dominios de correo

Sepárelos con comas, por ejemplo instituto.es, csic.es. Tienen tres efectos: solo esas direcciones pueden iniciar sesión; sus usuarios encuentran su organización escribiendo su dirección en la página de inicio de sesión; y una cuenta SpotBooker que ya existe con una de esas direcciones se vincula al directorio en lugar de rechazarse. Sin dominio, se acepta cualquier dirección autenticada por su proveedor de identidad, pero se pierden los dos últimos efectos. El descubrimiento desde la página de inicio de sesión, la vinculación de cuentas existentes y la admisión automática solo se aplican una vez probado el dominio (vea «Probar sus dominios» más abajo).

5 Elija quién entra automáticamente

Con la admisión automática, cualquier persona del directorio entra desde su primer inicio de sesión, sin ningún derecho de administración. Desactívela si su directorio incluye también estudiantes o invitados que no deben reservar: cada primer inicio de sesión deja entonces una solicitud de acceso, que usted acepta o rechaza. Estos ajustes son propios de SAML: el inicio de sesión de Microsoft conserva los suyos.

6 Vincule sus grupos, si lo desea

Haga corresponder un valor de grupo enviado por el directorio (por ejemplo una entrada de isMemberOf) con un grupo de SpotBooker creado previamente. En cada inicio de sesión, el usuario se une a los grupos correspondientes y sale de aquellos a los que ya no pertenece. Los grupos que gestiona a mano en SpotBooker nunca se modifican.

7 Active y pruebe

Active el inicio de sesión y guarde. La activación se rechaza mientras no estén rellenos el identificador, la URL de inicio de sesión y el certificado. Haga una primera prueba con una cuenta del directorio, en una ventana de navegación privada.

8 Indique el camino a sus usuarios

En la página de inicio de sesión, eligen « Iniciar sesión con su organización », escriben su dirección (o solo el dominio) y llegan a la página de inicio de sesión de su organización. También puede darles el enlace de inicio de sesión directo que aparece en los ajustes, por ejemplo en su intranet.

Probar sus dominios

Un dominio que declara filtra las direcciones en cuanto se guarda. Para que además encuentre su organización desde la página de inicio de sesión, certifique las direcciones y admita automáticamente, debe probar que le pertenece. Sin esa prueba, cualquier espacio podría reclamar su dominio. La prueba vale para el dominio exacto: institut.fr no cubre labo.institut.fr, que se declara y se prueba por separado.

1 Copiar el registro TXT

Bajo el campo de dominios, cada dominio guardado muestra su registro: tipo TXT, valor spotbooker-verification=….

2 Añadirlo al DNS del dominio

Su servicio informático lo añade en el propio dominio (por ejemplo institut.fr) o, si lo prefiere, en _spotbooker.institut.fr. Puede quedarse: SpotBooker lo vuelve a comprobar cada día.

3 Verificar

Haga clic en «Verificar ahora». Si no, SpotBooker lo busca solo cada 15 minutos durante 14 días. Un dominio lo verifica un solo espacio: si ya lo está en otro, contacte con el soporte. Si el registro desaparece 7 días seguidos, se retira la verificación y sus administradores reciben un aviso por correo.

SpotBooker aún no es miembro de la federación RENATER. Mientras tanto, su institución declara directamente los metadatos de SpotBooker en su propio proveedor de identidad y le autoriza a recibir los atributos necesarios (dirección, identificador, nombre, grupos). Basta con eso para que el inicio de sesión funcione.
Cierre de sesión
1 Indique la URL de cierre de sesión

Opcional: el campo « URL de cierre de sesión (SLO, enlace Redirect) » espera una dirección en https://, y se rellena solo si los metadatos pegados contienen una. Por su parte, SpotBooker publica su « URL de cierre de sesión (Single Logout Service) » en sus metadatos: si su organización los declaró antes, pídale que los vuelva a cargar. Sin URL de cierre de sesión, cerrar sesión solo cierra la sesión de SpotBooker.

2 Cerrar sesión en SpotBooker cierra también la organización

Primero se cierra la sesión de SpotBooker y después sale una solicitud firmada hacia su proveedor de identidad. Si no lo confirma, la persona sigue desconectada de SpotBooker y ve « Ha cerrado la sesión de SpotBooker, pero su organización no ha confirmado el cierre de su sesión en ella. Cierre el navegador para terminarla. »

3 Un cierre de sesión en la organización cierra SpotBooker

Cuando su proveedor de identidad envía una solicitud de cierre de sesión firmada, SpotBooker cierra todas las sesiones de la persona, en todos sus dispositivos, y le muestra « Su organización ha cerrado su sesión ». Como para el inicio de sesión, se rechaza una solicitud sin firma, firmada en SHA-1, demasiado antigua o ya recibida.

Lo que SpotBooker rechaza, y por qué
Rechazado Por qué
Una respuesta sin firma La firma de su proveedor de identidad es lo que demuestra que la respuesta viene de él. Puede cubrir la respuesta o la aserción: Shibboleth firma la respuesta por defecto, no hay nada que cambiar.
Una firma en SHA-1 Este algoritmo ya no ofrece garantías suficientes, ni en firma ni en resumen. Configure su proveedor de identidad en SHA-256.
Un inicio de sesión lanzado desde el portal de la organización SpotBooker solo acepta la respuesta a una solicitud que acaba de emitir, utilizable una sola vez y durante 10 minutos: una respuesta interceptada no puede reutilizarse. Por eso el inicio de sesión debe partir de SpotBooker. Para un acceso desde un portal, use el enlace de inicio de sesión directo.
Solo un identificador transitorio Un NameID transitorio cambia en cada inicio de sesión: SpotBooker no reconocería a la persona la vez siguiente. Envíe eduPersonPrincipalName o un NameID persistente.
Una dirección fuera de sus dominios Si ha declarado dominios, las demás direcciones no entran, aunque su proveedor de identidad las autentique.
Si algo falla
Lo que ve Qué hacer
« Ningún inicio de sesión de organización corresponde a esta dirección » El dominio escrito no figura en sus dominios de correo aceptados, o el inicio de sesión SAML no está activado. Añada el dominio y compruebe la activación.
« El inicio de sesión a través de su organización no está disponible » El inicio de sesión está desactivado o incompleto, o la prueba gratuita terminó sin suscripción. Sus ajustes se conservan: vuelven a aplicarse en cuanto se suscriba.
« El inicio de sesión a través de su organización ha fallado » Su proveedor de identidad respondió, pero la respuesta se rechazó. Causas frecuentes: certificado renovado en la organización pero no en SpotBooker (compruebe su fecha de caducidad), firma en SHA-1, dirección de correo no enviada, inicio de sesión pendiente más de 10 minutos. Por seguridad no se muestra el detalle: escríbanos indicando la hora del intento y lo encontraremos.
Su proveedor de identidad muestra un error antes de volver Aún no conoce SpotBooker, o no con este identificador. Haga declarar los metadatos del paso 1 en su proveedor de identidad.
« Su cuenta no está autorizada a acceder a este espacio » La dirección no pertenece a sus dominios, ya se usa en otro espacio SpotBooker, o la solicitud de acceso de esta persona fue rechazada. Una persona rechazada no entra volviendo a iniciar sesión.
« Ya existe una cuenta con esta dirección… » Ya existe una cuenta SpotBooker con esta dirección, y solo se vincula al directorio si su dominio figura en sus dominios aceptados. Añada el dominio, o la persona inicia sesión con su contraseña.
« Su solicitud de acceso se ha enviado… » o « Su cuenta ha sido desactivada… » El primer mensaje es normal sin admisión automática: acepte la solicitud. El segundo significa que la persona ha dejado el directorio: vea Sincronizar los usuarios con SCIM.
¿Su directorio es Microsoft Entra ID? La guía Conectar su directorio Microsoft es más directa. ¿Sin proveedor de identidad, solo un directorio OpenLDAP o Active Directory? Consulte el inicio de sesión LDAP. Para que una salida del directorio corte el acceso el mismo día, sin esperar un inicio de sesión, añada la sincronización SCIM.

Prueba SpotBooker gratis — 14 días, sin tarjeta de crédito

Crea tu cuenta y configura tus propios espacios siguiendo esta guía.

Empezar mi prueba gratuita
Todas las guias
Reservar Reservar Agenda