robot
2024.10
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do administrador do robô

Última atualização 17 de fev de 2025

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 LocalSystemEsses 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 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 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 Robot para as versões 2024.10.5+ para acessar esses recursos 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.
    docs image
    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:

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

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

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White