Saltar al contenido principal

Configuración de SCIM con credenciales de cliente (Microsoft Entra)

Actualización

Esta página explica cómo configurar el aprovisionamiento de usuarios y equipos con SCIM mediante el método de autenticación de credenciales de cliente, que es obligatorio para Microsoft Entra. Para obtener una descripción general de la funcionalidad de SCIM, consulta Administrar usuarios y equipos con el aprovisionamiento de SCIM. Si utilizas otro proveedor de identidad, consulta Configuración de SCIM con código de autorización (Okta) o Configuración de SCIM con Google Workspace Directory Sync.

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 las 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.

    SCIM User Provisioning setting.png

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

    Screenshot 2026-09-25 at 3.02.06 PM.png

  4. Haz clic en Generar credenciales para obtener tu Id. 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 Id. de Entra, en el menú del lado izquierdo).

  2. Crea una Nueva aplicación 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 (no perteneciente a la galería). No utilices la aplicación de Read AI de la galería.

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

  5. Haz clic en Aprovisionamiento.

  6. Haz clic en Nueva configuración.

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

  8. Ahora tendrás que pegar la URL del inquilino, la URL del token, el Id. 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.

    image (6).png

  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 (el proceso puede tardar aproximadamente un minuto en finalizar).

Paso 3: Asignación de atributos

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

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

  3. Decide si quieres que tus grupos de Entra se conviertan en equipos en Read AI.
    • Para aprovisionar equipos: deja Habilitado establecido en Sí (valor predeterminado) y deja sin cambios las asignaciones de atributos predeterminadas (displayName, members, objectId). Ten en cuenta que cualquier equipo de Read AI existente cuyo nombre coincida con el de un grupo pasará a estar administrado por el proveedor de identidad, y sus miembros se reemplazarán 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 Id. de Microsoft Entra.

  7. En Asignaciones de atributos, debes eliminar todos los atributos excepto los siguientes:
    • 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 coincida 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. Utiliza Agregar usuario/grupo para asignar usuarios individuales o grupos a la aplicación (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 mismo nombre que el 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 aproximadamente 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 en 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 no se puede aprovisionar a usuarios por algún motivo.

Notas y solución de problemas

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

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

  • Quitar la asignación de un grupo elimina el equipo correspondiente en Read AI, lo que revoca 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 permanecería administrado por el proveedor de identidad sin ninguna forma de cambiar sus miembros, a menos que deshabilites por completo el aprovisionamiento de SCIM (consulta la información siguiente).
  • Quitar la asignación de un usuario que aún pertenece a un grupo asignado no tiene ningún efecto: el usuario seguirá aprovisionado. Un usuario cuya asignación se quite 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 proveedor de identidad.

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

Artículos relacionados