Redirecionando Robôs por meio de um Servidor de Proxy

Para um Robô estabelecer uma comunicação direta com o Orchestrator, ele precisa estar na mesma rede ou usar uma aberta. Caso contrário, você precisa configurar um servidor de proxy para facilitar a comunicação.

Configure um proxy usando um script de proxy ou fornecendo o endereço do servidor de proxy com uma lista de endereços a serem ignorados. Apenas um método pode ser usado. Se ambos estiverem configurados, o script de proxy tem precedência.

As seguintes opções de configuração estão disponíveis:

• Configurando o Navegador Web

• Ajustando as Configurações de Proxy do Windows

• Definindo a configuração de proxy por meio de parâmetros de linha de comando

• Editando o uipath.config arquivo

Importante: ao atualizar de versões anteriores para a v2021.4, as configurações de proxy são migradas do arquivo proxy.config para o uipath.config , a fim de corresponder ao novo formato.

Proxy para robôs do Modo de Uso

Robots do Modo de Usuário herdam as configurações de proxy definidas no seu navegador web.

Para configurações de proxy que exigem autenticação básica não Windows, armazene as credenciais necessárias no Gerenciador de Credenciais da máquina.

Importante:

Para aplicar configurações de proxy em UiPath Robots no Modo de Usuário, você precisa reiniciar o Serviço Host de Usuário. Você pode fazer isso saindo da sessão do usuário do Windows e, em seguida, fazendo logon novamente.

Proxy para robôs do Modo de Serviço

Para usar corretamente as configurações de proxy para robôs do Modo de Serviço com as funcionalidades Login Interativo e Transmissão ao vivo, você precisa modificar o arquivo uipath.config e as Configurações correspondentes do Windows da conta do usuário que está executando o Robô.

The auto-update process for proxy configurations

Você pode configurar o processo de atualização automática para Robots que operam atrás de um proxy, dependendo do tipo de instalação do Robot:

For unattended installations, the Update Agent is absent. Configurations for proxy are manually handled by modifying the UiPath.config file. Both the Robot Service and the Update Service run using a Windows Service, independent of a user.

For attended installations, configurations for proxy are also manually handled by modifying the UiPath.config file. However, the user starts both the Robot Service and the Update Agent. The Update Service runs using a Windows Service.

For quick installations, configurations for the proxy are inherited from the existing user settings. The user initiates all services: Robot Service, Update Agent, and Update Service.

Autenticação de proxy nas Credenciais do Windows

O servidor de proxy pode exigir credenciais para permitir o tráfego. Você pode configurar o proxy para se autenticar usando as credenciais do usuário do Windows conectado.

Para habilitar esse recurso, adicione a variável de ambiente do sistema UIPATH_PROXY_USE_DEFAULT_CREDENTIALS na máquina que está executando o Robô e defina seu valor como true. Isso diz para o Robot usar as Credenciais do Windows do usuário atual para a autenticação do proxy.

Autenticação básica

A partir da versão 2021.10, o Serviço de Robôs da UiPath oferece suporte a servidores proxy usando protocolos de autenticação básica.

Robôs de Modo de Usuário - Com a Autenticação Básica, o UiPath Assistant identifica se uma configuração de proxy é implementada na máquina e solicita ao usuário suas credenciais.

Robôs do Modo de Serviço - O Executor do Robô não suporta métodos de autenticação básica para configurações de proxy. Embora você possa usar a autenticação básica para se conectar ao Orchestrator e baixar pacotes, você não pode usá-la dentro da execução do fluxo de trabalho real. Para habilitar a autenticação básica para robôs do Modo de Serviço, atualize o arquivo UiPath.config com os seguintes 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>

Live streaming and remote control in a proxy setup

AVISO:

Live streaming and remote control features do not work in a proxy setup for Robot versions older than 2024.10.5. Upgrade your Robot to versions 2024.10.5+ to access these features in a proxy setup.

Configurando o Navegador Web

1. Abra a janela Propriedades da Internet .
2. Na guia Conexões , selecione Configurações da LAN. A janela Configurações da Rede Local (LAN) é aberta. Dependendo da sua configuração, você pode definir um script de configuração de proxy ou um servidor de proxy.
   
   1. Para usar um script de proxy, selecione Usar script de configuração automática e forneça o endereço para o script.
   2. Para configurar manualmente o servidor de proxy, selecione Usar um servidor de proxy para sua LAN e, em seguida, forneça o endereço do servidor de proxy e a porta.
3. Para salvar suas configurações, selecione OK.
4. No seu navegador web, teste a conexão acessando o URL do Orchestrator.

Ajustando as Configurações de Proxy do Windows

1. Abra a janela de configurações de Proxy .
2. Para usar um script de proxy, em Configuração automática de proxy, ative Usar script de configuração. Forneça o endereço para o script.
3. Para configurar manualmente o servidor de proxy, em Configuração de proxy manual, ative a opção Usar um servidor de proxy. Forneça o endereço do servidor de proxy e a porta.
   Importante:

   Adicionar o prefixo http:// ao endereço do servidor de proxy impede que o Robot faça chamadas HTTPS. Para garantir que o proxy funcione como esperado, remova totalmente o prefixo http:// ou adicione o endereço de proxy com ambos os prefixos http:// e https:// .

   Por exemplo:

   • Incorreto - http=proxyaddress
   • Correto - http=proxyaddress;https=proxyaddress
   • Correto - http://proxyaddress;https://proxyaddress
4. Para salvar suas configurações, selecione Salvar.

Editando o arquivo uipath.config

1. Navegue até a pasta de instalação, %ProgramFiles%\UiPath\Studio.
2. Procure pelo arquivo uipath.config e abra-o usando um editor de texto, como o Notepad++.
3. Adicione a tag <webProxySettings> e defina os valores com base no seu ambiente de proxy.
   1. Para usar um script de proxy, forneça o seguinte par de chave-valor:

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

   2. Para fornecer um endereço de proxy, forneça os seguintes pares de chave-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. Salve o arquivo uipath.config.
5. Reiniciar o Serviço de Robôs da UiPath.

Ajustando as configurações de proxy durante a instalação do Robô

Para adicionar as configurações de proxy ao instalar robôs no Modo de Serviço, use os parâmetros de linha de comando dedicados no seu comando de instalação.

Por exemplo, o seguinte comando instala o Robô no Modo de Serviço e usa um script para configurar o proxy:

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

O seguinte comando instala o Robô no Modo de Serviço e define a Autenticação Básica para configurações de proxy:

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

Verificação da conexão do servidor de proxy

1. Conecte o Robô ao Orchestrator
2. Instale alguns pacotes em um ambiente que contenha o Robô previamente configurado.
3. Navegue até a pasta %userprofile%\.nuget\ e verifique se os pacotes de processos e atividades correspondentes foram baixados.
4. Execute o trabalho correspondente para verificar se ele é executado com sucesso.