Redirección de Robots a través de un servidor proxy

Para que un robot establezca una comunicación directa con Orchestrator, debe estar en la misma red o utilizar una abierta. De lo contrario, debes configurar un Servidor Proxy para facilitar la comunicación.

Configura un proxy utilizando un script de proxy o proporcionando la dirección del servidor proxy con una lista de direcciones que omitir. Solo se puede utilizar un método. Si ambos están configurados, el script proxy tiene prioridad.

Están disponibles las siguientes opciones de configuración:

• Configurar el explorador web

• Configurar el proxy de Windows

• Configurar el proxy a través de parámetros de línea de comandos

• Editar el archivo uipath.config

Importante: Al actualizar desde versiones anteriores a la v2021.4, las configuraciones de proxy se migran desde el archivo proxy.config al uipath.config para que coincidan con el nuevo formato.

Proxy para robots en modo de uso

Los robots en modo de usuario heredan la configuración de proxy de su explorador web.

Para la configuración de proxy que requiere autenticación básica que no sea de Windows, guarda las credenciales necesarias en el Gestor de credenciales de la máquina.

Importante:

Para aplicar la configuración de proxy en robots en modo de usuario, debes reiniciar el servicio de host de usuario. Puedes hacerlo cerrando la sesión de usuario de Windows y luego iniciando sesión.

Proxy para robots en modo de servicio

Para usar correctamente la configuración de proxy para los robots de modo de servicio con las características Inicio de sesión interactivo y Transmisión en vivo, debes modificar tanto el archivo uipath.config como la configuración correspondiente de Windows de la cuenta de usuario que ejecuta el robot.

Configuración de proxy basada en tipos de usuario (Ejecutor)

En el contexto de UiPath, los procesos de Windows pueden ejecutarse bajo dos identidades distintas:

• Usuario local: estos procesos se ejecutan bajo la identidad del usuario que actualmente ha iniciado sesión en la sesión de Windows.

• Usuarios del Sistema local: estos procesos suelen ser servicios o tareas en segundo plano que se ejecutan con privilegios a nivel del sistema.

Al configurar un proxy en Windows, la configuración de proxy está vinculada al usuario que ejecuta el proceso. Por tanto, dependiendo de la identidad del proceso que realiza la solicitud HTTP, hay dos escenarios posibles para la configuración de proxy:

• Se utiliza el proxy definido para el usuario en Windows.

• La configuración de proxy se carga del archivo uipath.config.

En la siguiente tabla se resumen los procesos de Windows relacionados con los robots, las identidades de usuario con las que se ejecutan y las solicitudes HTTP que realizan:

Proceso de Windows	Identidad del usuario	Solicitudes HTTP
UiPath.ServiceHost.exe	SistemaLocal	Responsable de la comunicación de servicio con Orchestrator, lo que incluye: Recuperar latidos Obtener trabajos y enviar estados de trabajos Gestionar registros para procesos Unattended Administrar la autenticación para el servicio Descargar paquetes
UiPath.UserHost.exe	Usuario	Es responsable de la comunicación de servicio con Orchestrator cuando se instala en modo de usuario, lo que incluye: Recuperar latidos Administrar registros para procesos Gestionar la autenticación para UiPath Assistant Descargar paquetes
UiPath.Executor.exe	SistemaLocal (al ejecutar un trabajo en segundo plano) Usuario (al ejecutar trabajos regulares)	Responsable de manejar las solicitudes HTTP específicas de la automatización, incluidas: Administrar activos y artículos en cola Enviar solicitudes específicas de la actividad (solicitudes HTTP a servicios externos)
UiPath.Assistant.exe	Usuario	Responsable de gestionar el tráfico relacionado con UiPath Assistant, incluidas: Administración de listas de procesos Gestión de desencadenadores Interacciones del Marketplace
UiPath.RemoteDebugging.Agent.exe	Usuario	Responsable de manejar el tráfico de depuración remota a través de SignalR.
UiPath.UpdateService.Worker.exe	SistemaLocal	Responsable de descargar los MSI desde Orchestrator.

El proceso de actualización automática para las configuraciones de proxy

Puedes configurar el proceso de actualización automática para los robots que operan detrás de un proxy, dependiendo del tipo de instalación del robot:

Para las instalaciones desatendidas, el agente de actualización está ausente. Las configuraciones para el proxy se gestionan manualmente modificando el archivo UiPath.config . Tanto el servicio de robot como el servicio de actualización se ejecutan utilizando un servicio de Windows, independiente de un usuario.

Para las instalaciones atendidas, las configuraciones del proxy también se gestionan manualmente modificando el archivo UiPath.config . Sin embargo, el usuario inicia tanto el servicio de robot como el agente de actualización. El servicio de actualización se ejecuta utilizando un servicio de Windows.

Para instalaciones rápidas, las configuraciones para el proxy se heredan de la configuración de usuario existente. El usuario inicia todos los servicios: servicio de robot, agente de actualización y servicio de actualización.

Autenticación de proxy de credenciales de Windows

Es posible que el servidor proxy requiera credenciales para permitir tráfico. Puedes configurar el proxy para que se autentique utilizando las credenciales del usuario de Windows que ha iniciado sesión.

Para habilitar esta característica, añade la variable de entorno del sistema UIPATH_PROXY_USE_DEFAULT_CREDENTIALS en la máquina que ejecuta el robot y establece su valor en true. Esto indica al robot que use las Credenciales de Windows del usuario actual para la autenticación de proxy.

Autenticación básica

A partir de la versión 2021.10, el mantenimiento de robot de UiPath admite servidores proxy que utilizan protocolos de autenticación básicos.

Robots de modo de usuario: con la autenticación básica, UiPath Assistant identifica si se ha implementado una configuración de proxy en la máquina y solicita al usuario sus credenciales.

Robots de modo de servicio: el Ejecutor de robot no admite métodos de autenticación básica para configuraciones de proxy. Aunque puedes utilizar la autenticación básica para conectarte a Orchestrator y descargar paquetes, no puedes usarla en la ejecución real del flujo de trabajo. Para habilitar la autenticación básica para robots en modo de servicio, actualiza el archivo UiPath.config con los siguientes parámetros de proxy:

 <webProxySettings>
<add key="ProxyAddress" value="http://my.proxy.net:8008" />
<add key="UserName" value="myUser" />
<add key="Password" value="myPassword" />
<add key="Domain" value="myDomain" />
</webProxySettings>

Transmisión en vivo y control remoto en una configuración de proxy

ADVERTENCIA:

Las funciones de transmisión en directo y control remoto no funcionan en una configuración de proxy para versiones de UiPath Robot anteriores a 2024.10.5. Actualiza tu Robot a las versiones 2024.10.5+ para acceder a estas características en una configuración de proxy.

Configurar el explorador web

1. Abre la ventana Propiedades de Internet.
2. En la pestaña Conexiones, selecciona Configuración de LAN. Se abre la ventana Configuración de la red de área local (LAN). Dependiendo de tus ajustes, puedes establecer un script de configuración de proxy o un servidor proxy.
   
   1. Para utilizar un script de proxy, selecciona Utilizar script de configuración automática y proporciona la dirección al script.
   2. Para configurar manualmente el servidor proxy, selecciona Usar un servidor proxy para tu LAN y, a continuación, proporciona la dirección del servidor proxy y el puerto.
3. Para guardar la configuración, selecciona Aceptar.
4. En tu explorador web, prueba la conexión accediendo a la URL de Orchestrator.

Configurar el proxy de Windows

1. Abre la ventana de configuración de proxy.
2. Para utilizar un script de proxy, en Configuración automática de proxy, activa Usar script de configuración. Proporciona la dirección al script.
3. Para configurar manualmente el servidor proxy, en Configuración de proxy manual, activa la opción Usar un servidor proxy. Proporciona la dirección del servidor proxy y el puerto.
   Importante:

   Al añadir el prefijo http:// a la dirección del servidor proxy se impide al robot realizar llamadas HTTPS. Para garantizar que el proxy funcione como se espera, elimina el prefijo http:// por completo o añade la dirección proxy con ambos prefijos http:// y https://.

   Por ejemplo:

   • Incorrecto: http://proxyaddress,
   • Correcto: https://proxyaddress, http://proxyaddress; https://proxyaddress
4. Para guardar los ajustes, selecciona Guardar.

Editar el archivo uipath.config

1. Navega hasta la carpeta de instalación, %ProgramFiles%\UiPath\Studio.
2. Busca el archivo uipath.config y ábrelo usando un editor de texto, como Notepad++.
3. Añade la etiqueta <webProxySettings> y establece los valores basados en tu entorno proxy.
   1. Para utilizar un script de proxy, proporciona el siguiente par de clave-valor:

       <webProxySettings>
          <add key="ScriptAddress" value="http://localhost/proxy.pac" />
      </webProxySettings>

   2. Para proporcionar una dirección de proxy, proporciona los siguientes pares de clave-valor:

       <webProxySettings>
          <add key="ProxyAddress" value="http://1.1.1.1:1234/" />
          <add key="BypassLocalAddresses" value="True" />
          <add key="BypassList" value="server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}" />
      </webProxySettings>

4. Guarda el archivo uipath.config.
5. Reinicies el servicio de UiPath Robot.

Configurar el proxy durante la instalación del robot

Para añadir la configuración de proxy durante la instalación de los robots en modo de servicio, utiliza los parámetros de línea de comandos específicos en el comando de instalación.

Por ejemplo, el siguiente comando instala el Robot en modo de servicio y utiliza un script para configurar el proxy:

 UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_SCRIPT_ADDRESS=http://localhost/proxy.pac

El siguiente comando instala el robot en modo de servicio y configura la autenticación básica para la configuración de proxy:

 UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_ADDRESS=http://my.proxy.net:8008 PROXY_USERNAME="myUser" PROXY_PASSWORD="myUser" PROXY_DOMAIN="myUser"

Comprobar la conexión del servidor proxy

1. Conecta el robot a Orchestrator
2. Implementa algunos paquetes en un entorno que contenga el Robot configurado anteriormente.
3. Navega hasta la carpeta %userprofile%\.nuget\ y comprueba si se han descargado los paquetes de proceso y actividades correspondientes.
4. Ejecuta el trabajo correspondiente para comprobar si se ejecuta correctamente.