automation-suite
2023.10
false
UiPath logo, featuring letters U and I in white
Guía de administración de Automation Suite
Last updated 14 de ago. de 2024

Configurar la integración de Azure AD

Información general

Si su organización utiliza Azure Active Directory (Azure AD) u Office 365, puede conectar su organización de Automation Suite directamente a su tenant de Azure AD para ver las cuentas de usuario existentes en su entorno de nube de UiPath®.

La integración de Azure AD le permite seguir aprovechando el modelo de usuario local, si así lo desea, a la vez que impulsa su organización con las ventajas adicionales de utilizar el modelo de Azure AD. Para obtener más información sobre las diferencias, consulta Autoridad sobre cuentas y grupos.

Si ha decidido usar Azure AD para su organización, siga las instrucciones de esta página para configurar la integración.

Tip: La integración de Azure AD está diseñada de tal manera que su activación y despliegue puede realizarse gradualmente, sin interrumpir la producción de los usuarios existentes.

Requisitos previos

Para configurar la integración de Azure AD, necesitas:

  • permisos de administrador tanto en Automation Suite como en Azure AD (si no tiene permisos de administrador en Azure, colabore con un administrador de Azure para completar el proceso de configuración);
  • una cuenta UiPath de administrador de la organización que utiliza la misma dirección de correo electrónico que un usuario de Azure AD; el usuario de Azure AD no requiere permisos de administrador en Azure;
  • UiPath Studio y Assistant versión 2020.10.3 o posterior;
  • UiPath Studio y Assistant para utilizar la implementación recomendada .
  • si utilizaste anteriormente cuentas de usuario locales , asegúrate de que todos tus usuarios de Azure AD tengan la dirección de correo electrónico en el campo Correo; tener la dirección de correo electrónico en el campo Nombre principal del usuario (UPN) solo no es suficiente. La integración de Azure AD vincula las cuentas de usuarios del directorio con las cuentas de usuarios locales si las direcciones de correo electrónico coinciden. Esto permite a los usuarios conservar los permisos cuando pasan de iniciar sesión con su cuenta de usuario local a hacerlo con la cuenta de usuario del directorio de Azure AD.
Nota: UiPath sigue el protocolo OIDC para su integración con Azure Active Directory. Sin embargo, la integración no admite el uso de claves personalizadas de la aplicación mediante la solicitud de un parámetro de consulta appid en una URL dedicada, como se describe en la documentación de los tokens de acceso de Microsoft .

Cómo configurar Azure para la integración

Tu organización requiere un registro de aplicación en tu tenant de Azure AD y algo de configuración para que pueda ver tus miembros de AD para establecer la identidad de la cuenta. Los detalles de registro de la aplicación también son necesarios para conectar posteriormente tu organización a tu tenant de Azure AD.

Permisos: debe ser administrador en Azure para realizar las tareas de esta sección. Los siguientes roles de administrador de Azure tienen los privilegios necesarios: Administrador global, Administrador de aplicaciones en la nube o Administrador de aplicaciones.

Hay dos maneras de configurar tu tenant de Azure para la integración:

  • Sigue las siguientes instrucciones para configurar manualmente el registro de una aplicación para la integración.
  • Utiliza los scripts UiPath Azure AD que hemos creado para esta tarea, que están disponibles en GitHub: el script configAzureADconnection.ps1 realiza todas las acciones descritas en esta sección y devuelve los detalles de registro de la app. A continuación, puedes ejecutar el script testAzureADappRegistration.ps1 para asegurarte de que el registro de la aplicación se ha realizado correctamente.

Para configurar manualmente tu tenant de Azure, haz lo siguiente en Azure Portal:

  1. Crea un registro de aplicación para tu organización.
    Durante el registro, selecciona Cuentas solo en este directorio de la organización y establece el URI de redirección como https://{yourDomain}/identity_/signin-oidc.
    Nota: si ya tienes una aplicación registrada para tu organización, no hay necesidad de crear una nueva, pero asegúrate de que esté configurada como se describe anteriormente.
  2. Abre la página Descripción general de la aplicación, copia el ID de la aplicación (cliente) y el ID del directorio (tenant), y guárdalos para utilizarlos más adelante:


  3. Ve a la página Autenticación de tu aplicación:
    1. En Redirigir URI, haz clic en Añadir URI para añadir una nueva entrada.
    2. Añade https://{yourDomain}/portal_/testconnection a la lista de URI de redireccionamiento.
    3. En la parte inferior, selecciona ID tokens en la casilla de verificación.
    4. Haz clic en Guardar.


  4. Ve a la página Configuración de token.
  5. Selecciona Añadir solicitud opcional.
  6. En Tipo de token, selecciona ID.
  7. Selecciona las casillas de verificación de family_name, given_name y upn para añadirlos como solicitudes opcionales:


  8. Ve a la página Permisos de la API.
  9. Haz clic en Añadir permiso y añade los siguientes permisos delegados de la categoría Microsoft Graph:
    • Permisos de OpenId: email, openid, offline_access, profile;
    • Permisos de los miembros del grupo: GroupMember.Read.All;
    • Permisos de usuario: User.Read, User.ReadBasic.All, User.Read.All (requiere consentimiento administrativo).


    Permiso

    Qué te permite hacer

    Qué hacemos con él

    email, openid, profile, offline_access, User.ReadPermite a AAD emitir un token de usuario a la aplicación de sistemaPermite a los usuarios iniciar sesión en el sistema utilizando un inicio de sesión de AAD. Esto nos permite mantener nuestro objeto de usuario actualizado, garantizando la coherencia de estos atributos.
    User.ReadBasic.AllLee las propiedades básicas de todos los usuarios en el directorio que el usuario que ha iniciado sesión puede verCuando un usuario asigna permisos a otros usuarios en el directorio a sus recursos, puede buscar en estos usuarios. La funcionalidad para la gestión/autorización de acceso están en la experiencia de usuario del sistema.
    User.Read.All (requiere consentimiento de administrador) Lee todas las propiedades de usuario en el directorio que el usuario que ha iniciado sesión puede verTu administrador puede importar estas propiedades de usuario adicionales para configurar permisos o mostrar información personalizada dentro de los servicios de sistema. Para los clientes de Automation Hub que desean obtener todos los atributos de AAD, es necesario otorgar los permisos User.Read.All a la aplicación.
    GroupMember.Read.AllLee las membresías de grupo de todos los usuarios a los que el usuario que ha iniciado sesión tiene accesoSi tu organización utiliza grupos para gestionar los permisos en el sistema, la plataforma debe poder enumerar todos los grupos y descubrir a los miembros de un grupo; eso permite tanto la gestión como la aplicación de los permisos asignados al grupo.

    Para obtener más información sobre el acceso de UiPath con estos permisos, consulta nuestra documentación de Cifrado.

  10. Selecciona la casilla Conceder consentimiento de administrador.
    Note: El administrador da su consentimiento en nombre de todos los usuarios del directorio activo del tenant. Esto permite que la aplicación acceda a los datos de todos los usuarios, sin que estos tengan que dar su consentimiento.
    Para obtener más información sobre los permisos y consentimiento, consulta la documentación de Azure AD.
  11. Ve a la página Certificados y secretos.
  12. Crear un nuevo secreto de cliente.
    Nota: el secreto de cliente creado no es permanente. Debes actualizar el secreto de cliente después de su período de validez.
  13. Copia el secreto del cliente Valor y guárdalo para usarlo más tarde


  14. Proporciona los valores de ID de directorio (tenant), ID de aplicación (cliente) y Secreto de cliente con el administrador de organización de la organización para que pueda proceder con la configuración.

Implementar la integración en Automation Suite

Una vez finalizada la configuración de Azure, puedes preparar la integración, activarla y, a continuación, limpiar las cuentas antiguas.

El proceso se divide en etapas para que no haya interrupciones para tus usuarios.

Permisos: debe ser un administrador de la organización en Automation Suite para llevar a cabo las tareas en esta sección.

Limpiar los usuarios inactivos

Cuando conecta Automation Suite a Azure AD mediante la activación de la integración, las cuentas con direcciones de correo electrónico coincidentes se benefician de los mismos permisos que la cuenta de UiPath correspondiente.

Importante: Para que la vinculación de cuentas se realice correctamente, asegúrate de que todos tus usuarios de Azure AD tienen la dirección de correo electrónico añadida en el campo Correo en Azure; no basta con tener la dirección de correo electrónico en el campo User Principle Name (UPN).

Si tu organización recicla correos electrónicos, es decir, si una dirección de correo electrónico utilizada en el pasado puede ser asignada a un nuevo usuario en el futuro, esto podría suponer un riesgo de acceso elevado.

Nota: Si en tu organización no se reutilizan las direcciones de correo electrónico inactivas, puedes omitir este paso.

Más información...

Supongamos que has tenido un empleado cuya dirección de correo electrónico era john.doe@example.com y este empleado tenía una cuenta de UiPath en la que era administrador de la organización, pero ya no está en la empresa y la dirección de correo electrónico ha sido desactivada, pero el usuario no ha sido eliminado de Automation Suite. Si un nuevo empleado que se llama Juan Pérez se incorpora a la empresa, recibirá la misma dirección de correo electrónico john.doe@example.com. En un caso como este, cuando las cuentas se vinculan para la integración de Automation Suite con Azure AD, Juan Pérez hereda los provilegios de administrador de la organización.

Para evitar este tipo de situaciones, asegúrese de eliminar todos los usuarios que ya no están activos de Automation Suite antes de proceder al siguiente paso.

Activar la integración de Azure AD

Antes de empezar

  • Asegúrate de que la configuración de Azure está completa.
  • Solicita a tu administrador de Azure los valores de ID de directorio (tenant), ID de aplicación (cliente) y Secreto de cliente para el registro de la aplicación en Azure.
Para activar la integración de Azure AD, sigue estos pasos:
  1. Ve a Administración y, si no lo has seleccionado, selecciona la organización en la parte superior del panel izquierdo.
  2. Selecciona Seguridad.
  3. En la pestaña Configuración de autenticación, haz clic en Configurar SSO.


  4. Selecciona Azure Active Directory en el panel de configuración de SSO.

  5. Rellena los campos con la información recibida de tu administrador de Azure.

  6. Selecciona la casilla de verificación.
    Esto es necesario porque después de guardar los cambios, las cuentas coincidentes se vinculan automáticamente.
  7. Haz clic en Test Connection.
  8. Cuando se te solicite, inicia sesión con tu cuenta de Azure AD. Un inicio de sesión correcto indica que la integración se ha configurado correctamente.
    En caso de que falle, pide a tu administrador de Azure que compruebe que Azure está correctamente configurado y vuelve a intentarlo.
  9. Haz clic en Guardar, si aún no se ha realizado la selección.

    La integración está ahora activa para tu organización.

  10. Accede a Administración > Configuración de la organización y copia la URL de tu organización.
  11. Cierra sesión.
  12. Dirígete a la URL de la organización ( https://{yourDomain}/orgID/) e inicia sesión con tu cuenta de Azure AD.

Ahora puedes trabajar con los usuarios y grupos en el Azure AD del tenant vinculado. Puedes localizar usuarios y grupos de Azure AD utilizando la búsqueda, por ejemplo para añadir un usuario a un grupo.Consulta las siguientes Preguntas frecuentes para obtener más información sobre los cambios que se producen cuando se activa la integración.

Nota: Las cuentas de directorio y los grupos no aparecen enumeradas en las páginas Usuarios o Grupos en las secciones Administración > Cuentas y grupo. Solo podrás encontrarlas mediante búsqueda.

Probar la integración de Azure AD

Para comprobar que la integración se ejecuta desde Automation Suite, inicie sesión como administrador de la organización con la cuenta de Azure AD e intente buscar grupos y usuarios de Azure AD en cualquier página relacionada, como el panel Editar grupo de Automation Suite (Admin > organización Cuentas y grupos > Grupos > Editar).

  • Si puedes buscar usuarios y grupos que se originan en Azure AD, significa que la integración está funcionando. Se puede saber el tipo de usuario o grupo por su icono.

    Note: Los usuarios y grupos de Azure AD no aparecen en la página Usuarios ni en la página Grupos, solo están disponibles a través de la búsqueda.
  • Si se produce un error al intentar buscar usuarios, como se muestra en el ejemplo siguiente, esto indica que hay algo mal en la configuración en Azure. Ponte en contacto con tu administrador de Azure y pídele que compruebe que Azure está configurado como se describe en Configuración de Azure para la integración.

    Consejo: Pide a tu administrador de Azure que confirme que ha seleccionado la casilla de verificación Conceder consentimiento de administrador durante la configuración de Azure. Esta es una causa común por la que falla la integración.

Completar la transición a Azure AD

Una vez activada la integración, recomendamos seguir las instrucciones de esta sección para garantizar que la creación de usuarios y las asignaciones de grupos se transfieran a Azure AD. De este modo, puede construir sobre su infraestructura de gestión de identidades y accesos existente para facilitar el control de la gestión de accesos y la gobernanza sobre los recursos de su organización de Automation Suite.

Configurar grupos de permisos y robots (opcional)

Puede hacer esto para asegurarse de que el administrador de Azure también pueda incorporar nuevos usuarios con los mismos permisos y la misma configuración del robot para Automation Suite y otros servicios que había configurado antes de la integración. Puede hacer esto añadiendo cualquier nuevo usuario a un grupo de Azure AD si el grupo tiene los roles requeridos ya asignados en Automation Suite.

Puede asignar sus grupos de usuarios existentes de Automation Suite a grupos nuevos o existentes en Azure AD. Puede hacerlo de varias maneras, dependiendo de cómo utilice los grupos en Azure AD:

  • Si los usuarios con los mismos roles en Automation Suite ya están en los mismos grupos en Azure AD, el administrador de la organización puede añadir estos grupos de Azure AD a los grupos de usuarios de Automation Suite en los que estaban estos usuarios. De este modo, se garantiza que los usuarios mantengan los mismos permisos y la configuración del robot.
  • De lo contrario, el administrador de Azure puede crear nuevos grupos en Azure AD para que coincidan con los de Automation Suite y añadir los mismos usuarios que están en los grupos de usuarios de Automation Suite. A continuación, el administrador de la organización puede añadir los nuevos grupos de Azure AD a los grupos de usuarios existentes para garantizar que los mismos usuarios tengan las mismas funciones.

En cualquier caso, asegúrate de comprobar los roles que se asignaron a las cuentas. Si es posible, elimina las asignaciones explícitas de funciones añadiendo estos usuarios a grupos que tengan las funciones que se asignaron explícitamente.

Ejemplo: digamos que el grupo de Administradores en Automation Suite incluye a los usuarios Roger, Tom y Jerry. Estos mismos usuarios también están en un grupo en Azure AD llamado admins. El administrador de la organización puede añadir el grupo admins al grupo Administradores de Automation Suite. De este modo, Pedro, Tomás y Juan, como miembros del grupo admins Azure AD, se benefician de los roles del grupo Administradores.

Dado que admins ahora forma parte del grupo Administradores, cuando necesite incorporar un nuevo administrador, el administrador de Azure puede añadir un nuevo usuario al grupo admins de Azure, otorgándoles así permisos de administración en Automation Suite sin tener que hacer ningún cambio en Automation Suite.

Los cambios en las asignaciones de grupos de Azure AD se aplican en Automation Suite cuando el usuario inicia sesión con su cuenta de Azure AD, o si ya ha iniciado sesión, en el plazo de una hora.

Migrar a los usuarios existentes

Inicio de sesión inicial: para que se apliquen los permisos asignados a los usuarios y grupos de Azure AD, los usuarios deben iniciar sesión al menos una vez. Recomendamos que, una vez ejecutada la integración, comuniques a todos tus usuarios que salgan de su cuenta de UiPath y vuelvan a iniciar sesión con su cuenta de Azure AD. Pueden iniciar sesión con su cuenta de Azure Ad:

  • navegando a la URL específica de la organización, en cuyo caso el tipo de inicio de sesión ya está seleccionado;

    Nota:La URL debe incluir el ID de la organización y terminar en una barra diagonal, como por ejemplo https://{baseURL}/orgID/.
  • seleccionando SSO para Enterprise en la página principal de inicio de sesión.

    Note: Asegúrate de proporcionar la URL específica de tu organización para Automation Suite a todos tus usuarios. Solo los administradores de la organización pueden ver esta información en Automation Suite.

Los usuarios migrados se benefician de la combinación de los permisos que les fueron asignados directamente y los de sus grupos de Azure AD.

Configuración de Studio y Assistant para los usuarios: para configurar estos productos para que se conecten con las cuentas de Azure AD:

  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
    Nota:La URL debe incluir el ID de la organización y terminar en una barra diagonal, como por ejemplo https://{baseURL}/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 la cuenta de Azure AD.
Importante: Los permisos de los grupos de Azure AD no influyen en las automatizaciones de las carpetas clásicas ni en los robots que se conectan mediante la clave de máquina. Para operar con permisos basados en grupos, configura las automatizaciones en carpetas modernas y utiliza la opción de URL de servicio para conectarte a UiPath Assistant o Studio.

Dejar de usa cuentas locales (opcional)

Aunque es opcional, le recomendamos que lo haga para maximizar las principales ventajas de cumplimiento y eficiencia de la integración completa entre Automation Suite y Azure AD.

Una vez que se hayan migrado todos los usuarios, puedes eliminar los usuarios basados en cuentas personales de UiPath de la pestaña Usuarios, de modo que tus usuarios ya no podrán iniciar sesión con sus cuentas de UiPath. Puedes encontrar estas cuentas en función de sus iconos de usuario.

También puede limpiar los permisos individuales en los servicios de UiPath, como el servicio de Orchestrator, y eliminar a los usuarios de los grupos de Automation Suite, para que los permisos dependan exclusivamente de la pertenencia a grupos de Azure AD.

Mejores prácticas

A continuación, te ofrecemos algunos consejos útiles sobre las funciones avanzadas que puedes aprovechar ahora que tienes configurada la integración con Azure AD.

Restringir el acceso a Automation Suite

Como la integración con Azure AD se realiza a nivel de tenant de Azure, por defecto todos los usuarios de Azure AD pueden acceder a la organización de Automation Suite. La primera vez que un usuario de Azure AD inicia sesión en Automation Suite, es automáticamente incluido en el grupo de Automation Suite Todos, que le concede el rol de usuario a nivel de organización.

Si solo desea permitir a determinados usuarios acceder a su organización de Automation Suite, puede activar la asignación de usuarios para el registro de la aplicación Automation Suite en Azure. De este modo, los usuarios deben ser asignados explícitamente a la aplicación (Automation Suite) para poder acceder a ella. Para obtener instrucciones, consulta este artículo en la documentación de Azure AD.

Restringe el acceso a redes o dispositivos de confianza

Si quieres que tus usuarios solo puedan acceder a Automation Suite desde una red o un dispositivo de confianza, puedes utilizar la función Acceso condicional de Azure AD.

Gobernanza para los grupos de Automation Suite en Azure AD

Si has creado grupos en Azure AD para facilitar la incorporación a Automation Suite directamente desde Azure AD, tal y como se describe en Configurar grupos para permisos y robots, puedes usar las opciones de seguridad avanzadas de Privileged Identity Management (PIM) para estos grupos, a fin de administrar los requisitos de acceso para grupos de Automation Suite.

¿Te ha resultado útil esta página?

Obtén la ayuda que necesitas
RPA para el aprendizaje - Cursos de automatización
Foro de la comunidad UiPath
Uipath Logo White
Confianza y seguridad
© 2005-2024 UiPath. Todos los derechos reservados.