Saltar al contenido principal

Configuración de SCIM con código de autorización (Okta)

Actualización

Esta página explica el proceso de configuración del aprovisionamiento de usuarios con SCIM mediante el método de autenticación Código de autorización, necesario para realizar la integración con Okta. Para obtener una descripción general de la funcionalidad de SCIM, consulta Administrar usuarios con el aprovisionamiento de SCIM, y si utilizas Microsoft Entra en lugar de Okta como tu IdP, consulta Configuración de SCIM con credenciales de cliente (Microsoft Entra).

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 inesperado del aprovisionamiento.

Paso 1: Crea tu aplicación en Okta

Debes crear una aplicación personalizada en Okta para administrar esta integración. Si ya creaste una aplicación para la integración de SAML con Okta, puedes reutilizarla y pasar directamente al Paso 2.

  1. Inicia sesión en la consola de administración de Okta y ve a la página de Aplicaciones.

  2. Haz clic en Crear integración de aplicación.

  3. Selecciona tu método de inicio de sesión:

    • Si también vas a habilitar el inicio de sesión único de SAML con Okta, elige la opción SAML 2.0 y sigue las instrucciones de ese artículo para configurar el aspecto de SAML.
    • Si solo utilizas Okta para el aprovisionamiento de SCIM y no para iniciar sesión, esta elección es menos importante: los pasos que aparecen a continuación muestran cómo se ve para SAML 2.0, pero también podrías utilizar SWA (autenticación web segura).

  4. Asigna un nombre a la aplicación (por ejemplo, "Read AI") y haz clic en siguiente.

  5. Si también habilitas SAML, debes seguir las instrucciones que aparecen aquí para configurar correctamente este paso. Si no vas a utilizar SAML, solo debes introducir algunos valores ficticios en los campos obligatorios del paso Configurar SAML:

    Solo los dos primeros campos son obligatorios; cualquier valor funcionará, siempre que la URL de inicio de sesión comience con https://. Desplázate hacia abajo y haz clic en siguiente.

  6. Completa el paso final de comentarios (son solo comentarios para Okta y no afectan a la funcionalidad de la integración) y haz clic en Finalizar.

Paso 2: Genera las credenciales de SCIM en Read AI

Los siguientes pasos se realizan en Read AI.

  1. Ve a la configuración de tu espacio de trabajo y expande la sección Avanzado.

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

  3. Selecciona la opción Código de autorización de OAuth 2.0.

  4. Agrega tu URI de redireccionamiento o tus URI de redireccionamiento.

    La URI de redireccionamiento obligatoria es https://system-admin.okta.com/admin/app/cpc/{appName}/oauth/callback, pero debes reemplazar {appName} por el identificador correspondiente de Okta.

    Puedes obtener {appName} de la URL de la consola de administración de Okta cuando tengas seleccionada la instancia de tu aplicación. La URL de la consola de administración tiene el siguiente formato: https://{orgSubDomain}-admin.{oktaEnvironment}.com/admin/app/{appName}/instance/{instanceID}/#tab-general

    {appName} es la cadena que aparece entre /app/ y /instance/ en la URL después de crear la instancia de integración de tu aplicación en Okta.

    Para obtener más información y consultar otras URI que quizá debas agregar según tu situación, consulta la documentación de Okta.

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

  6. Anota también la URL de autorización, la URL del inquilino y la URL del token, ya que las necesitarás más adelante.

  7. Decide si quieres habilitar el cobro automático de licencias. Si está deshabilitado, el aprovisionamiento fallará y mostrará errores en Okta cada vez que 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 3: Configura SCIM en Okta

Vuelve a tu aplicación en Okta para continuar con la configuración.

  1. En la pestaña General de tu aplicación en Okta, edita la configuración de la aplicación para habilitar el aprovisionamiento de SCIM y haz clic en Guardar.

  2. Aparecerá una nueva pestaña de Aprovisionamiento; haz clic en ella y edita la configuración.

  3. Introduce los valores correspondientes para la configuración.

    • URL base del conector SCIM = copia la URL del inquilino de la configuración del espacio de trabajo de Read AI
    • Campo de identificador único para los usuarios = userName
    • Acciones de aprovisionamiento compatibles = Import New Users and Profile Updates, Push New Users, Push Profile Updates
    • Modo de autenticación = OAuth 2
    • Tipo de concesión = Authorization Code
    • URI del punto de conexión del token de acceso = copia la URL del token de la configuración del espacio de trabajo de Read AI
    • URI del punto de conexión de autorización = copia la URL de autorización de la configuración del espacio de trabajo de Read AI
    • ID de cliente = copia el ID de cliente de la configuración del espacio de trabajo de Read AI
    • Secreto de cliente = copia el secreto de cliente de la configuración del espacio de trabajo de Read AI

  4. Haz clic en Guardar cuando hayas proporcionado todos los detalles; Okta probará automáticamente la configuración.

  5. Haz clic en Autenticar con [la etiqueta de tu aplicación], lo que iniciará el proceso de autorización en Read AI. Permite que continúe el acceso.

Paso 4: Asignación de atributos

El siguiente paso consiste en configurar qué atributos se envían realmente a Read AI para los eventos de aprovisionamiento compatibles.

  1. En la configuración de aprovisionamiento, selecciona De la aplicación, edita para habilitar las casillas Crear usuarios, Actualizar atributos de usuario y Desactivar usuarios, y haz clic en Guardar.

  2. Desplázate hacia abajo hasta la sección Asignación de atributos y elimina la asignación de todos los atributos excepto los 5 que se muestran aquí; para ello, haz clic en la X de cada fila:

Paso 5: Selecciona los usuarios y grupos que se sincronizarán

El paso final consiste en "asignar" usuarios a tu aplicación; así es como eliges qué usuarios se aprovisionarán mediante SCIM. 

  1. Ve a la pestaña Asignaciones de tu aplicación y utiliza el botón Asignar a personas .

  2. Busca usuarios y haz clic en Asignar junto a los que quieras agregar. No deberías tener que editar ninguna de las otras propiedades de usuario aquí; solo haz clic en Guardar y volver.

  3. El aprovisionamiento automático comenzará de inmediato y es posible que veas rápidamente un error aquí si Okta puede detectar algún problema con uno de los usuarios. Por ejemplo, si intentas aprovisionar a un usuario que ya está en otro espacio de trabajo, verás un error como este:

  4. Recuerda que solo los usuarios que asignes aquí se aprovisionarán y administrarán mediante SCIM/Okta. Recomendamos asignar en Okta a todos los usuarios a los que quieras dar acceso a Read AI.

Paso 6: Completa y supervisa el aprovisionamiento

  1. El aprovisionamiento debería haber comenzado automáticamente cuando empezaste a asignar usuarios.
  2. El aprovisionamiento se ejecuta automáticamente aproximadamente 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 Okta.
  3. Puedes supervisar el estado de la sincronización y los errores en Okta. También te enviaremos notificaciones por correo electrónico si no se puede aprovisionar a los usuarios por algún motivo.

Notas y solución de problemas

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

Artículos relacionados