Configurar la Integración SAML

Esta característica está disponible con el plan de licencias Enterprise.

La configuración de SAML en UiPath es un proceso integral que mejora la seguridad y la eficiencia de la autenticación. Aprovechando SAML, nuestro sistema facilita el SSO a través de tokens de acceso seguro. En concreto, la plataforma UiPath puede conectarse a cualquier proveedor de identidades (IdP) utilizando el estándar SAML 2.0.

Una vez configurado, los usuarios pueden disfrutar de un acceso seguro e ininterrumpido a múltiples aplicaciones y procesos, lo que reduce las interrupciones de inicio de sesión repetidas. Además, nuestra configuración SAML incluye capacidades de cierre de sesión único (SLO), que permiten cierres de sesión simultáneos en todas tus aplicaciones unificadas bajo tu proveedor de identidad (IdP).

Se recomienda la integración nativa de Azure Active Directory debido a sus características avanzadas. Sin embargo, si cambias a SAML, debes reemplazar manualmente la asignación de roles realizada a través de grupos de directorio con la asignación de roles directa a las cuentas de directorio para mantener tu esquema de acceso sin tener que volver a crearlo desde cero.

Resumen del proceso de configuración

La integración de SAML se ha diseñado de forma que pueda implantarse gradualmente, sin perturbar a los usuarios existentes.

Las principales fases del proceso, descritas con más detalle en esta página, son las siguientes:

1. Limpiar las cuentas de usuario inactivas
2. Configurar la integración SAML
3. Transición de los usuarios existentes para iniciar sesión con el SSO de SAML
4. Configurar los permisos y los robots para los nuevos usuarios
5. Dejar de usa cuentas locales (opcional)

Limitaciones conocidas

• No se pueden buscar cuentas desde tu proveedor de identidades: con la integración SAML, no puedes buscar todos los usuarios y grupos desde tu proveedor de identidades. Solo los usuarios del directorio aprovisionados están disponibles para la búsqueda.

• No se pueden ver los usuarios del directorio a nivel de organización: solo los usuarios locales aparecen a nivel de organización. El aprovisionamiento justo a tiempo añade usuarios de directorio, por lo que no aparecen en la página de gestión de Cuentas y grupos.

• No se puede ver la información de acceso a la API: la visualización de la información de acceso a la API, que te permite autorizar solicitudes de API utilizando una clave de usuario, no está disponible para los usuarios del directorio que inician sesión a través de la integración de SAML.

Requisitos previos

Para configurar la integración de SAML, necesitas:

• Una organización con el plan de licencias Enterprise.

• Permisos de administrador tanto en la organización de UiPath como en tu proveedor de identidades de terceros.

  Si no tienes permisos de administración en tu proveedor de identidad, puedes trabajar con un administrador para completar el proceso de configuración.

• UiPath® Studio y UiPath Assistant versión 2020.10.3 o posterior, para que puedas configurarlos para utilizar la implementación recomendada.

Paso 1. Limpia las cuentas de usuario inactivas

Si tu organización recicla direcciones de correo electrónico, es importante que elimines todas las cuentas de usuario inactivas antes de configurar la integración SAML.

Cuando habilitas la integración, las cuentas locales presentes en la plataforma UiPath pueden vincularse con la cuenta del directorio en el proveedor de identidad externo que utiliza la misma dirección de correo electrónico. Esta vinculación de cuentas se produce cuando el usuario de la cuenta de directorio con la dirección de correo electrónico inicia sesión por primera vez. La identidad de tu proveedor de identidades hereda todos los roles de la cuenta local, para que la transición sea fluida.

Debido a esto, con cuentas locales inactivas presentes en la plataforma UiPath, existe el riesgo de que las cuentas locales y las cuentas de directorio no coincidan, lo que puede provocar una elevación no deseada de los permisos.

Para eliminar las cuentas de usuario inactivas:

1. Inicia sesión como administrador de la organización.
2. Ve a Administración, selecciona tu organización y, a continuación, selecciona Cuentas y grupos. La página Cuentas y grupos para la organización se abrirá en la pestaña Usuarios.
3. Haz clic en el encabezado de la columna Último activo para reordenar los usuarios de modo que los que tengan la fecha más antigua para el último inicio de sesión se muestren en la parte superior. La columna Último activo muestra la fecha del último inicio de sesión del usuario. Pendiente en esta columna significa que el usuario nunca ha iniciado sesión.
4. Haz clic en el icono Eliminar al final de la fila para eliminar la cuenta local de ese usuario.
   
   

   

   
   
5. En el cuadro de diálogo de confirmación, haz clic en Eliminar para confirmar la eliminación de la cuenta de la plataforma UiPath. La cuenta de usuario se elimina de la página.
6. Continúa eliminando todas las cuentas de usuario inactivas de tu organización.

Paso 2. Configura la integración SAML

Ahora debes configurar tanto la plataforma UiPath como tu proveedor de identidad (IdP) para la integración.

Paso 2.1. Obtén los datos del proveedor de servicios SAML

1. Inicia sesión como administrador de la organización.
2. Ve a Administración, selecciona tu organización y, a continuación, selecciona Seguridad. La página Configuración de seguridad para la organización se abrirá en la pestaña Configuración de la autenticación.
3. En Configuración de directorio para SSO, haz clic en Configurar SSO. Se abre la ventana de configuración de SSO , que describe las ventajas y los requisitos previos para la integración.
4. De las dos opciones de SSO, selecciona SAML 2.0. La página de configuración de SAML SSO se abre en la pestaña Configurar proveedor de identidades .
5. En la sección superior de la página, puedes encontrar la información de UiPath necesaria para configurar tu proveedor de identidad: URL de metadatos, URL de servicio de consumidor de afirmaciones, ID de entidad. Cópialos y guárdalos para configurar el proveedor de identidades.
   Importante: Recomendamos encarecidamente utilizar la URL de metadatos de UiPath como parte del proceso de configuración de tu proveedor de identidades. Esto permite actualizaciones automáticas cada vez que iniciamos rotaciones para nuestros certificados de firma, lo que garantiza el funcionamiento ininterrumpido de la plataforma.
   
6. El ID de entidad contiene el ID de la organización de forma predeterminada. Puedes cambiar el formato para utilizar el identificador global (sin ID de organización) utilizando la opción Cambiar formato de ID de entidad . A continuación, en la ventana Cambiar formato de ID de entidad , en el menú desplegable Formato de ID de entidad, selecciona Identificador específico de la organización para utilizar el formato que contiene el ID de la organización, o Identificador global para utilizar el formato que no contiene el ID de la organización. Recomendamos utilizar el identificador específico de la organización, ya que te permite inscribir varias organizaciones de UiPath en tu proveedor de identidad, si alguna vez lo deseas.

Mantén esta pestaña del navegador abierta para más adelante.

Paso 2.2. Configura tu proveedor de identidad

Puedes conectarte a cualquier proveedor de identidades (IdP) de terceros que utilice el estándar SAML 2.0. Aunque la configuración puede variar en función del IdP elegido, hemos validado la configuración para utilizar Okta o PingOne, que puedes utilizar como referencia para configurar la integración.

Configurar Okta como tu proveedor de identidad.

Configurar PingOne como tu proveedor de identidad.

En el caso de otros proveedores de identidad, te recomendamos que sigas su documentación de integración.

Paso 2.3. Configurar su organización

Para habilitar UiPath como proveedor de servicios que reconoce tu proveedor de identidad, sigue los siguientes pasos:

1. Vuelve a la pestaña de configuración SAML SSO en UiPath.
2. En la segunda sección de la página Configurar proveedor de identidades , puedes ver los campos necesarios para configurar el proveedor de identidades en UiPath. En el campo URL de metadatos , introduce la URL de metadatos de tu proveedor de identidad. Esto permite que la plataforma UiPath obtenga y actualice periódicamente los datos de tu proveedor de identidades, lo que agiliza el proceso de configuración de SAML a largo plazo.
   Importante: Recomendamos encarecidamente utilizar la URL de metadatos durante la configuración de SAML. Esto permite a UiPath obtener y actualizar periódicamente los datos de tu proveedor de identidades, lo que agiliza el proceso de configuración de SAML a largo plazo.
   
3. Haz clic en Obtener datos. Una vez completado, los campos URL de inicio de sesión, ID de entidad del proveedor de identidad y certificado de firma se rellenan con la información de IdP.
4. Aunque no es el método recomendado, puedes elegir introducir manualmente los detalles SAML de tu proveedor de identidad en los campos URL de inicio de sesión, ID de entidad del proveedor de identidad y Certificados de firma .
5. Haz clic en Siguiente en la esquina inferior derecha para pasar al siguiente paso. Accederás a la pestaña Atributos del mapa y completo . Asignación de atributos en los detalles del usuario de los enlaces, denominados "reclamaciones", entre tu proveedor de identidad y UiPath. Esto garantiza que los datos del usuario, como un correo electrónico o un nombre de usuario, coincidan en ambos sistemas.
   
6. En el paso Asignar atributos y completar , selecciona la opción Habilitar el identificador único personalizado para configurar un identificador único que no sea un correo electrónico. Esto es útil, por ejemplo, si no todos los usuarios tienen cuentas de correo electrónico o si sus direcciones de correo electrónico no son únicas.
   Advertencia: Una vez que hayas establecido un nombre de reclamación de identificador único , cambiarlo puede provocar la pérdida de usuarios previamente reconocidos, ya que es posible que el sistema ya no pueda identificarlos. Como tal, la IU restringe el cambio de la reclamación del identificador único una vez que se ha establecido. Para cambiarlo, debes eliminar y volver a crear toda tu configuración.
   1. Es obligatorio introducir el identificador único de tus usuarios en el campo Identificador único . Esta es la notificación que utiliza UiPath para identificar a los usuarios cuando inician sesión.
   2. En el campo Nombre para mostrar , introduce la notificación por la que tus usuarios pueden ser reconocidos al iniciar sesión.
   3. Se vuelve opcional introducir el campo Correo electrónico para tus usuarios. Puedes rellenarlo como mejor te parezca.
   4. El campo Dominios de direcciones de correo electrónico permitidos está atenuado y no está disponible para su entrada. Esto se debe a que el sistema ya no utiliza el correo electrónico como identificador único, lo que hace que este campo sea irrelevante.
   5. Opcionalmente, añade nuevas asignaciones, especificando la reclamación respectiva del proveedor de identidades y el atributo correspondiente en UiPath.
7. De forma predeterminada, la opción Habilitar el identificador único personalizado está desactivada, lo que significa que la dirección de correo electrónico se utiliza como identificador de los usuarios. Sigue estos pasos:
   1. En el campo Nombre para mostrar , introduce la notificación por la que tus usuarios pueden ser reconocidos al iniciar sesión.
   2. El campo Correo electrónico se vuelve obligatorio y no se puede cambiar.
   3. Rellena la sección Dominios permitidos con los dominios desde los que quieres permitir acceder a los usuarios. Introduce todos los dominios admitidos por el proveedor de identidad configurado. Separa los dominios múltiples con comas.
   4. En Asignación de atributos, rellena el campo Nombre para mostrar con el atributo de tu IdP que quieres mostrar en la plataforma UiPath como nombre para los usuarios. Puedes utilizar los atributos Nombre y Apellido aquí.
   5. Opcionalmente, añade nuevas asignaciones, especificando la reclamación respectiva del proveedor de identidades y el atributo correspondiente en UiPath.
8. Una vez que hayas configurado los atributos, configura los campos Permitir respuesta de autenticación no solicitada y Tipo de enlace SAML .
   1. Permitir respuesta de autenticación no solicitada: habilite si desea poder navegar a la plataforma UiPath desde el panel de IdP.
   2. Tipo de enlace SAML: seleccionar cómo debe comunicarse la configuración SAML, a través del agente de usuario HTTP. Selecciona redireccionamiento HTTP para utilizar los parámetros de la URL, o publicación HTTP para usar un formulario HTML con contenido codificado en base64.
9. Si tu proveedor de identidad requiere que UiPath firme todas las solicitudes de autenticación SAML, selecciona la opción Firmar solicitud de autenticación . Consulta con tu proveedor de identidades para determinar si es necesario habilitar esta característica. UiPath suele actualizar sus claves de firma. Si has activado la función Firmar solicitud de autenticación , asegúrate de que tu IdP se sincroniza regularmente con UiPath descargando continuamente las claves actualizadas de la URL de metadatos de UiPath.
10. Haz clic en Probar y guardar para terminar de configurar la integración.

Paso 2.4. Comprueba que la integración se está ejecutando

Para validar que la integración de SSO de SAML funcione correctamente:

1. Abre una ventana de incógnito en el navegador.
2. Dirígete a la URL de tu organización.
3. Comprueba las siguientes cuestiones:
   1. ¿Se te pide que inicies sesión con tu proveedor de identidad SAML?
   2. ¿Puedes iniciar la sesión con éxito?
   3. Si te estás registrando con una dirección de correo electrónico que coincide con una cuenta de usuario existente, ¿tienes los permisos adecuados?

Paso 2.5. Configurar las reglas de aprovisionamiento (opcional)

Si utilizas reclamaciones en tu IdP, puedes aprovecharlas como condiciones en una regla de aprovisionamiento para que los usuarios reciban automáticamente las licencias y roles correctos cuando inicien sesión en la plataforma UiPath. Las reglas de aprovisionamiento se evalúan cuando un usuario inicia sesión. Si la cuenta de usuario cumple las condiciones de una regla, se añade automáticamente al grupo local de UiPath asociado a la regla.

Fase 1. Crear grupos de aprovisionamiento

En la plataforma UiPath, añadir una cuenta a un grupo significa que la cuenta hereda las licencias, los roles y la configuración del robot definidos para el grupo, si los hubiera.

Al agrupar tipos de cuentas similares (por ejemplo, desarrolladores o probadores), puedes agilizar el proceso de incorporación de usuarios a la plataforma UiPath. Solo asegúrate de que en el IdP configuras cuentas similares de la misma manera.

De esta manera, configuras el grupo una vez y luego replicas la configuración añadiendo cuentas al grupo cuando sea necesario. Si es necesario cambiar la configuración de un grupo de cuentas en particular, solo tendrás que actualizar el grupo una vez y los cambios se aplicarán a todas las cuentas del grupo.

Para configurar un grupo para una regla de aprovisionamiento:

1. Crea un nuevo grupo local en la plataforma UiPath.

   Si quieres, puedes usar uno de tus grupos existentes en lugar de crear uno nuevo.

2. (Opcional y requiere la gestión de licencias de usuario ) Si las cuentas de este grupo necesitan licencias de usuario, configura las reglas de asignación de licencias para el grupo.

   Si utilizas un grupo existente, comprueba la asignación de licencias para el grupo para asegurarte de que se asignan las licencias correctas. Si no es así, cambia las asignaciones o considera la posibilidad de crear un nuevo grupo.

3. Asigna roles de tenant y, opcionalmente, completa la configuración del robot para el grupo. Para obtener instrucciones, consulta Asignar roles a un grupo .

   Si utilizas un grupo existente, comprueba los roles actualmente asignados al grupo para asegurarte de que son adecuados para el tipo de cuenta que añadirás al grupo. Si no es así, edita los roles asignados a este grupo o considera la posibilidad de crear un nuevo grupo.

4. Agrega el grupo a las carpetas y asigna los roles de las carpetas, según sea necesario. Para obtener más instrucciones, consulta Gestión de acceso a carpetas.

Ahora puedes usar este grupo en una regla de aprovisionamiento.

Fase 2. Crear una regla de aprovisionamiento para un grupo

Nota:

Asegúrate de que la reclamación asociada a la regla de aprovisionamiento SAML se envíe a la carga útil SAML configurándola en la aplicación SAML.

Una vez configurada la integración SAML y tras haber configurado un grupo:

1. Ve a Administración, selecciona tu organización y, a continuación, selecciona Seguridad.

   La página Configuración de seguridad para la organización se abrirá en la pestaña Configuración de la autenticación.

2. En la opción de SSO de SAML, haz clic en Ver reglas de aprovisionamiento:

   Se abre la página Reglas de aprovisionamiento de SSO de SAML, donde se listan tus reglas existentes.

3. En la esquina superior derecha de la página, haz clic en Añadir regla.

   Se abre la página Añadir nueva regla.

4. En Detalles básicos, rellena el campo Nombre de la regla y, opcionalmente, rellena el campo Descripción.

5. En Condiciones, haz clic en Añadir regla.

   Se añade una fila de campos para una nueva condición. Conjuntamente, definen los criterios que debe cumplir una cuenta al iniciar la sesión para añadirse a un grupo (elegido más tarde).

   
   

   

   
   
6. En el campo Reclamación , escribe el nombre de la reclamación, tal como aparece en el IdP. La

   campo distingue entre mayúsculas y minúsculas.

7. En la lista Relación, selecciona la relación de la reclamación con el valor. Las siguientes opciones están disponibles:

   Relación	Requisito de condición	Ejemplo
   es	coincidencia exacta, distingue entre mayúsculas y minúsculas	Department is RPA requiere que el valor de la solicitud Department sea RPA. La condición no se cumple si el valor es RPADev, por ejemplo. Esta relación funciona para las reclamaciones multivalor. Por ejemplo, si los valores administrator y developer se envían bajo la reclamación Group, entonces Group is administrator sería una relación válida.
   no es	cualquier cosa, excepto el valor especificado; distingue entre mayúsculas y minúsculas	Para Department is not ctr, cualquier cuenta se añade al grupo a menos que Department tenga el valor ctr. La condición se cumple si el departamento es Ctro electr.
   contiene	incluye; no requiere una coincidencia exacta; distingue entre mayúsculas y minúsculas	Department contains RPA requiere que el valor de la solicitud Department incluya RPA. La condición se cumple si el valor es RPADev, xRPAx o NewRPA, por ejemplo.
   no contiene	excluye; no requiere una coincidencia exacta; distingue entre mayúsculas y minúsculas	Para Department not contains ctr, cualquier cuenta se añade al grupo a menos que el valor Department incluya ctr. Las cuentas cuyo departamento es ctr o electr, por ejemplo, no se añaden al grupo.
   distingue entre mayúsculas y minúsculas	coincidencia exacta; sin distinción de mayúsculas y minúsculas	Department is case insensitive RPA requiere que el valor de la solicitud Department sea rpa, con cualquier uso de mayúsculas. La condición se cumple si el valor es rpa, por ejemplo. La condición no se cumple si el valor es crpa.
   contiene mayúsculas y minúsculas	incluye; no requiere una coincidencia exacta; no distingue entre mayúsculas y minúsculas	Department contains case insensitive RPA requiere que el valor de la solicitud Department incluya RPA, con cualquier uso de mayúsculas. La condición se cumple si el valor es rpa, cRPA o rpA, por ejemplo.

8. En el campo Valor, escribe el valor necesario para cumplir la condición.

9. Si deseas añadir otra condición, haz clic en Añadir regla para añadir una nueva fila de condiciones.

   Cuando se añaden varias condiciones, deben cumplirse todas las condiciones para que se aplique la regla de aprovisionamiento. Por ejemplo, si se definen las reglas Department is RPA y Title is Engineer, solo se añadirán a los grupos especificados los usuarios que estén en el departamento de RPA y tengan el título de Ingeniero. Una cuenta cuyo departamento es RPA, pero cuyo título es QA, no se añade a los grupos.

10. En Asignar a grupos, en el recuadro Añadir grupos, comienza a escribir el nombre de un grupo y luego selecciona un grupo de la lista de resultados. Repite la operación para añadir más grupos, si es necesario.

    Cuando se cumplen las condiciones, las cuentas se añaden automáticamente a estos grupos cuando se conectan.

11. Haz clic en Guardar en la esquina inferior derecha para añadir la regla.

Con una regla establecida, cada vez que un usuario inicia sesión y su cuenta cumple las condiciones especificadas para una regla, su cuenta se añade a los grupos de aprovisionamiento asociados a la regla, y su cuenta se configura para funcionar en la plataforma UiPath.

Fragmento de carga útil SAML de muestra

<Attribute 
   Name="groups"> 
<AttributeValue 
          xmlns:xs="http://www.w3.org/2001/XMLSchema"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:type="xs:string">ProcessAutomation-Developer</AttributeValue>

Asignación de atributos SAML

Al configurar la integración del directorio SAML, los administradores de la organización tienen la capacidad de definir qué atributos de su IdP deben asignarse a los atributos de usuario del sistema. Posteriormente, cuando un usuario inicie sesión a través de la integración del directorio SAML, el sistema leerá las reclamaciones que se pasan a la carga útil de ACS y asignará el valor a sus atributos del sistema correspondientes.

Nota:

• Tu IdP debe estar configurado para pasar estas reclamaciones en la carga útil de ACS.

• Asegúrate de que los nombres de atributos configurados en el IdP coincidan con la configuración de asignación de atributos en el portal de administrador de la organización.

Por ejemplo, si esta es la estructura de usuario en tu IdP, un administrador de la organización puede configurar la siguiente configuración de asignación de atributos para que esta información se rellena en el objeto de usuario del sistema.

{  
    "displayname": "John Doe",  
    "fname": "John",  
    "lname": "Doe",  
    "jobtitle": "Hardware Engineer",  
    "dpt": "Engineering",  
    "city": "Phoenix" 
}

Cuando un usuario en esta organización inicia sesión a través de la integración del directorio SAML, su objeto de usuario se actualiza para reflejar esta configuración.

{  
    "Display Name": "John Doe",  
    "First Name": "John",  
    "Last Name": "Doe",  
    "Job Title": "Hardware Engineer",  
    "Department": "Engineering",  
    "City": "Phoenix" 
}

Paso 3. Transiciona a tus usuarios a SSO de SAML

Asegúrese de proporcionar la URL específica de su organización para la organización de UiPath a todos sus usuarios.

Nota:

Después de cambiar a la integración SAML, la integración de Azure AD está deshabilitada. Las asignaciones de grupos de Azure AD ya no se aplican, por lo que la pertenencia a grupos de UiPath y los permisos heredados de Azure AD ya no se respetan.

Para iniciar sesión en la plataforma UiPath con SAML SSO, los usuarios pueden:

• navegar hasta la URL específica de tu organización. La URL debe incluir el ID de la organización y terminar en una barra diagonal, como por ejemplo https://cloud.uipath.com/orgID.
• navega a https://cloud.uipath.com, selecciona Continuar con SSO en la página de inicio de sesión, y luego proporciona la URL específica de su organización.

Para iniciar sesión en UiPath Studio y UiPath Assistant mediante el SSO de SAML, los usuarios deben configurar UiPath Assistant de la siguiente manera:

1. En Assistant, abre Preferencias y selecciona la pestaña Conexión de Orchestrator.
2. Haz clic en Cerrar sesión.
3. Para el tipo de conexión, selecciona URL de servicio.
4. En el campo URL del servicio, añade la URL específica de la organización.
   La URL debe incluir el ID de la organización y terminar en una barra diagonal, como por ejemplo https://cloud.uipath.com/orgID. De lo contrario, la conexión falla diciendo que el usuario no pertenece a ninguna organización.
5. Vuelve a iniciar sesión con el SSO de SAML.

Paso. 4. Configura los Permisos y los Robots

Esto solo es necesario para los nuevos usuarios que no hayan utilizado la plataforma UiPath antes y, por lo tanto, no tenían una cuenta local configurada para ellos en UiPath cuando se habilitó la integración.

Puedes añadir nuevos usuarios a los grupos de UiPath por su dirección de correo electrónico (como se utiliza en el IdP externo). Una vez que un usuario haya sido asignado a un grupo o haya iniciado sesión, estará disponible a través de la búsqueda de asignación de roles en todos los servicios de UiPath.

Paso 5. Interrumpir el uso de cuentas locales (opcional)

Cuando todos los usuarios hayan hecho la transición al SSO de SAML y se hayan configurado los nuevos usuarios, se recomienda eliminar todas las cuentas de usuario locales que no sean cuentas de administrador. Esto garantiza que los usuarios ya no puedan iniciar sesión con las credenciales de su cuenta local y tengan que iniciar sesión con el SSO de SAML.

Puedes identificar las cuentas de usuario locales en función de sus iconos.

Una cuenta local puede ser útil en los siguientes escenarios:

• Para gestionar problemas de integración de SAML (por ejemplo, actualizar un certificado caducado) o si se cambia la configuración de autenticación, se recomienda una cuenta con el rol de administrador de la organización.

• Para los procesos que dependen de los tokens de acceso a la API para solicitar autorizaciones, ya que la funcionalidad de acceso a la API (en la página Admin > Tenants ) es inaccesible con una cuenta SAML SSO. Alternativamente, cambia a usar OAuth para la autorización, lo que elimina la necesidad de la información de acceso a la API.