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:

  El robot de modo de usuario hereda la configuración del proxy de las Opciones de Internet, mientras que el robot de modo de servicio requiere que se realice una configuración específica en el archivo uipath.config de la carpeta de instalación de Studio.

  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: La configuración del archivo uipath.config solo se aplica al proceso de mantenimiento de robot de UiPath cuando se instala en modo de servicio. La configuración de proxy para procesos de Windows de nivel de usuario, incluyendo el ejecutor (tanto para instalaciones de modo de usuario como de modo de servicio) no se puede configurar mediante 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. En Internet Explorer, haz clic en Herramientas > Opciones de Internet. Se mostrará la ventana Opciones de Internet.
   
   

   

   
   
2. En la pestaña Conexiones, haz clic en Configuración de LAN. Se mostrará la ventana Configuración de red de área local (LAN). Dependiendo de tu configuración, puedes configurar un script de configuración proxy o un servidor proxy.
   
   

   

   
   
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:

   Cuando configures o edites la dirección proxy, no añadas el prefijo http:// a la dirección proxy. Esto habilita el proxy solo para las llamadas HTTP, y como la mayoría de las llamadas son HTTPS, la configuración del proxy falla.

   Para solucionarlo, asegúrate de eliminar el prefijo http:// o añade la dirección proxy con los prefijos http:// y https://.

   Ejemplo:

   • http=proxyaddress -> incorrect

   • http=proxyaddress;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 clave-valor:

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

   2. Para proporcionar una dirección proxy, proporciona los siguientes pares 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: A partir de la versión 2021.4 de UiPath Robot, la lista de derivación debe contener una matriz de cadenas de expresiones regulares que contengan las URI de los servidores que derivar.
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: A partir de la versión 2021.4 de UiPath Robot, la lista de derivación debe contener una matriz de cadenas de expresiones regulares que contengan las URI de los servidores que derivar.

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: El ejecutor de robot no admite configuraciones de proxy usando métodos de autenticación básicos. Esto significa que puedes usar autenticación básica para conectar a Orchestrator y descargar paquetes, pero no para el flujo de trabajo real.

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.