Robot admin guide

• Configuring the web browser
• Configuring the Windows proxy settings
• Configuring the proxy setting through command line parameters
• Editing the uipath.config file
  Important:

  When updating from versions previous to v2021.4, proxy configurations are migrated from the proxy.config file to the uipath.config in order to match the new format.

Proxy for Use Mode robots​

Proxy for Service Mode robots​

Proxy settings based on user types (Executor)​

• Local user—These processes run under the identity of the user who is currently logged into the Windows session.
• LocalSystem users****—These processes are typically services or background tasks that run with system-level privileges.

• The proxy defined for the user in Windows is used.
• The proxy settings are loaded from the uipath.config file.

The auto-update process for proxy configurations​

Windows Credentials Proxy Authentication​

Basic Authentication​

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

Live streaming and remote control in a proxy setup​

Configuring the proxy using the web browser​

1. Open the Internet Properties window.

2. On the Connections tab, select LAN settings. The Local Area Network (LAN) Settings window opens. Depending on your setup, you can set a proxy configuration script or a proxy server.

   

   1. To use a proxy script, select Use automatic configuration script, and provide the address to the script.
   2. To manually set up the proxy server, select Use a proxy server for your LAN, then provide the address of the proxy server and the port.

3. To save your settings, select OK.

4. In your web browser, test the connection by accessing the Orchestrator URL.

Configuring the proxy using Windows settings​

1. Open the Proxy settings window.
2. To use a proxy script, under Automatic proxy setup, switch on the Use setup script. Provide the address to the script.
3. To manually set up the proxy server, under Manual proxy setup, switch on the Use a proxy server. Provide the address of the proxy server and the port.
   Important:

   Adding the http:// prefix to the proxy server address prevents Robot from making HTTPS calls. To ensure the proxy works as expected, remove the http:// prefix entirely or add the proxy address with both http:// and https:// prefixes. For example:

   • Incorrect - http://proxyaddress,
   • Correct - https://proxyaddress, http://proxyaddress; https://proxyaddress
4. To save your settings, select Save.

Editing the uipath.config file​

1. Navigate to the installation folder, %ProgramFiles%\UiPath\Studio.
2. Search for the uipath.config file and open it using a text editor, such as Notepad++.
3. Add the <webProxySettings> tag and set the values based on your proxy environment.
   1. To use a proxy script, provide the following key-value pair:
      assignment

      <webProxySettings>
          <add key="ScriptAddress" value="http://localhost/proxy.pac" />
      </webProxySettings>
      <webProxySettings>
          <add key="ScriptAddress" value="http://localhost/proxy.pac" />
      </webProxySettings>
      

   2. To provide a proxy address, provide the following key-value pairs:
      assignment

      <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>
      <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. Save the uipath.config file.
5. Restart the Robot service or the device.

Configuring the proxy settings during Robot installation​

UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_SCRIPT_ADDRESS=http://localhost/proxy.pac
UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_SCRIPT_ADDRESS=http://localhost/proxy.pac

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"

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.