Descripción general

SCIM (System for Cross-domain Identity Management) automatiza el aprovisionamiento de usuarios y equipos en los espacios de trabajo de Read AI mediante la integración con proveedores de identidad. Esto permite a los equipos de TI gestionar el acceso de forma centralizada, reducir el trabajo manual y mantener el cumplimiento.

Proveedores de identidad compatibles: Microsoft Entra (anteriormente Azure AD), Okta y Google Workspace son actualmente las únicas plataformas compatibles oficialmente. Contacta con el equipo de soporte para solicitar proveedores adicionales.

Las funciones de SCIM incluyen:

Crear usuarios nuevos: crea automáticamente cuentas para los usuarios asignados a Read AI en tu proveedor de identidad, los añade al espacio de trabajo y envía un correo electrónico de incorporación. A partir de ese momento, el proveedor de identidad gestiona estos usuarios.
Actualizar usuarios existentes: transfiere a los titulares actuales de cuentas de Read AI a la gestión del proveedor de identidad, lo que permite actualizar automáticamente los atributos y controlar la desactivación mediante tu proveedor de identidad.
Aprovisionar equipos: crea equipos de Read AI a partir de los grupos de tu proveedor de identidad y mantiene sincronizada su pertenencia. Los equipos existentes cuyos nombres coincidan con los de un grupo pasan a estar gestionados por el proveedor de identidad. Actualmente disponible solo para Microsoft Entra.

Importante: el aprovisionamiento SCIM no controla los métodos de inicio de sesión. Muchas organizaciones también configuran por separado el inicio de sesión único mediante SAML.

Requisitos previos

Debes ser administrador del espacio de trabajo en Read AI.
Tu espacio de trabajo debe tener el plan Enterprise+.
Debes verificar los dominios de los usuarios que quieras aprovisionar con SCIM (a menos que ya estén en tu espacio de trabajo).
Necesitas acceso de administrador a tu instancia de Microsoft Entra, organización de Okta o cuenta de Google Workspace.

Instrucciones de configuración

El proceso de configuración varía ligeramente según el proveedor de identidad que utilices. Para consultar instrucciones paso a paso con capturas de pantalla, consulta:

Para Microsoft Entra: Configuración de SCIM con credenciales de cliente
Para Okta: Configuración de SCIM con código de autorización
Para Google Workspace: Configuración de SCIM con Google Workspace Directory Sync

Asegúrate de seguir las instrucciones cuidadosamente, ya que una configuración incorrecta puede impedir que la integración funcione o provocar un comportamiento de aprovisionamiento inesperado.

Aprovisionamiento de equipos

El aprovisionamiento de equipos es opcional y se configura en tu proveedor de identidad, no en Read AI. Una vez activado, los grupos que aprovisiones se convertirán en equipos.

La primera vez que se aprovisiona un grupo, los administradores del espacio de trabajo reciben un correo electrónico único para confirmar que se ha iniciado el aprovisionamiento del equipo.

Qué grupos se convierten en equipos

Cada grupo que aprovisiones se convierte en un equipo en Read AI con el nombre del grupo.

Si no existe ningún equipo con ese nombre, se crea un equipo nuevo. Este es el caso más habitual.
Si ya existe un equipo con ese nombre, pasa a estar gestionado por el proveedor de identidad y su pertenencia se sustituye por la del grupo.

Los nombres de los grupos coinciden exactamente con los nombres de los equipos, sin distinguir entre mayúsculas y minúsculas. Si cambias el nombre de un grupo en tu proveedor de identidad, se cambia el nombre del equipo correspondiente en Read AI. El equipo, su historial y su configuración se conservan.

Los equipos aprovisionados mediante SCIM aparecen etiquetados como IdP-Managed en todo Read AI.

Qué puedes cambiar y qué no

Para un equipo gestionado por un proveedor de identidad	Dónde realizar el cambio
Añadir o eliminar miembros	Tu proveedor de identidad
Cambiar el nombre del equipo	Tu proveedor de identidad
Eliminar el equipo	Tu proveedor de identidad
Abandonar el equipo	Tu proveedor de identidad
Cambiar el rol de equipo de un miembro	Read AI
Cambiar la configuración y los permisos del equipo	Read AI

Los equipos que no tengan la etiqueta IdP-Managed no se ven afectados y todo lo anterior se gestiona en Read AI como de costumbre.

Eliminar un equipo del aprovisionamiento

Dejar de asignar un grupo al aprovisionamiento elimina su equipo en Read AI. Este es el comportamiento estándar de SCIM; tu proveedor de identidad es la fuente de verdad, por lo que eliminar un grupo allí elimina el equipo aquí.

Antes de dejar de asignar un grupo, ten en cuenta qué consecuencias tiene eliminar el equipo: los informes de reuniones compartidos con ese equipo dejarán de estar compartidos. Crear de nuevo un equipo con el mismo nombre no los restaurará; esos informes deberán volver a compartirse con el nuevo equipo, uno por uno. También se perderán las métricas y tendencias a nivel de equipo, y dejará de aplicarse cualquier configuración específica del equipo.

Para dejar de sincronizar un equipo sin eliminarlo, desactiva el aprovisionamiento de grupos en tu proveedor de identidad en lugar de dejar de asignar el grupo. Los equipos existentes permanecerán y dejarán de recibir actualizaciones, pero seguirán estando gestionados por el proveedor de identidad (no podrás cambiar su pertenencia en Read AI).

Para devolver los equipos a la gestión manual, desactiva el aprovisionamiento SCIM en la configuración de tu espacio de trabajo de Read AI. Todos los equipos y usuarios dejarán de estar gestionados por el proveedor de identidad y podrán editarse normalmente en Read AI. Ten en cuenta que esto también finaliza el aprovisionamiento de usuarios.

Roles y administradores de los equipos

Tu proveedor de identidad controla quién forma parte de un equipo. Read AI controla qué pueden hacer.

Todas las personas añadidas mediante el aprovisionamiento se incorporan como usuarios, y puedes ascender a alguien a administrador en cualquier momento. Como los roles no se aprovisionan, un equipo recién creado comienza sin administrador y Read AI muestra un recordatorio en los equipos que no tienen uno.

Los administradores pueden configurar ajustes específicos de los equipos que gestionan, mientras que los usuarios normales no pueden hacerlo. Los propietarios y administradores del espacio de trabajo también pueden configurar ajustes específicos para cualquier equipo de su espacio de trabajo.

Equipos que creas tú mismo

Puedes seguir creando y gestionando tus propios equipos junto con los aprovisionados. Debes tener en cuenta dos cosas:

Read AI no te permitirá crear un equipo con el mismo nombre que otro equipo que ya exista en tu espacio de trabajo.
Si posteriormente se aprovisiona un grupo con el mismo nombre, tu equipo pasará a estar gestionado por el proveedor de identidad en la siguiente sincronización. Su pertenencia se sustituirá por la del grupo y ya no podrás cambiarla en Read AI.

Como los grupos se sincronizan con retraso, esto puede ocurrir poco después de crear un equipo si el grupo ya existía en tu proveedor de identidad, pero aún no se había sincronizado. Si utilizas el aprovisionamiento de equipos, conviene comprobar tus grupos antes de crear un equipo manualmente.

Notas importantes

Los usuarios aprovisionados mediante SCIM no se pueden eliminar manualmente ni quitar del espacio de trabajo; la eliminación del aprovisionamiento debe gestionarse mediante tu proveedor de identidad.
El aprovisionamiento de equipos controla la pertenencia, el nombre y la eliminación de los equipos. No afecta a los roles, la configuración ni los permisos de los equipos.
Si el cargo automático está activado, se compran automáticamente licencias adicionales cuando se aprovisionan usuarios nuevos, hasta el máximo configurado. Si está desactivado, el aprovisionamiento fallará cuando no haya suficientes licencias disponibles.
Los usuarios cuyo aprovisionamiento se haya eliminado se desactivan y su puesto se libera automáticamente. Las licencias nunca se eliminarán automáticamente; si quieres reducir el número total de licencias, debes hacerlo desde la página de gestión de facturación.
Los secretos de cliente no caducan, pero se pueden rotar desde la configuración de tu espacio de trabajo de Read AI si es necesario.

Solución de problemas

Si tienes algún problema, comprueba que hayas seguido correctamente las instrucciones de configuración. El proceso de asignación de atributos, en particular, puede provocar errores.
Los errores que se producen durante el aprovisionamiento se muestran en tu proveedor de identidad, pero Read AI también notificará a los administradores del espacio de trabajo por correo electrónico. Entre los errores habituales se incluyen:
- Licencias insuficientes:
  - No tienes licencias sin usar en tu espacio de trabajo y el cargo automático está desactivado o se ha alcanzado el límite.
  - Para solucionarlo, compra más licencias manualmente, activa el cargo automático o aumenta el límite de puestos del cargo automático.
- El usuario está en otro espacio de trabajo:
  - El usuario que intentas aprovisionar ya tiene una cuenta de Read AI y pertenece a otro espacio de trabajo. El aprovisionamiento fallará hasta que abandone el otro espacio de trabajo.
  - Para solucionarlo, haz que el usuario abandone el otro espacio de trabajo o deja de asignarlo a tu aplicación en tu proveedor de identidad.
- El correo electrónico del usuario no está verificado:
  - Alguien ha creado una cuenta con la dirección de correo electrónico de un usuario asignado a tu aplicación del proveedor de identidad, pero no ha verificado su dirección de correo electrónico. Estos usuarios no pueden pasar a estar gestionados por el proveedor de identidad ni añadirse a tu espacio de trabajo, por lo que el aprovisionamiento fallará.
  - Para solucionarlo, haz que el usuario verifique su dirección de correo electrónico o deja de asignarlo a tu aplicación en tu proveedor de identidad.
- El usuario es propietario o administrador del espacio de trabajo:
  - Aunque los usuarios aprovisionados pueden ser propietarios o administradores del espacio de trabajo, no puedes desactivar a un propietario o administrador mediante SCIM.
  - Para solucionarlo, deja de asignar al usuario a tu aplicación del proveedor de identidad para poder gestionarlo manualmente desde la configuración del espacio de trabajo de Read AI.
Si activas el aprovisionamiento de equipos, puedes encontrarte con lo siguiente:
- Ha desaparecido un equipo. El grupo dejó de estar asignado a tu aplicación en tu proveedor de identidad, lo que elimina el equipo correspondiente en Read AI. Volver a asignar el grupo crea de nuevo el equipo con sus miembros actuales, pero será un equipo nuevo (los informes de reuniones compartidos con el anterior deberán compartirse de nuevo).
- Un equipo que esperaba no aparece en Read AI. Comprueba que el grupo esté aprovisionado en tu proveedor de identidad y que se haya completado un ciclo de sincronización.
- Un equipo tiene miembros incorrectos. La pertenencia procede del grupo; cámbiala en tu proveedor de identidad.
- No puedo eliminar a alguien de un equipo. Si el equipo tiene la etiqueta IdP-Managed, elimina a esa persona del grupo en tu proveedor de identidad.
- Un equipo que creé ahora tiene la etiqueta IdP-Managed. Se aprovisionó un grupo con el mismo nombre, por lo que Read AI lo asumió en la siguiente sincronización.
Recuerda que debes verificar la propiedad del dominio para aprovisionar usuarios nuevos o usuarios existentes que estén fuera de tu espacio de trabajo.