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.

Configuração do proxy usando uma senha criptografada

Se sua política de segurança não permite o armazenamento da senha do proxy em texto não criptografado, você pode preencher um campo EncryptedPassword em vez de Password. O Robô o descriptografa ao autenticar no proxy.

O campo tem a seguinte semântica:

• Cleartext tem precedência. Se Password e EncryptedPassword estiverem presentes, Password prevalece. Para usar o valor criptografado, deixe Password em branco ou remova-o por completo.
• API de Proteção de Dados do Windows (DPAPI) associada a esta máquina. O texto cifrado é produzido com o DPAPI (escopo LocalMachine ) e só é válido na máquina em que foi gerado.

Geração do valor criptografado

Salve o script abaixo como Encrypt-ProxyPassword.ps1 na máquina do robô e execute-o a partir de um PowerShell normal — sem necessidade de elevação.

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

O script imprime o texto cifrado codificado em Base64 na saída padrão.

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))

Aplicação do valor criptografado

1. Abra %ProgramData%\UiPath\Shared\proxy.json com privilégios de administrador.
2. Se presente, remova o Password .
3. Adicione EncryptedPassword com o valor produzido pelo script:

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

4. Salve o arquivo.
5. Reinicie o serviço do Robô.

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.