Configurar la Integración SAML

Orchestrator puede conectarse a cualquier proveedor de identidades (IdP) que utilice la norma SAML 2.0. En esta página se describe el proceso general mostrando algunas configuraciones de integración SAML de ejemplo.

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

• Las aserciones SAML cifradas de tu proveedor de identidad no son compatibles.

• No puedes buscar usuarios y grupos desde tu proveedor de identidades. Solo los usuarios del directorio aprovisionados están disponibles para la búsqueda.

• The SAML SSO Configuration page displays an incorrect Assertion Customer Service URL.

  Workaround: To address this issue, configure the Assertion Customer Service URL in the IDP without the partition ID. For example, the original URL: https://{your-domain}/91483651-d8d6-4673-bd3f-54b0f7dc513a/identity_/Saml2/Acs would become https://{your-domain}/identity_/Saml2/Acs

  Nota:

  Esta solución presenta dos advertencias:

  • Los flujos de inicio de sesión iniciados por IDP no funcionarán como está previsto.
  • Este problema se ha solucionado en la versión 2023.4. Al actualizar a 2023.4+ tendrás que cambiar la URL de afirmación del servicio de atención al cliente para incluir el ID de la partición.

Requisitos previos

Para configurar la integración de SAML, necesitas:

• Los permisos de administrador tanto en Orchestrator 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.

  Nota:

  If you are currently using the Azure Active Directory integration for authentication, we recommend remaining on the AAD integration because it is more feature-rich.

  Si decides cambiar la integración de AAD, debes reemplazar manualmente la asignación de roles realizada a través de los grupos del directorio con la asignación directa de roles a las cuentas de directorio para no tener que recrear completamente tu esquema de acceso.

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.

Al habilitar la integración, las cuentas locales presentes en Orchestrator pueden vincularse con la cuenta del directorio en el proveedor de identidades 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 inicia sesión por primera vez con la dirección de correo electrónico. La identidad de tu proveedor de identidades hereda los roles que tenía la cuenta local de forma que la transición sea perfecta.

Debido a esto, con las cuentas locales inactivas presentes en Orchestrator, existe el riesgo de que las cuentas locales y las cuentas de directorio no coincidan, lo que puede conllevar una elevación involuntaria de los permisos.

Para eliminar las cuentas de usuario inactivas:

1. Inicia sesión en Orchestrator como administrador.

2. Dirígete a la pestaña Administración > Cuentas y grupos > Usuarios.

3. Haz clic en el encabezado de la columna Activo por última vez para reordenar los usuarios de forma que los que tengan la fecha más antigua de último inicio de sesión se muestren en la parte superior:

   

   La columna Última actividad muestra la fecha en que el usuario se conectó por última vez a Orchestrator. Si aparece "Pendiente" en esta columna, como en el ejemplo anterior, significa que el usuario nunca se ha conectado. Esta información te ayudará a identificar a tus usuarios inactivos.

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

   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 Orchestrator como tu proveedor de identidades (IdP) para la integración.

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

1. Inicia sesión en Orchestrator como administrador.

2. Dirígete a Administración > Configuración de seguridad > Configuración de autenticación.

3. Selecciona Los usuarios pueden iniciar sesión con el SSO de SAML y luego haz clic en Configurar.

   Se abre un diálogo de información.

4. En el diálogo, haz clic en Continuar.

   La siguiente página ofrece la información general de la integración.

5. En la esquina inferior derecha, haz clic en Siguiente para proceder a la configuración.

   En el paso Detalles generales, en Datos a configurar en IdP, proporcionamos la información necesaria para configurar tu proveedor de identidades para conectarte a Orchestrator.

   

6. Copia y guarda los valores de ID de entidad y URL de servicio al consumidor de afirmaciones. Los necesitarás en el siguiente paso.

   Importante:

   Si también has configurado esta integración en el nivel de host, asegúrate de que estás utilizando el valor de la URL de servicio al consumidor de afirmaciones en el nivel de organización y no el del host.

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

Paso 2.2. Configura tu proveedor de identidad

Orchestrator puede conectarse a cualquier proveedor de identidades (IdP) de terceros que utilice la norma SAML 2.0.

Si bien la configuración puede variar según el IdP elegido, hemos validado la configuración para los siguientes proveedores:

• OKTA
• PingOne.

Puedes usar las siguientes instrucciones de configuración para configurar integraciones con estos proveedores.

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

A. Ejemplo de configuración para Okta

Nota:

Las instrucciones de esta sección son para una configuración de muestra. Para obtener más información sobre cualquier configuración de IdP que no se haya tratado aquí, usa la documentación de Okta.

1. En otra pestaña del navegador, inicia sesión en la consola de administración de Okta.
2. Dirígete a Aplicaciones > Aplicaciones, haz clic en Crear integración de aplicaciones y selecciona SAML 2.0 como método de inicio de sesión.
3. En la página Configuración general, especifica un nombre para la aplicación con la que te estás integrando, concretamente Orchestrator.
4. En la página Configurar SAML, rellena la sección General de la siguiente manera:
   1. URL de inicio de sesión único: introduce el valor de la URL de servicio al consumidor de afirmaciones que obtuviste de Orchestrator.
   2. Marque la casilla Usar esto para la URL del destinatario y la URL del destino.
   3. URI de audiencia: introduce el valor de ID de entidad que obtuviste de Orchestrator.
   4. Formato de ID del nombre: Selecciona correo electrónico
   5. Nombre de usuario de la aplicación: Selecciona correo electrónico
5. En Declaraciones de atributos, añade lo siguiente:
   1. Nombre: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
   2. Deja el Formato de nombre como No especificado.
   3. Establece Valor en user.email o el atributo de usuario que contiene la dirección de correo electrónico única del usuario.
   4. También puedes añadir otras asignaciones de atributos. Orchestrator también admite los atributos de usuario Nombre, Apellido, Cargo y Departamento. Esta información se propaga a Orchestrator, donde puede ponerse a disposición de otros servicios, como Automation Hub.
6. En la página de Comentarios, selecciona la opción que prefieras.
7. Haz clic en Finalizar.
8. En la pestaña Inicio de sesión, en la sección Configuración, en Ver instrucciones de configuración, copia el valor URL de los metadatos del proveedor de identidades y guárdalo para más adelante.
9. En la página Aplicación para Orchestrator, selecciona la aplicación recién creada.
10. En la pestaña Asignaciones, selecciona Asignar > Asignar a personas, y, a continuación, selecciona los usuarios a los que deseas permitir el uso de la autenticación SAML para Orchestrator.

Los usuarios recién añadido se muestran en la pestaña Personas.

B. Ejemplo de configuración para PingOne

Nota:

The instructions in this section are for a sample configuration. For more information about any IdP settings not covered here, please use the PingOne documentation.

1. En otra pestaña del navegador, inicia sesión en la consola de administración de Ping One.

2. Dirígete a Conexiones > Aplicaciones y haz clic en el icono más +.

3. Haz clic en Aplicación web y, para SAML, haz clic en Configurar.

4. En la página Crear perfil de aplicación, especifica un nombre para tu aplicación de Orchestrator.

5. En la página Configurar conexión SAML, selecciona Introducir manualmente y proporciona los siguientes datos:

   • URL del ACS: introduce el valor de URL de servicio al consumidor de afirmaciones que obtuviste de Orchestrator.
   • ID de entidad: introduce el valor de ID de entidad que obtuviste de Orchestrator.
   • Enlace SLO: redirección HTTP
   • Duración de la validación: el número de segundos para el período de validez

6. Haz clic en Guardar y continuar.

7. En la página de Atributos de mapa, añade la dirección de correo electrónico:

   1. Selecciona + Añadir atributo.
   2. Para Atributo de aplicación, introduce http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress.
   3. Establece Valor de salida en Dirección de correo electrónico, o el atributo de usuario que contiene la dirección de correo electrónico única del usuario.
   4. Selecciona la casilla Requerido.
   5. También puedes añadir otras asignaciones de atributos. Orchestrator también admite los atributos de usuario Nombre, Apellido, Cargo y Departamento. Esta información se propaga a Orchestrator, donde puede ponerse a disposición de otros servicios, como Automation Hub.

8. Haz clic en Guardar y cerrar.

9. Haz clic en el botón de la aplicación Orchestrator para habilitar el acceso de los usuarios a la aplicación.

10. En la pestaña Configuración, copia y guarda el valor URL de metadata de IdP para su uso posterior.

Paso 2.3. Configurar Orchestrator

Para habilitar Orchestrator como proveedor de servicios que reconoce a tu proveedor de identidades, completa los pasos siguientes:

1. Regresa a la pestaña Configuración de SAML en Orchestrator.

2. En el paso Detalles generales, en Datos de IdP, rellena el campo URL de metadatos con la URL de metadatos obtenida durante la configuración.

3. Haz clic en Obtener datos.

   When complete, the Sign-on URL,Identity Provider Entity ID, and Signing certificate fields are populated with the IdP information.

4. Haz clic en Siguiente en la esquina inferior derecha para pasar al siguiente paso.

5. En la sección Configuración del aprovisionamiento, rellena la sección Dominios permitidos con los dominios desde los que deseas permitir el acceso a los usuarios. Introduce todos los dominios admitidos por el proveedor de identidad configurado.

   Separa los dominios múltiples con comas.

6. Marca la casilla para indicar que entiendes que las cuentas con direcciones de correo electrónico coincidentes serán vinculadas.

7. Opcionalmente, rellena Asignación de atributos.

8. Si deseas configurar también los detalles avanzados, haz clic en Siguiente en la esquina inferior derecha para avanzar al último paso.

   De lo contrario, haz clic en Probar y guardar para terminar de configurar la integración y omitir los pasos restantes de esta sección.

9. En la página Configuración avanzada, configura las opciones según sea necesario:

   • Permitir respuesta de autenticación no solicitada: habilita esta opción si deseas poder navegar a Orchestrator desde el panel IdP.
   • Tipo de enlace SAML: Redireccionamiento HTTP configura la configuración de SAML para comunicarse usando parámetros de URL a través del agente de usuario HTTP.
   • Uso del certificado de servicio: selecciona la opción que prefieras.

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. Ve a la URL de tu Orchestrator.
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)

Los administradores pueden configurar reglas de aprovisionamiento mientras añaden usuarios a un grupo existente de UiPath utilizando los pares de atributos nombre/valor proporcionados por el IdP mediante el inicio de sesión. Al aprovechar los grupos, los usuarios reciben automáticamente las licencias y funciones correctas al iniciar sesión.

Las reglas de aprovisionamiento just-in-time se evalúan cuando un usuario inicia sesión. Si la cuenta de usuario cumple las condiciones para una regla, se añade automáticamente al grupo local asociado con la regla.

Por ejemplo, un Administrator puede configurar una regla para aprovisionar usuarios directamente en el grupo Automation Users utilizando esta configuración: Claim=group, Relationship=is, Value=Automation User.

Fase 1. Crear grupos de aprovisionamiento

Al añadir una cuenta a un grupo, la cuenta hereda las licencias, los roles y la configuración del UiPath Robot definidos para el grupo, si los hubiera.

Por lo tanto, si configuras un grupo con un tipo particular de usuario en mente (por ejemplo, tus empleados que crean las automatizaciones, o tus empleados que prueban las automatizaciones), puedes incorporar un nuevo empleado de ese tipo configurando su cuenta en el IdP de la misma manera que otras cuentas similares.

De esta manera, se configura el grupo una vez, y luego se replica la configuración añadiendo cuentas al grupo cuando sea necesario. Además, si es necesario cambiar la configuración de un determinado grupo de usuarios, solo hay que actualizar el grupo una vez y los cambios se aplican a todas las cuentas del grupo.

Para configurar un grupo para una regla de aprovisionamiento:

1. Create a new local group.

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

2. (Optional and requires user license management) If users in this group need user licenses, set up license allocation rules for the group.

   If you are using an existing group, check license allocation for the group to make sure the right licenses are being allocated. If not, either change allocations, or consider creating a new group.

3. Assign tenant roles and optionally complete robot setup for the group. See Assigning roles to a group.

   If you are using an existing group, check the roles currently assigned to the group to make sure they are adequate for the type of users you will add to the group. If not, either edit the roles assigned to this group, or consider creating a new group.

4. Añade el grupo a las carpetas y asigna roles de carpeta, según sea necesario. Consulta Gestionar el 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. Dirígete a Administración > Configuración de seguridad > Configuración de 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 Solicitar, escriba el nombre de la solicitud, tal como aparece en el IdP.

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, siempre que un usuario inicie sesión y su cuenta cumpla las condiciones especificadas para una regla, su cuenta se añade a los grupos de aprovisionamiento adjuntos a la regla, y su cuenta se configura para trabajar.

Paso 3. Transiciona a tus usuarios a SSO de SAML

Una vez configurados los permisos, te recomendamos que pidas a todos tus usuarios actuales que salgan de su cuenta de UiPath e inicien sesión mediante el SSO de SAML.

Para iniciar sesión en 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://OrchestratorURL/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 han utilizado Orchestrator antes y, por lo tanto, no tenían una cuenta local configurada para ellos en Orchestrator cuando se habilitó la integración.

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

Paso 5. Deja de usar las cuentas de usuario 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.

Consideraciones para dejar de usar las cuentas locales

En caso de problemas con la integración de SAML (como la actualización de un certificado caducado), o si deseas cambiar a una opción de autenticación diferente, se recomienda una cuenta de usuario local con el rol de administrador.

Solución de problemas

Si obtienes el error User login failed. (#216), puede deberse a la falta de asignación de direcciones de correo electrónico en la configuración del proveedor de identidad SAML.

La declaración SAML debe contener el nombre http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress y el valor debe tener una dirección de correo electrónico válida.