Saltar al contenido principal

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

Actualización

Esta página explica cómo configurar el aprovisionamiento de usuarios con SCIM mediante el método de autenticación Código de autorización, que es obligatorio para Okta. 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 credenciales de cliente (Microsoft Entra) 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: 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 Okta SAML, puedes reutilizarla y pasar al Paso 2.

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

  2. Haz clic en Create App Integration.

  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 siguientes muestran cómo se ve para SAML 2.0, pero también podrías utilizar SWA: Secure Web Authentication.

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

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

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

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

Paso 2: Genera las credenciales de SCIM en Read AI

Los pasos siguientes se realizan en Read AI.

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

  2. Activa la opción Enable SCIM provisioning.

  3. Selecciona la opción OAuth 2.0 Authorization Code.

  4. Añade 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 se encuentra 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 añadir según tu situación, consulta la documentación de Okta.

  5. Haz clic en Generate Credentials para obtener tu Client ID y Client Secret (cópialos; el secreto solo se muestra una vez y tendrás que generarlo de nuevo si lo pierdes).

  6. Anota también la Authorization URL, la Tenant URL y la Token URL, ya que también 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 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 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 App Settings para habilitar el aprovisionamiento mediante SCIM y haz clic en guardar.

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

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

    • SCIM connector base URL = copia la Tenant URL de la configuración del espacio de trabajo de Read AI
    • Unique identifier field for users = userName
    • Supported provisioning actions = Import New Users and Profile Updates, Push New Users, Push Profile Updates
    • Authentication Mode = OAuth 2
    • Grant Type = Authorization Code
    • Access token endpoint URI = copia la Token URL de la configuración del espacio de trabajo de Read AI
    • Authorization endpoint URI = copia la Authorization URL de la configuración del espacio de trabajo de Read AI
    • Client ID = copia el Client ID de la configuración del espacio de trabajo de Read AI
    • Client Secret = copia el Client Secret de la configuración del espacio de trabajo de Read AI

  4. Haz clic en Save después de proporcionar todos los detalles; Okta probará automáticamente la configuración.

  5. Haz clic en Authenticate with [your app's label]; esto iniciará el proceso de autorización en Read AI. Permite el acceso para continuar.

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 To App, edita para habilitar las casillas Create Users, Update User Attributes y Deactivate Users, y haz clic en guardar.

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

Paso 5: Asigna usuarios para sincronizarlos

El paso final consiste en "asignar" usuarios a tu aplicación, que es la forma de elegir qué usuarios aprovisionará SCIM.

  1. Ve a la pestaña Assignments de tu aplicación y utiliza el botón Assign to People.

  2. Busca usuarios y haz clic en Assign junto a los que quieras añadir. No debería ser necesario editar ninguna de las otras propiedades de usuario aquí; solo haz clic en Save and Go Back.

  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í serán aprovisionados y administrados por SCIM/Okta. Recomendamos asignar en Okta a todos los usuarios que quieras que tengan acceso a Read AI.

Nota: Actualmente, el aprovisionamiento de equipos solo está disponible para Microsoft Entra. Puedes asignar usuarios a la aplicación mediante grupos de Okta, pero esos grupos no se crearán como equipos en Read AI. Cada miembro se aprovisiona como un usuario individual y puedes administrar los equipos en Read AI como de costumbre.

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

Artículos relacionados