Set up a proxy for private synthetic monitoring
ActiveGate version 1.177
- To set a proxy for communication with the tested resource, edit the custom.properties file and set properties in the
[synthetic]
section. - To set a proxy only for internal communication with DESK server, see Setting up proxy for ActiveGate.
- To set the same proxy for both a tested resource and DESK server, set properties in the
[http.client]
section.
You can use the following properties when configuring a proxy for your synthetic-enabled ActiveGate.
Property | Default value | Description | [synthetic] | [http.client] |
---|---|---|---|---|
proxy-server |
unset | Proxy server address | yes | yes |
proxy-port |
unset | Proxy port (numeric). Optional. If left empty, the default 8080 port is used |
yes | yes |
proxy-user |
unset | Proxy user name (optional) | yes | yes |
proxy-password |
unset | Proxy password (optional). The password provided in the proxy-password property is obfuscated following ActiveGate restart and the obfuscated password is stored in the proxy-password-encr property. |
yes | yes |
proxy-off |
unset | Disable proxy communication between ACtiveGate and tested resource | yes | no |
proxy-non-proxy-hosts |
unset | Do not use proxy when communicating with these hosts. To include a number hosts, separate them with the | characters. You can also use an asterisk * to replace any string. For example: proxy-non-proxy-hosts=*gdansk.desk.com|my.corp.org |
yes | no |
Have a look at the possible scenarios for your proxy configuration.
I only want to proxy communication to DESK server
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password
[synthetic]
proxy-off=true
I want to proxy communication to both, DESK server and the tested resource
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password
I want to use different proxies for DESK server and the tested resources
To DESK server:
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password
To the tested resource:
[synthetic]
proxy-server=<proxy between AG and tested resource>
proxy-port=9090
proxy-user=username_two
proxy-password=password_two
I want to proxy communication to the tested resource and/or to Amazon S3
The synthetic-enabled ActiveGate needs an access to the Amazon S3 service to upload and access private browser monitor screenshots.
[synthetic]
proxy-server=<proxy between AG and tested resource>
proxy-port=8080
proxy-user=username
proxy-password=password
I only want to proxy communication for synthetic but connect directly to some other resources
[synthetic]
proxy-server=<proxy between AG and tested resource>
proxy-port=8080
proxy-user=username
proxy-password=password
proxy-non-proxy-hosts=my.corp.org|*.gdansk.desk.com