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

Si tienes un Robot en una red cerrada, o en una red distinta a la de Orchestrator, la comunicación entre los dos productos UiPath no es posible. Como resultado, para facilitar esta comunicación, puedes usar un servidor proxy con tu Robot.

Para redirigir el Robot a través de un servidor proxy, es necesario realizar algunas configuraciones en la máquina del Robot. Se dividen en los siguientes pasos:

• Configura tu navegador web preferido para asegurarte de que la máquina Robot pueda acceder a Orchestrator a través del servidor proxy indicado.

• Edita el archivo uipath.config para asegurarte de que la conexión entre el Robot y Orchestrator se enruta a través del servidor proxy proporcionado y que los paquetes de actividades y los procesos de automatización se pueden descargar a través del servidor proxy especificado.

  Nota:

  The user mode robot inherits the Proxy Settings from the Internet Options, while the service mode robot requires specific configuration to be made in the uipath.config file from the Studio installation folder.

  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.

  Importante:

  The settings in the uipath.config file only apply to the robot service process when installed in service-mode. Proxy settings for user-level Windows processes, including the executor (for both user-mode and service-mode installations), are not configurable through uipath.config.

Configuración de los ajustes del proxy

Se pueden establecer configuraciones para el script de proxy o la dirección del proxy desde la sección Conexiones en Opciones de Internet o desde el menú Configuración de proxy en la Configuración de Windows.

Configuración del navegador web

1. In Internet Explorer, click Tools > Internet Options. The Internet Options window is displayed.

   

2. In the Connections tab, click LAN Settings. The Local Area Network (LAN) Settings window is displayed. Depending on your setup, you can configure a proxy configuration script or a proxy server.

   

3. Configura el Servidor proxy o Configuración automática (para el script de proxy).

4. Haz clic en Aceptar. Tus ajustes se guardarán.

5. En el navegador web, escribe la URL de Orchestrator para probar la conexión.

Configuración de los ajustes de proxy de Windows

1. Abre el menú de inicio y busca Configuración del proxy.

2. Establece la Configuración automática del proxy (para el script de proxy) o la Configuración manual del proxy (para el servidor proxy).

3. Guarda los ajustes.

4. En el navegador web, escribe la URL de Orchestrator para probar la conexión.

   

   Importante:

   When setting up or editing the proxy address, do not add the http:// prefix to the proxy address. This enables the proxy only for HTTP calls, and since most calls are HTTPS, the proxy configuration fails.

   To resolve this, make sure to either remove the http:// prefix altogether, or specifically add the proxy address with both http:// and https:// prefixes.

   Ejemplo:

   • http://proxyaddress -> incorrect
   • https://proxyaddress -> correct
   • http://proxyaddress;https://proxyaddress -> correct

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>
      

      Nota:

      Starting with v2021.4 Robot, the bypass list should contain an array of regular expression strings that contain the URIs of the servers to bypass.

4. Guarda el archivo uipath.config y reinicia el servicio de robot para que los cambios surtan efecto.

Ejemplos de la lista de derivación

A continuación puedes encontrar algunos ejemplos del formato de lista de derivación.

www.myget.org -> ((www|WWW).){1}?(myget+(.org))
.vo.msecnd.net -> (([a-zA-Z0-9]).)+((vo+)+(.msecnd+)+(.net))
www.nuget.org -> ((www|WWW).){1}?(nuget+(.org))
gallery.uipath.com -> (([a-zA-Z0-9]).)*((gallery+)+(.uipath+)+(.com))

Para probar el formato de configuraciones complejas puedes usar un validador/generador de expresiones regulares.

Nota:

Starting with v2021.4 Robot, the bypass list should contain an array of regular expression strings that contain the URIs of the servers to bypass.

Importante:

Solo se debe establecer uno de ScriptAddress y ProxyAddress. Si se establecen ambos, tiene preferencia ScriptAddress.

BypassList y BypassLocalAddresses solo deben establecerse cuando se establece ProxyAddress.

Autenticación de proxy de credenciales de Windows

A partir de la versión 2021.4.4, el Robot puede funcionar con configuraciones de proxy que utilizan la autenticación mediante Credenciales de Windows. Para habilitar esta funcionalidad, añade en la máquina la variable del entorno de sistema UIPATH_PROXY_USE_DEFAULT_CREDENTIALS.

ejemplo: UIPATH_PROXY_USE_DEFAULT_CREDENTIALS con valor true

Configuración de la autenticación de Credentials Proxy de Windows con PowerShell

1. Abre PowerShell como administrador.

2. Ejecuta el siguiente comando:

   [Environment]::SetEnvironmentVariable("UIPATH_PROXY_USE_DEFAULT_CREDENTIALS", "true", "Machine")
   

3. Reinicia la máquina del Robot.

Validación del script

Para confirmar que la variable de entorno de sistema se ha establecido correctamente, ejecuta el siguiente script en PowerShell.

$Env:UIPATH_PROXY_USE_DEFAULT_CREDENTIALS

Esto devuelve el valor de la variable de entorno de sistema. Si el valor es true, la configuración es ahora correcta.

Autenticación básica

A partir de la versión v2021.10, el servicio Robot admite servidores proxy que utilicen protocolos de autenticación básica...

Robot en modo servicio

Para habilitar esta funcionalidad cuando el UiPath robot se instala en modo de servicio, tienes que editar la sección webProxySettings del archivo uipath.config y añadir la siguiente información:

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

Importante:

The Robot Executor does not support proxy configurations using Basic Authentication methods. This means you can use Basic Authentication to connect to Orchestrator and download packages, but not for the actual workflow.

Comprobación de 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.

   Nota:

   Al actualizar desde versiones anteriores a la versión 2021.4, las configuraciones de proxy se migran desde el archivo proxy.config al uipath.config para que coincidan con el nuevo formato.