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 Configurações de proxy.

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

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 arquivo proxy.json

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 bypass deve conter uma matriz de strings de expressões regulares que contêm os URIs dos servidores a serem ignorados. Quando 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.

Configuring the proxy using an encrypted password

If your security policy disallows storing the proxy password in clear text, you can populate an EncryptedPassword field instead of Password. The Robot decrypts it when authenticating against the proxy.

The field has the following semantics:

• Cleartext takes precedence. If both Password and EncryptedPassword are present, Password wins. To rely on the encrypted value, leave Password empty or remove it entirely.
• Windows Data Protection API (DPAPI) bound to this machine. The ciphertext is produced with the DPAPI (LocalMachine scope) and is only valid on the machine where it was generated.

Generating the encrypted value

Save the script below as Encrypt-ProxyPassword.ps1 on the Robot machine and run it from a normal PowerShell — no elevation required.

.\Encrypt-ProxyPassword.ps1 -Password 'myPassword'

The script prints the Base64-encoded ciphertext to standard output.

param(
    [Parameter(Mandatory = $true)]
    [string] $Password
)

Add-Type -AssemblyName System.Security

[Convert]::ToBase64String(
    [Security.Cryptography.ProtectedData]::Protect(
        [Text.Encoding]::UTF8.GetBytes($Password),
        $null,
        [Security.Cryptography.DataProtectionScope]::LocalMachine))

Applying the encrypted value

1. Open %ProgramData%\UiPath\Shared\proxy.json with administrator privileges.
2. If present, remove the Password field.
3. Add EncryptedPassword with the value produced by the script:

   {
     "ProxyAddress": "http://proxy.address:1234/",
     "BypassLocalAddresses": true,
     "UserName": "myUser",
     "EncryptedPassword": "AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAA...",
     "Domain": "myDomain"
   }
   

4. Salve o arquivo.
5. Restart the Robot service.

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