- Release Notes
- Getting Started
- UiPath Assistant
- Installation and Upgrade
- Robot Types
- Robot Components
- Licensing
- Connecting Robots to Orchestrator
- Processes and Activities
- Logging
- Robot JavaScript SDK
- Specific Scenarios
- Windows Sessions
- Login Using Thales Luna Credential System
- Login Using NShield Key Storage Provider
- Redirecting Robots Through a Proxy Server
- Executing Tasks in a Minimized RDP Window
- Using Mapped Network Drives
- Stopping a Process
- Disable Stop Button
- Custom Package Folders and Network Paths
- CrowdStrike Integration
- Restarting Robot Components
- Troubleshooting
- About Troubleshooting
- Unresponsive Robot Over RDP
- Duplicate Execution Logs
- Frequently Encountered Robot Errors
- Increased Process Execution Duration
- Enforced Package Signature Verification
- Message Too Large to Process
- Errors When Running as Administrator
- NuGet Packages Not Accessible After Migration
- User Access Control Prompt and UI Automation Activities
Redirecting Robots Through a Proxy Server
If you have a Robot in a closed network, or in a different network than Orchestrator one, 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 some configurations on the Robot machine. They are split into the following steps:
- Configure your preferred web browser, to ensure that the Robot machine can access Orchestrator through the indicated proxy server.
- Edit the
uipath.config
file 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.Note:The user mode robot inherits the Proxy Settings from the Internet Options, while the service mode robot requires specific configuration to be made in theuipath.config
file from the Studio installation folder.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.
Important: The settings in theuipath.config
file only apply to the robot service process when installed in service-mode. Proxy settings for user-level Windows processes, including the executor (for both user-mode and service-mode installations), are not configurable throughuipath.config
.
Configurations for the Proxy Script or Proxy Address can be set from either the Connections section in Internet Options, or from the Proxy Settings menu in the Windows Settings.
- In Internet Explorer, click Tools > Internet Options. The Internet Options window is displayed.
- In the Connections tab, click LAN Settings. The Local Area Network (LAN) Settings window is displayed. Depending on your setup, you can configure a proxy configuration script or a proxy server.
- Configure the Proxy Server or Automatic Configuration (for Proxy Script).
- Click OK. Your settings are saved.
- In the web browser, enter the Orchestrator URL to test the connection.
- Open the start menu and search for Proxy Settings.
- Configure the Automatic Proxy Setup (for Proxy Script) or Manual Proxy Setup (for Proxy Server).
- Save the settings.
- In the web browser, enter the Orchestrator URL to test the connection.
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
-
- 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.-
To use a proxy script, provide the following key-value pair:
<webProxySettings> <add key="ScriptAddress" value="http://localhost/proxy.pac" /> </webProxySettings>
<webProxySettings> <add key="ScriptAddress" value="http://localhost/proxy.pac" /> </webProxySettings> -
To provide a proxy address, provide the following key-value pairs:
<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>Note: Starting with v2021.4 Robot, the bypass list should contain an array of regular expression strings that contain the URIs of the servers to bypass.
-
- Save the
uipath.config
file and restart the robot service for changes to take effect.
Below you can find some examples for the bypass list format.
www.myget.org -> ((www|WWW).){1}?(myget+(.org))
.vo.msecnd.net -> (([a-zA-Z0-9]).)+((vo+)+(.msecnd+)+(.net))
www.nuget.org -> ((www|WWW).){1}?(nuget+(.org))
gallery.uipath.com -> (([a-zA-Z0-9]).)*((gallery+)+(.uipath+)+(.com))
www.myget.org -> ((www|WWW).){1}?(myget+(.org))
.vo.msecnd.net -> (([a-zA-Z0-9]).)+((vo+)+(.msecnd+)+(.net))
www.nuget.org -> ((www|WWW).){1}?(nuget+(.org))
gallery.uipath.com -> (([a-zA-Z0-9]).)*((gallery+)+(.uipath+)+(.com))
To test the formatting for complex configurations, you can use a regex validator/generator.
ScriptAddress
and ProxyAddress
should be set. If both are set, ScriptAddress
has precedence.
BypassList
and BypassLocalAddresses
should be set only when ProxyAddress
is set.
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS
system environment variable on the machine.
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS
with value true
- Open PowerShell as administrator.
- Run the command below:
[Environment]::SetEnvironmentVariable("UIPATH_PROXY_USE_DEFAULT_CREDENTIALS", "true", "Machine")
[Environment]::SetEnvironmentVariable("UIPATH_PROXY_USE_DEFAULT_CREDENTIALS", "true", "Machine") - Restart the Robot machine.
To confirm that the system environment variable has been set successfully, run the script below in PowerShell.
$Env:UIPATH_PROXY_USE_DEFAULT_CREDENTIALS
$Env:UIPATH_PROXY_USE_DEFAULT_CREDENTIALS
true
, the configuration is in place now.
Starting with v2021.10 release, the Robot service supports Proxy Servers using Basic Authentication protocols..
webProxySettings
section from the uipath.config
file and add the following information:
<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>
- 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.
Note: When updating from versions previous to v2021.4, proxy configurations are migrated from the
proxy.config
file to theuipath.config
in order to match the new format.
- Configuring the Proxy Settings
- Configuring the Web Browser
- Configuring the Windows Proxy Settings
- Editing the uipath.config File
- Examples for bypass list
- Windows Credentials Proxy Authentication
- Configure Windows Credentials Proxy Authentication using PowerShell
- Validating the script
- Basic Authentication
- Service mode robot
- Checking the Proxy Server Connection