Redirecting Robots Through a Proxy Server

If you have a Robot that is in a closed network, or in a different network than the one Orchestrator uses, the communication between the two UiPath products is not possible. As a result, to facilitate this communication, you can use a proxy server with your Robot.

To redirect the Robot through a proxy server, you have to make multiple configurations on the Robot machine. They are split into the following steps:

1. Configure your preferred web browser, to ensure that the Robot machine can access Orchestrator through the indicated proxy server.
2. Edit the Robot and NuGet configuration files, to ensure that the connection between the Robot and Orchestrator is routed through the provided proxy server and that the activities packages and the automation processes can be downloaded through the specified proxy server.

Configuring the Web Browser

Note: This procedure uses Internet Explorer.

1. In Internet Explorer, click Tools > Internet Options. The Internet Options window is displayed.
   
   

   

   
   
2. In the Connections tab, click LAN Settings. The Local Area Network (LAN) Settings window is displayed.
   
   

   

   
   
3. In the Proxy Server section, select the Use a proxy server for your LAN check box.
4. In the Address and Port fields, enter the proxy server address and port.
5. Select the Bypass proxy server for local address check box.
6. Click OK. Your settings are saved.
7. In the web browser, enter the Orchestrator URL to test it.

Important:

When setting up or editing the proxy address, do not add the http:// prefix to the proxy address. This enables the proxy only for HTTP calls, and since most calls are HTTPS, the proxy configuration fails.

To resolve this, make sure to either remove the http:// prefix altogether, or specifically add the proxy address with both http:// and https:// prefixes.

Example:

• http=proxyaddress -> incorrect

• http=proxyaddress;https=proxyaddress -> correct

• http://proxyaddress;https://proxyaddress -> correct

Editing the Configuration Files

1. Install the UiPath Platform.
   Note: Ensure that the UiPath Robot is not running any jobs.
2. Navigate to the installation folder, %ProgramFiles(x86)%\UiPath\Studio.
3. Search for the UiPath.Service.Host.exe.config file and open it using a text editor, such as Notepad++.
4. Navigate to the Proxy configuration section and uncomment the tags under it, by removing the comment tags (<!––, ––>).
   Note: If your workflows contain Orchestrator activities, make sure to also uncomment tags under the Proxy configuration section in the UiPath.Executor.exe.config file.
5. In the proxyaddress tag input the proxy server address and port.
   
   

   

   
   
6. Save the file and close it.
7. Navigate to C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\NuGet if you have a 64-bit operating system or C:\Windows\System32\config\systemprofile\AppData\Roaming\NuGet if you have a 32-bit operating system.
8. Open the NuGet.config file using a text editor, such as Notepad++.
   Note: If this file does not exist, create it.
9. In the configuration node, add the proxy address and port in the following format:

   <configuration>
   <config>
   <add key="http_proxy" value="http://proxy_server:808" />
   </config>
   </configuration>

10. Save the file and close it.
11. Restart the Robot service. This step is required to ensure that the changes are used by the Robot.

Checking the Proxy Server Connection

1. Connect the Robot to Orchestrator.
2. Deploy some packages to an environment which contains the previously configured Robot.
3. Navigate to the %userprofile%\.nuget\ folder and check if the corresponding process and activities packages have been downloaded.
4. Run the corresponding job to check if it runs successfully.