If you use a proxy server or firewall, you have to set the
https_proxy environment variable in order to allow Ranorex Webtestit to access external services. You can do this either by setting the environment variables on your machine, using the preferences dialog from within the application or by manually editing the settings.json file from outside the application.
Setting up the system environment variables
- Set the
https_proxyvariable with the hostname or IP address of the proxy server:
- If the proxy server requires a user name and password, include them in the following form:
- If the proxy server uses a port other than 80, include the port number:
Similarly, http_proxy is for HTTP protocol communication.
- Open the Control Panel and click the System icon.
- The System Properties dialog is displayed.
- On the Advanced tab, click on Environment Variables.
- The Environment Variables dialog is displayed.
- Click New in the System variables panel.
- The New System Variable dialog is displayed.
https_proxywith the appropriate proxy information (see examples above).
Mac / Linux
https_proxy environment variable using the command specific to your shell (e.g.
To make this change persistent, add the command to the appropriate profile file for the shell.
For example, in bash, add a line like the following to your
https_proxy=http://username:[email protected]:port; export https_proxy;
The scaffolded maven project needs a dedicated setting in order to use the proxy server.
In your user-home directory, you’ll find the folder
.m2 with a
Find here the official Maven documentation
Open or create the file and add the
<?xml version="1.0" encoding="UTF-8"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> . . <proxies> <proxy> <id>example-proxy</id> <active>true</active> <protocol>http</protocol> <host>proxy.example.com</host> <port>8080</port> <username>proxyuser</username> <password>somepassword</password> </proxy> </proxies> . . </settings>
If you want to set up your local endpoint to use a proxy server, you can do that simply by filling out the desired capabilities field with the address and port number of your proxy
Using the preferences dialog
The easiest way is to use our preferences dialog from the applications main menu.
Enter your proxy settings in the HTTP proxy and HTTPS proxy fields and you are good to go!
Editing the settings.json file from outside the application
If you are unable to log into Ranorex Wetbtestit and need to set up your proxy values without touching the system environment variables check out this topic, describing how to accomplish this outside the application.
Here you can find additional information on proxy settings