Redirecionando Robôs por meio de um Servidor de Proxy

Se você tiver um Robô 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ô através de um servidor do proxy, é necessário fazer algumas configurações na máquina do Robô.Elas foram divididas nas seguintes etapas:

• 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.
• Edite o arquivo uipath.config para garantir que a conexão entre o Robô e o Orchestrator seja encaminhada 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ô de modo de usuário herda as Configurações de Proxy da Opções da Internet, enquanto o robô de modo de serviço requer que a configuração específica seja feita no arquivo uipath.config a partir da pasta de instalação do Studio.

  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: as configurações no arquivo uipath.config só se aplicam ao processo do Serviço do Robot quando instaladas no modo de serviço. Configurações de proxy para Processos do Windows de nível de usuário, incluindo o executor (tanto para instalações de modo de usuário quanto de modo de serviço), não são configuráveis por meio do uipath.config.

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 configurar um script de configuração de proxy ou um servidor 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.
4. No navegador web, insira a URL do Orchestrator para testar a conexão.
   
   

   

   
   
   Importante:

   Ao configurar ou editar o endereço de proxy, não adicione o prefixo http:// a ele. Isso habilita o proxy apenas para chamadas HTTP e, como a maioria das chamadas é HTTPS, a configuração do proxy falha.

   Para evitar o problema, certifique-se de remover o prefixo http:// ou adicionar especificamente o endereço de proxy com ambos os prefixos http:// e https://.

   Exemplo:

   • http=proxyaddress -> incorrect

   • http=proxyaddress;https=proxyaddress -> correct

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

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>

      Observação: a partir do Robot v2021.4, a lista de ignoráveis deve conter uma array de strings de expressões regulares que contêm as URIs dos servidores a serem ignorados.
4. Salve o arquivo uipath.config e reinicie o serviço do Robô para que as alterações entrem em vigor.

Exemplos para a lista de ignoráveis

Abaixo, você pode encontrar alguns exemplos do formato da lista de ignoráveis.

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 testar a formatação para configurações complexas, você pode usar um validador/gerador do regex.

Observação: a partir do Robot v2021.4, a lista de ignoráveis deve conter uma array de strings de expressões regulares que contêm as URIs dos servidores a serem ignorados.

Importante:

Apenas uma das ScriptAddress e ProxyAddress devem ser definidas. Se ambas forem definidas, ScriptAddress terá precedência.

BypassList e BypassLocalAddresses devem ser definidas, apenas quando ProxyAddress estiver definido.

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. Para habilitar essa funcionalidade, adicione a variável de ambiente do sistema UIPATH_PROXY_USE_DEFAULT_CREDENTIALS na máquina.

exemplo: UIPATH_PROXY_USE_DEFAULT_CREDENTIALS com o valor true

Configurar a autenticação do proxy com credenciais do Windows usando o PowerShell

1. Abra o PowerShell como administrador.
2. Execute o comando abaixo:

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

3. Reinicie a máquina de robô.

Validação do script

Para confirmar que a variável de ambiente do sistema foi definida com sucesso, execute o script abaixo no PowerShell.

$Env:UIPATH_PROXY_USE_DEFAULT_CREDENTIALS

Isso retorna o valor da variável de ambiente do sistema. Se o valor for true, a configuração estará em vigor agora.

Autenticação básica

A partir da versão v2021.10, o serviço de Robôs da UiPath oferece suporte a 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: o Executor do Robot não é compatível com configurações de proxy que usem métodos de autenticação básica. Isso significa que você pode usar a autenticação básica para se conectar ao Orchestrator e baixar pacotes, mas não para o fluxo de trabalho real.

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.