- Getting started
- Understanding UiPath Robot
- UiPath Assistant
- Installation requirements
- Installing robots for unattended automations
- Configuring robots for unattended automations
- Connecting robots for unattended automations to Orchestrator
- Setting up Windows Server for high-density robots
- Redirecting robots through a proxy server
- Implementing authentication
- Adjusting registry settings for execution in minimized RDP windows
- Using network locations
- Setting up Linux robots
- Configuring package signature verification
- Setting up package folders and network paths
- Configuring activity feeds
- Deploying unattended automations
- Installing robots for attended automations
- Configuring robots for attended automations
- Integrations
- Troubleshooting
Redirecting robots through a proxy server
For a Robot to establish direct communication with Orchestrator, it needs to be on the same network or use an open one. Otherwise, you need to set up a proxy server to facilitate the communication.
Set up a proxy by either using a proxy script or supplying the proxy server address with a list of addresses to bypass. Only one method can be used. If both are configured, the proxy script takes precedence.
The following configuration options are available:
-
Configuring the web browser
-
Configuring the Windows proxy settings
-
Configuring the proxy setting through command line parameters
-
Editing the
uipath.config
file
proxy.config
file to the uipath.config
in order to match the new format.
User Mode robots inherit the proxy settings configured for your web browser.
For proxy settings that require basic non-Windows authentication, store the necessary credentials in the Credential Manager of the machine.
To apply proxy settings on User Mode robots, you need to restart the User Host Service. You can do this by signing out of the Windows user session and then signing back in.
uipath.config
file and the corresponding Windows Settings of the user account running the Robot.
You can configure the auto-update process for robots operating behind a proxy, depending on the on the Robot installation type:
UiPath.config
file. Both the Robot Service and the Update Service run using a Windows Service, independent of a user.
UiPath.config
file. However, the user starts both the Robot Service and the Update Agent. The Update Service runs using a Windows Service.
For quick installations, configurations for the proxy are inherited from the existing user settings. The user initiates all services: Robot Service, Update Agent, and Update Service.
The proxy server might require credentials to allow traffic. You can configure the proxy to authenticate using the credentials of the logged-in Windows user.
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS
on the machine running the Robot and set its value to true
. This tells the Robot to use the Windows Credentials of the current user for proxy authentication.
Starting with version 2021.10, the Robot Service supports proxy servers using Basic Authentication protocols.
User Mode robots - With Basic Authentication, the Assistant identifies if a proxy configuration is implemented on the machine and prompts the user for their credentials.
UiPath.config
file with the following proxy parameters:
<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>
- Navigate to the installation folder,
%ProgramFiles%\UiPath\Studio
. - Search for the
uipath.config
file and open it using a text editor, such as Notepad++. - Add the
<webProxySettings>
tag and set the values based on your proxy environment. - Save the
uipath.config
file. - Restart the Robot Service.
To add the proxy settings while installing Service Mode robots, use the dedicated command line parameters in your installation command.
For example, the following command installs the Robot in Service Mode and uses a script to configure proxy:
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
The following command installs the Robot in Service Mode and sets up the Basic Authentication for proxy settings:
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"
- Connect the Robot to Orchestrator
- Deploy some packages to an environment which contains the previously configured Robot.
- Navigate to the
%userprofile%\.nuget\
folder and check if the corresponding process and activities packages have been downloaded. - Run the corresponding job to check if it runs successfully.
- Proxy for Use Mode robots
- Proxy for Service Mode robots
- The auto-update process for proxy configurations
- Windows Credentials Proxy Authentication
- Basic Authentication
- Live streaming and remote control in a proxy setup
- Configuring the web browser
- Configuring the Windows proxy settings
- Editing the uipath.config file
- Configuring the proxy settings during Robot installation
- Checking the proxy server connection