Redirecionando Robôs por meio de um Servidor de Proxy

Sempre que sua infraestrutura usar um proxy para máquinas/usuários se conectarem à Internet, você também precisará configurar o robô para usá-lo.

Há duas configurações possíveis com base no modo de instalação do robô:

1. Attended Robot - instalação no modo de usuário
2. Unattended Robot - instalação no modo de serviço

Configuração do proxy para Attended Robots (modo de usuário)

Os Attended Robots herdam as configurações de proxy definidas para seu navegador da web.

Se seu proxy precisar de autenticação básica, o Assistant solicitará que você insira suas credenciais quando você tentar pela primeira vez conectar o robô ao Orchestrator.

Você pode configurar o proxy usando a maneira antiga descrita em Configuração usando o navegador da web ou usando as configurações de proxy do Windows

Configuração do proxy para robôs não assistidos (modo de serviço)

Para configurar corretamente os robôs do modo de serviço para usar o proxy, você precisa modificar o proxy.json arquivo e as configurações do Windows correspondentes da(s) conta(s) do(s) usuário(s) que executará(ão) automações.

Para configurar o proxy em proxy.json, siga as Como definir as configurações de proxy

Para configurar o proxy para a(s) conta(s) do(s) usuário(s) que executará(ão) automações, siga a Configuração do proxy para robôs assistidos

Configuração do proxy usando 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.

Configuração do proxy usando as configurações 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.

Configuração do proxy usando o proxy.json arquivo

A partir de 10/2025, para configurar o proxy para o Unattended Robot (modo de serviço), você precisa modificar o proxy.json arquivo. Se você estiver atualizando de uma versão mais antiga e já tiver uma configuração de proxy, ela será migrada automaticamente para o novo arquivo.

1. Navegue para: %ProgramData%\UiPath\Shared.
2. Pesquise o proxy.jsonarquivo e abra-o usando um editor de texto com privilégios de administrador, como o Notepad++.
   O proxy.json arquivo é compatível com várias configurações, mas não com todas ao mesmo tempo. Se ScriptAddress e ProxyAddress estiverem presentes, ScriptAddress terá precedência.

   {
     "ScriptAddress": "http://localhost/proxy.pac",
     "ProxyAddress": "http://1.1.1.1:1234/",
     "BypassLocalAddresses": true,
     "BypassList": "server\\.domain\\.local$;www.google.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
     "UserName": "myUser",
     "Password": "myPassword",
     "Domain": "myDomain"
   }

   Observação: 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. Quando você quiser escapar um caractere em um regex, você precisará usar \\ (por exemplo: . é escapado como \\.).
   1. Para usar um script de proxy, forneça o seguinte json:

      {
      "ScriptAddress" : "http://proxy.address/proxy.pac"
      }

   2. Para fornecer um endereço de proxy, forneça o seguinte json:

      {
        "ProxyAddress": "http://proxy.address:1234/",
        "BypassLocalAddresses": true,
        "BypassList": "server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}",
        "UserName": "myUser", #used for basic auth
        "Password": "myPassword", #used for basic auth
        "Domain": "myDomain"
      }

3. Salve o arquivo proxy.json.
4. 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 ao instalar robôs não assistidos (modo de serviço), use os parâmetros de linha de comando dedicados em 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"

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.