Esta página explica el proceso de configuración del aprovisionamiento de usuarios y equipos con SCIM mediante el método de autenticación Credenciales de cliente, necesario para integrarse con Microsoft Entra. Para obtener una descripción general de la funcionalidad de SCIM, consulta Administrar usuarios y equipos con el aprovisionamiento de SCIM.

• Instrucciones paso a paso
  • Paso 1: Generar credenciales de SCIM en Read AI
  • Paso 2: Configurar SCIM en Microsoft Entra
  • Paso 3: Asignación de atributos
  • Paso 4: Seleccionar los usuarios y grupos que se sincronizarán
  • Paso 5: Completar y supervisar el aprovisionamiento
• Notas y solución de problemas

Instrucciones paso a paso

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

Paso 1: Generar credenciales de SCIM en Read AI

1. Ve a Configuración del espacio de trabajo y expande la sección Avanzado.

   

2. Activa la opción Habilitar el aprovisionamiento de SCIM.

   

3. Selecciona la opción Credenciales de cliente de OAuth 2.0.

   

4. Haz clic en Generar credenciales para obtener tu identificador de cliente y secreto de cliente (cópialos; el secreto solo se muestra una vez y tendrás que volver a generarlo si lo pierdes).

   

5. Anota la URL del inquilino y la URL del token; también las necesitarás más adelante.

   

6. Decide si quieres habilitar el cobro automático de licencias. Si está deshabilitado, el aprovisionamiento fallará y mostrará errores en Entra cuando se agoten las licencias disponibles en tu espacio de trabajo. Puedes configurar un límite para el número máximo de puestos que puede alcanzar tu espacio de trabajo mediante el cobro automático (siempre puedes comprar más manualmente).

   

Paso 2: Configurar SCIM en Microsoft Entra

1. En el portal de administración de Entra, ve a Aplicaciones empresariales (en Entra ID, en el menú del lado izquierdo).

   

2. Crea una Aplicación nueva para Read AI.

   

3. Haz clic en Crear tu propia aplicación, proporciona un nombre (por ejemplo, «Read AI SCIM») y asegúrate de seleccionar Integrar cualquier otra aplicación que no encuentres en la galería (Fuera de la galería). No uses la aplicación de Read AI de la galería.

   

4. Haz clic en Crear (Entra puede tardar un minuto aproximadamente en crear la aplicación).

5. Haz clic en Aprovisionamiento.

   

6. Haz clic en Nueva configuración.

   

7. Para el método de autenticación, selecciona Concesión de credenciales de cliente OAuth2.

   

8. Ahora tendrás que pegar la URL del inquilino, la URL del token, el identificador de cliente y el secreto de cliente de la configuración de tu espacio de trabajo de Read AI en los campos correspondientes.

   

9. Selecciona «Cuerpo» en «Cómo se envían las credenciales».

   

10. Haz clic en Probar conexión y finalmente deberías ver una notificación en la esquina superior derecha indicando que la prueba se realizó correctamente.

    

11. Haz clic en Crear en la parte inferior para guardar la configuración (puede tardar un minuto aproximadamente en finalizar).

Paso 3: Asignación de atributos

1. Haz clic en Aprovisionamiento (el modo debe estar configurado como Automático).

   

2. Expande Asignaciones y haz clic en Aprovisionar grupos de Microsoft Entra ID.

   

3. Decide si quieres que tus grupos de Entra se conviertan en equipos en Read AI.
   • Para aprovisionar equipos: deja Habilitado en Sí (la opción predeterminada) y deja sin cambios las asignaciones de atributos predeterminadas (displayName, members, objectId). Ten en cuenta que cualquier equipo existente de Read AI cuyo nombre coincida con el de un grupo pasará a estar administrado por el IdP, y sus miembros serán reemplazados por los del grupo. Para obtener más información sobre esta función, consulta Aprovisionamiento de equipos.

   • Solo para usuarios: establece Habilitado en No. Los grupos asignados a la aplicación seguirán aprovisionando a sus miembros como usuarios, pero no se crearán equipos.

     

4. Haz clic en Guardar y luego en Sí para confirmar.

   

5. Haz clic en la X de la esquina superior derecha o en el enlace de la navegación superior para volver a la página Aprovisionamiento.

6. Haz clic en Aprovisionar usuarios de Microsoft Entra ID.

   

7. En Asignaciones de atributos, debes eliminar todos los atributos excepto:
   • userName
   • active
   • emails[type eq "work"].value
   • name.givenName
   • name.familyName

   • externalId

     

8. Haz clic en Guardar y luego en Sí para confirmar.

   

9. Haz clic en la X de la esquina superior derecha o en el enlace de la navegación superior para volver a la página Aprovisionamiento.

10. Haz clic en Asignación de atributos (versión preliminar) para confirmar que Usuarios está habilitado y que Grupos coincide con la opción que elegiste en el paso 3.

    

Paso 4: Seleccionar los usuarios y grupos que se sincronizarán

1. Haz clic en Usuarios y grupos.

   

2. Usa Agregar usuario/grupo para asignar usuarios individuales o grupos a la aplicación (estas son las personas a las que quieres autorizar para usar Read AI).

   

3. Solo los usuarios que asignes aquí (individualmente o mediante un grupo asignado) se aprovisionarán y administrarán mediante SCIM/Entra.
4. Si el aprovisionamiento de grupos está habilitado, cada grupo que asignes aquí también se convertirá en un equipo en Read AI, con el nombre del grupo. Solo se aprovisionan los miembros directos de un grupo; la pertenencia no se propaga a los grupos anidados. Es posible que los usuarios aprovisionados mediante un grupo no aparezcan individualmente en la lista de usuarios asignados.

Paso 5: Completar y supervisar el aprovisionamiento

1. Haz clic en Descripción general (versión preliminar) y luego en Iniciar aprovisionamiento.

   

2. El aprovisionamiento se ejecuta automáticamente cada ~40 minutos, creando y desactivando usuarios en tu espacio de trabajo de Read AI según sea necesario para mantenerlo sincronizado con tu aplicación de Entra. Si habilitaste el aprovisionamiento de grupos en el paso 3, los equipos y sus miembros se sincronizarán durante el mismo ciclo.
3. Puedes supervisar el estado de la sincronización y los errores en Entra. También te enviaremos notificaciones por correo electrónico si los usuarios no se aprovisionan por cualquier motivo.

Notas y solución de problemas

Asegúrate de revisar las notas aquí para comprender completamente cómo funciona el aprovisionamiento de SCIM y, si tienes algún problema, consulta los consejos para solucionar problemas.

Algunas notas relacionadas específicamente con el aprovisionamiento mediante grupos de Entra ID:

• Dejar de asignar un grupo elimina el equipo correspondiente en Read AI, revocando el acceso a cualquier informe compartido con ese equipo.
• Volver a establecer la asignación de Grupos en No mantiene los equipos existentes, pero Read AI deja de recibir actualizaciones. Por lo tanto, el equipo seguiría estando administrado por el IdP sin ninguna forma de cambiar sus miembros, a menos que deshabilites por completo el aprovisionamiento de SCIM (consulta más abajo).
• Dejar de asignar un usuario que todavía pertenece a un grupo asignado no tiene ningún efecto — el usuario seguirá aprovisionado. Un usuario al que se deje de asignar y que se elimine de todos los grupos asignados se desactivará en Read AI.

Para devolver todos los usuarios y equipos a la administración manual, simplemente deshabilita el aprovisionamiento de SCIM en la configuración de tu espacio de trabajo de Read AI. Todos los equipos y usuarios permanecerán tal como están, pero dejarán de estar administrados por el IdP.

Para obtener información detallada sobre la asignación de atributos y los escenarios avanzados, consulta la documentación oficial de SCIM de Microsoft Entra.