Redirecionando Robôs por meio de um Servidor de Proxy

Se você tiver um Robô que esteja em uma rede fechada ou em uma rede diferente da usada pelo Orchestrator, a comunicação entre os dois produtos da UiPath não será possível. Como resultado, para facilitar essa comunicação, você pode usar um servidor de proxy com seu Robô.

Para redirecionar o Robô por meio de um servidor de proxy, você tem que fazer várias configurações na máquina do Robô. Elas foram divididas nas seguintes etapas:

1. Configure o navegador de sua preferência, para garantir que a máquina do Robô possa acessar o Orchestrator por meio do servidor de proxy indicado.
2. Edite o arquivo UiPath.config para garantir que a conexão entre o UiPath Robot e o Orchestrator seja roteada por meio do servidor de proxy fornecido e que os pacotes de atividades e os processos de automação possam ser baixados por meio do servidor de proxy especificado.
   Observação:

   • O robô no modo de usuário herda as Configurações de Proxy das Opções da Internet, enquanto o robô no modo de serviço requer que seja feita uma configuração específica no uipath.configarquivo da pasta de instalação do Studio.
   • Quando o robô estiver instalado no Modo de Serviço e você precisa usar a funcionalidade Login interativo no UiPath Assistant você precisa configurar as configurações de proxy no arquivo uipath.config e nas configurações do Windows para o usuário com o qual o robô está sendo usado.
   • 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.

Importante:

Quando o robô está instalado no modo de usuário, para usar configurações de proxy que exigem uma autenticação básica (não do Windows) para execução de processos, as credenciais precisam ser adicionadas ao Gerenciador de Credenciais da máquina, pois as configurações no uipath.configarquivo se aplicam apenas ao robô em modo de serviço.

AVISO:

As funcionalidades de transmissão ao vivo e controle remoto não funcionam em uma configuração de proxy para versões do Robô mais antigas que a 2024.10.5. Atualize seu Robô para as versões 2024.10.5+ para acessar essas funcionalidades em uma configuração de proxy.

Ajustando as Configurações de Proxy

As configurações do Script de Proxy ou do Endereço de Proxy podem ser definidas na seção Conexões em Opções de Internet ou no menu Configurações de Proxy nas Configurações do Windows.

Configurando o Navegador Web

1. No Internet Explorer, clique em Ferramentas > Opções de Internet. A janela Opções de Internet é exibida.

   

2. Na aba Conexões, clique em Configurações da LAN. A janela Configurações de Rede Local (LAN) é exibida. Dependendo da sua configuração, você pode definir um script de configuração de proxy ou um servidor de proxy.

   

3. Configure o Servidor de Proxy ou a Configuração Automática (para o Script de Proxy).

4. Clique em OK. Suas configurações foram salvas.

5. No navegador web, insira a URL do Orchestrator para testar a conexão.

Ajustando as Configurações de Proxy do Windows

1. Abra o menu Iniciar e procure pelas Configurações de Proxy.
2. Ajuste a Configuração de Proxy Automática (para o Script de Proxy) ou Configuração de Proxy Manual (para o Servidor de Proxy).
3. Salve as configurações.

No navegador web, insira a URL do Orchestrator para testar a conexão.

Importante:

Ao configurar ou editar o endereço de proxy na seção de configuração manual de proxy no menu Configurações de Proxy do Windows, não adicione o prefixo http:// ao endereço de proxy. Isso força aplicativos baseados em .NET, como o UiPath Robot, a usar o proxy apenas para chamadas HTTP e, como a maioria das chamadas é HTTPS, a configuração do proxy não pode ser usada. Para resolver o problema, certifique-se de remover completamente o prefixo http:// ou de adicionar explicitamente o endereço de proxy com ambos os prefixos http:// e https://.Exemplo:

• http://proxyaddress -> incorreto
• https://proxyaddress -> correto
• http://proxyaddress;https://proxyaddress -> correto

Como editar 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 e reinicie o serviço do Robô para que as alterações entrem em vigor.
   Observação:

   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.

Autenticação de proxy nas Credenciais do Windows

A partir da v2021.4.4, o Robô pode funcionar com configurações de proxy que usam a Autenticação por meio de Credenciais do Windows.

Observação:

Apenas um dos ScriptAddress e ProxyAddress deve ser definido. Se ambos estiverem definidos, ScriptAddress tem precedência. BypassList e BypassLocalAddresses devem ser definidos apenas quando ProxyAddress estiver definido.

Autenticação básica

A partir da versão v2021.10, o serviço do UiPath Robot é compatível com servidores proxy usando protocolos de autenticação básica.

Robô de Modo de Serviço

Para habilitar essa funcionalidade quando o Robot for instalado no modo de serviço, você precisa editar a seção webProxySettings do arquivo uipath.config e adicionar as seguintes informações:

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

Robô de Modo de Usuário

Quando o Robot é instalado no Modo de Usuário, o UiPath Assistant detecta automaticamente que uma configuração de proxy de autenticação básica está em vigor na máquina e solicita ao usuário um nome de usuário e uma senha.

Verificando a 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.
   Observação:

   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.