HTTP Proxy Setup (3.2)

Owned by Former user (Deleted)
Last updated: Aug 02, 2023
2 min read

 is capable of routing outgoing HTTP traffic through an HTTP proxy. It is useful but not limited to a network setup where the execution context has limited access to the internet. A configuration has to be performed on each Execution Context (EC) that is required to run HTTP traffic through a proxy.

Not every agent in  can use HTTP Proxy. Please check the documentation for the respective agents to check if they support HTTP Proxy.


This chapter has the following sections:

Configuring the System Properties

A set of system properties can be configured with the help of the Web Interface(3.2) on the Execution Context (EC) in an EC Deployment level in order to use the Proxy functionality.

Refer to Proxy Properties here: EC Properties(3.2)

Note!

At least one of these properties has to be set to use HTTP Proxy:

  • http.proxyHost

  • https.proxyHost

Bypassing Proxy Configuration

It is possible to provide a list of destination hosts that should not be routed through the proxy. Check the Proxy Properties table in EC Properties(3.2) for how to configure it.

Note!

Here the IP(v4) address of the cluster running the Usage Engine EC Deployment should be added to the list of non proxy hosts for example we can configure something like below. In this example, 10.43.0.1 is the cluster IP. This is necessary as we do not support proxy for internal servers.

  • http.nonProxyHosts = 10.43.0.1 | other.ip.addrs | 192.168.1.18


Authenticating the Proxy Server

Usage Engine supports basic authentication for HTTP proxy. The username and password are configured using the system properties file. Check the Proxy Properties table in EC Properties(3.2).

Note!

To use basic authentication, you need to set the following system properties. Check the example configuration below for more information.

  • jdk.http.auth.proxying.disabledSchemes=" "
  • jdk.http.auth.tunneling.disabledSchemes=" "

Please check the documentation for the JDK version you currently use to verify if Basic Authentication is disabled by default.


Note!

HTTPS proxies are not supported. Currently, only HTTP version 1 is supported to be routed through proxy.


Example Configuration

Here is an example of configuring the system properties to use HTTP Proxy.

Use the EC Deployment - EC Advanced Properties editing process to edit the system properties. See, Editing an EC Deployment(3.2).

EC Deployment Overview


Edit System Properties