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 proxy para facilitar a comunicação.

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

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

• Configurando o navegador da Web

• Definição das configurações de proxy do Windows

• Definição da configuração de proxy por meio de parâmetros de linha de comando

• Editando o arquivo uipath.config

Importante: ao atualizar de versões anteriores à 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 no Modo de Uso

Os robôs no modo de usuário herdam as configurações de proxy definidas para seu navegador da Web.

Para configurações de proxy que exigem autenticação básica que não seja 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 no Modo de Serviço

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

Configurações de proxy baseadas em tipos de usuário (Executor)

No contexto da UiPath, os processos do Windows podem ser executados sob duas identidades distintas:

• Usuário local—Esses processos são executados com a identidade do usuário que está conectado no momento na sessão do Windows.

• Usuários do LocalSystem—Esses processos são normalmente serviços ou tarefas em segundo plano executadas com privilégios no nível do sistema.

Ao configurar um proxy no Windows, as configurações de proxy estão vinculadas ao usuário que executa o processo. Portanto, dependendo da identidade do processo que faz a solicitação HTTP, há dois cenários possíveis para configuração de proxy:

• O proxy definido para o usuário no Windows é usado.

• As configurações de proxy são carregadas a partir do arquivo uipath.config.

A tabela abaixo resume os processos do Windows relacionados ao Robô, as identidades de usuário sob as quais são executados e as solicitações HTTP que realizam:

Processo do Windows	Identidade do usuário	Solicitações HTTP
UiPath.ServiceHost.exe	SistemaLocal	Responsável pela comunicação de serviço com o Orchestrator, incluindo: Buscando pulsações Buscando trabalhos e enviando estados de trabalho Manuseio de logs para processos unattended Gerenciamento de autenticação para o serviço Baixando pacotes
UiPath.UserHost.exe	Usuário	Responsável pela comunicação de serviço com o Orchestrator quando instalado no Modo de Usuário, incluindo: Buscando pulsações Gerenciamento de logs para processos Processando autenticação para o Assistant Baixando pacotes
UiPath.Executor.exe	LocalSystem (ao executar um trabalho em segundo plano) Usuário (ao executar trabalhos regulares)	Responsável por lidar com solicitações HTTP específicas da automação, incluindo: Gerenciamento de ativos e itens de fila Envio de solicitações específicas de atividade (solicitações HTTP para serviços externos)
UiPath.Assistant.exe	Usuário	Responsável por lidar com tráfego relacionado ao Assistant, incluindo: Gerenciamento de lista de processos Manipulação de gatilho Interações do Marketplace
UiPath.RemoteDebugging.Agent.exe	Usuário	Responsável por lidar com tráfego de depuração remota por meio do SignalR.
UiPath.UpdateService.Worker.exe	SistemaLocal	Responsável por baixar os MSIs do Orchestrator.

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

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

Para instalações unattended, 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 da UiPath quanto o Serviço de Atualização são executados usando um Serviço do Windows, independentemente de um usuário.

Para instalações attended, as configurações para proxy também são processadas manualmente modificando o arquivo UiPath.config. No entanto, o usuário inicia tanto o Serviço de Robôs da UiPath quanto 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 para o proxy são herdadas das configurações existentes do usuário. 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 do proxy pode exigir credenciais para permitir o tráfego. Você pode configurar o proxy para autenticação usando as credenciais do usuário conectado do Windows.

Para ativar esta funcionalidade, adicione a variável de ambiente do sistema UIPATH_PROXY_USE_DEFAULT_CREDENTIALS na máquina que executa o Robô e defina seu valor como true. Isso informa ao Robô para usar as Credenciais do Windows do usuário atual para a autenticação de proxy.

Autenticação básica

A partir da versão 2021.10, o Serviço de Robôs da UiPath dá 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 Assistant identifica se uma configuração de proxy está implementada na máquina e solicita as credenciais do usuário.

Robôs do Modo de Serviço – O Executor do Robô não é compatível com 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, não pode usá-la na execução real do fluxo de trabalho. Para habilitar a Autenticação Básica para robôs em 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 Robô para as versões 2024.10.5+ para acessar essas funcionalidades em uma configuração de proxy.

Configurando o navegador da Web

1. Abra a janela Propriedades da Internet.
2. Na guia Conexões, selecione Configurações de LAN. A janela Configurações de rede de área local (LAN) será 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 o servidor do proxy manualmente, selecione Usar um servidor proxy para sua LAN e forneça o endereço do servidor de proxy e a porta.
3. Para salvar suas configurações, selecione OK.
4. No seu navegador da Web, teste a conexão acessando o URL do Orchestrator.

Definição das 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 do proxy, ative Usar script de configuração. Forneça o endereço para o script.
3. Para configurar o servidor de proxy manualmente, em Configuração manual do proxy, acesse Usar um servidor de proxy. Forneça o endereço do servidor do proxy e a porta.
   Importante:

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

   Por exemplo:

   • http://proxyaddress incorreto,
   • Correto - https://proxyaddress,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 ou o dispositivo.

Definição das configurações de proxy durante a instalação do Robô

Para adicionar as configurações de proxy durante a instalação de robôs no Modo de Serviço, use os parâmetros de linha de comando dedicados no 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"

Verificando a conexão do servidor do proxy

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