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

O processo de atualização automática para configurações de proxy

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:

Para instalações não assistidas, o Agente de Atualização está ausente. As configurações para proxy são tratadas manualmente modificando o arquivo UiPath.config . Tanto o Serviço de Robôs quanto o Serviço de Atualização são executados usando um Serviço do Windows, independente de um usuário.

Para instalações assistidas, as configurações para proxy também são tratadas manualmente modificando o arquivo UiPath.config . No entanto, o usuário inicia o Serviço de Robôs e o Agente de Atualização. O Serviço de atualização é executado usando um Serviço do Windows.

Para instalações rápidas, as configurações do proxy são herdadas das configurações de usuário existentes. O usuário inicia todos os serviços: Serviço de Robôs da UiPath, Agente de atualização e Serviço de atualização.

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>

Transmissão ao vivo e controle remoto em uma configuração de proxy

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 Robot para as versões 2024.10.5+ para acessar esses recursos em uma configuração de proxy.

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.