Configurar la sincronización de usuario de SCIM con Okta

En esta página se describe cómo configurar la sincronización de usuarios de SCIM (Sistema para la gestión de identidades entre dominios) entre Okta y tu organización de UiPath.

Nota:

Vista previa pública: SCIM User Sync está en vista previa pública.

Requisitos previos

• Una licencia Enterprise o Enterprise Trial para su organización de UiPath.
• Permisos de administrador tanto en tu organización de UiPath como en tu tenant de Okta.
• Una integración funcional del lenguaje de marcado de aserción de seguridad (SAML) de inicio de sesión único (SSO) entre Okta y UiPath. Para obtener instrucciones de configuración, consulta Configurar Okta como tu proveedor de identidad.
• El mismo conjunto de usuarios debe asignarse a las aplicaciones SAML SSO y SCIM.

Antes de empezar

Configura SSO antes de habilitar SCIM. Para una nueva configuración, completa los pasos en este orden:

1. Crea la aplicación en Okta y configura SAML SSO con UiPath. Consulta Configurar Okta como tu proveedor de identidad.
2. Habilita SCIM en UiPath (Paso 1 a continuación).
3. Configura SCIM en Okta (los pasos restantes).

Asignación de atributos

Los siguientes atributos de usuario se sincronizan desde tu proveedor de identidad a UiPath. El atributo SCIM es el valor enviado por Okta; el atributo UiPath es donde se almacena.

Atributo SCIM	Atributo UiPath	Obligatorio
externalId	Identificador de directorio utilizado para hacer coincidir y vincular al usuario	Sí
userName	Nombre de usuario	Sí
displayName	Nombre para mostrar	Sí
emails[type eq "work"].value	Correo electrónico
name.givenName	Nombre
name.familyName	Apellidos
title	Puesto de trabajo
addresses[type eq "work"].locality	Ciudad
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	Departamento
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	Nombre de la compañía

Okta se rellena externalId automáticamente, por lo que no es necesario asignarlo manualmente.

Paso 1: habilita SCIM en UiPath

1. Inicia sesión en cloud.uipath.com utilizando una cuenta con permisos de administrador de la organización.
2. En el menú de la izquierda, selecciona Admin y luego selecciona Seguridad.
3. En Integración de directorios e inicio de sesión único (SSO), selecciona Habilitar SCIM.
4. Selecciona uno de los siguientes métodos de autorización compatibles con Okta:
   • Concesión de código de autorización OAuth2 (recomendado)
   • Token portador de larga duración
5. Si seleccionaste la concesión del código de autorización OAuth2, introduce la URL de redirección (la devolución de llamada OAuth de tu proveedor de identidad). Utiliza la URL de devolución de llamada de la documentación de aprovisionamiento de SCIM de Okta, ya que el valor exacto depende de tu entorno y aplicación de Okta.
6. Selecciona Configurar.
7. Registra los siguientes valores: los necesitarás al configurar Okta. Cópialos exactamente como se muestra en UiPath en lugar de construirlos a mano:
   • URL de SCIM (por ejemplo, https://cloud.uipath.com/{orgId}/identity_/api/scim/v2)
   • Si utilizas la concesión del código de autorización OAuth2:
     • URI del punto final del token de acceso (por ejemplo, https://cloud.uipath.com/{orgId}/identity_/connect/token)
     • URI del punto final de autorización (por ejemplo, https://cloud.uipath.com/{organizationName}/identity_/connect/authorize?scope=PM.Scim&acr_values=tenantName:{organizationName})
     • ID de cliente y secreto de cliente
   • Si utilizas un token al portador de larga duración: valor del token al portador

Nota:

Deje esta pestaña del navegador abierta. No selecciones He completado la configuración del proveedor de identidad hasta que finalices los pasos de las siguientes secciones.

Paso 2: configurar SCIM en Okta

1. Inicia sesión en el portal de administración de Okta utilizando una cuenta con permisos de administrador.
2. Navega a Aplicaciones y selecciona la aplicación Okta utilizada para configurar SAML con UiPath.
3. Habilitar el aprovisionamiento de SCIM:
   1. En la pestaña General , selecciona Editar en Configuración de la aplicación.
   2. En Aprovisionamiento, selecciona SCIM.
   3. Selecciona Guardar.
4. Configura la conexión SCIM:

   1. En la pestaña Aprovisionamiento , selecciona Editar en Integración.

   2. Establece los siguientes campos:

      Campo	Valor
      URL base del conector SCIM	URL de SCIM del paso 1
      Campo de identificador único para usuarios	userName

   3. En Acciones de aprovisionamiento compatibles, selecciona:

      • Importar nuevos usuarios y actualizaciones de perfil
      • Enviar nuevos usuarios
      • Actualizaciones de perfil push

   4. Establece el modo de autenticación:

      OAuth 2 (recomendado)

      Establece Tipo de concesión en Código de autorización y luego completa los campos:

      Campo	Valor
      URI del punto final de autorización	URI del punto final de autorización del paso 1
      URI del punto final del token de acceso	URI del punto final del token de acceso del paso 1
      ID de cliente	ID de cliente del paso 1
      Secreto de cliente	Secreto de cliente del paso 1

      Encabezado HTTP (token al portador)

      Campo	Valor
      Autorización	Valor del token al portador del paso 1

   5. Selecciona Configuración del conector de prueba.

   6. Verifica que la prueba de conexión se haya realizado correctamente.

   7. Selecciona Guardar.

5. Habilitar características de aprovisionamiento:
   1. En la pestaña Aprovisionamiento , selecciona A la aplicación.
   2. Habilita las siguientes opciones:
      • Crear usuarios
      • Actualizar atributos de usuario
      • Desactivar usuarios
   3. Selecciona Guardar.

Paso 3: Completa la configuración en UiPath

Vuelve a la pestaña del navegador UiPath del paso 1 y selecciona He completado la configuración del proveedor de identidad.

Resultado

La sincronización de usuarios de SCIM ahora está activa entre Okta y su organización de UiPath. Los usuarios asignados a la aplicación en Okta se aprovisionarán en UiPath automáticamente, y las actualizaciones posteriores o los eventos de desaprovisionamiento en tu directorio se enviarán a UiPath de forma asíncrona.

Para verificar la configuración, ve a Admin > Seguridad en UiPath y confirma que el estado de SCIM se muestra como habilitado. También puedes navegar a Admin > Cuentas y grupos y confirmar que los usuarios aprovisionados aparecen en el directorio.