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

Whenever your infrastructure uses a proxy for machines/users to connect to the internet, you will also need to configure the Robot to use it.

There are two possible configurations based on the Robot installation mode:

1. Attended Robot - user-mode installation
2. Unattended Robot - service-mode installation

Configuring the proxy for Attended robots (user-mode)

Attended robots inherit the proxy settings configured for your web browser.

If your proxy needs basic authentication, Assistant will prompt you to input your credentials when you first try to connect the Robot to Orchestrator.

You can setup the proxy by using the old way described at Configuring using the web browser or using the Windows proxy settings

Configuring the proxy for Unattended robots (service-mode)

To correctly configure the Service Mode robots to use the proxy, you need to modify both the proxy.json file and the corresponding Windows Settings of the user account(s) that will run automations.

For configuring the proxy in proxy.json follow the Configuring the proxy settings

For configuring the proxy for the user account(s) that will run automations, follow the Configuring the proxy for Attended Robots

Configuring the proxy using the proxy.json file

Starting with 2025.10, to configure the proxy for the Unattended Robot (service-mode), you need to modify the proxy.json file. If you are updating from an older version and you already have a proxy setup in place, it is automatically migrated to the new file.

1. Navigate to: %ProgramData%\UiPath\Shared.
2. Search proxy.jsonfile and open it using a text editor with administrator privileges, such as Notepad++.
   The proxy.json file supports multiple configurations, but not all at the same time. If both ScriptAddress and ProxyAddress are present, ScriptAddress takes precedence.

   {
     "ScriptAddress": "http://localhost/proxy.pac",
     "ProxyAddress": "http://1.1.1.1:1234/",
     "BypassLocalAddresses": true,
     "BypassList": "server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}",
     "UserName": "myUser",
     "Password": "myPassword",
     "Domain": "myDomain"
   }

   1. To use a proxy script, provide the following json:

      {
      "ScriptAddress" : "http://proxy.address/proxy.pac"
      }

   2. To provide a proxy address, provide the following json:

      {
        "ProxyAddress": "http://proxy.address:1234/",
        "BypassLocalAddresses": true,
        "BypassList": "server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}",
        "UserName": "myUser", #used for basic auth
        "Password": "myPassword", #used for basic auth
        "Domain": "myDomain"
      }

3. Guarda el archivo proxy.json.
4. Reinicia el mantenimiento de robot de UiPath o el dispositivo.

Configuring the proxy using the web browser

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.

Configuring the proxy using Windows settings

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.

Configurar el proxy durante la instalación del robot

To add the proxy settings while installing Unattended robots (service-mode), use the dedicated command line parameters in your installation command.

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.