Skip to main content

Using a Proxy Server

A InterSystems IRIS® data platform web client can communicate with a web service via a proxy server. In order to set this up, specify properties of the web client instance to indicate the proxy server to use. These properties are as follows:

HttpProxyServer

Specifies the host name of the proxy server to use. If this property is not null, the HTTP request is directed to this machine.

For information on specifying the default proxy server, see Using a Proxy Server.

HttpProxyPort

Specifies the port to connect to, on the proxy server.

For information on specifying the default proxy port, see Using a Proxy Server.

HttpProxyHTTPS

Specify this as true if you are using a proxy server and if that proxy server supports HTTPS.

Note that if you are using HTTPS, you must also set the SSLConfiguration property of the client equal to the name of the SSL/TLS configuration; for more details, see Configuring the Client to Use SSL.

HttpProxyAuthorization

If the web client should authenticate itself with the proxy server, specify this as the required Proxy-Authorization header field.

HttpProxyTunnel

Specify this as true if the web client should establish a tunnel through the proxy to the target HTTP server. If true, the request uses the HTTP CONNECT command to establish a tunnel. The address of the proxy server is taken from the HttpProxyServer and HttpProxyPort properties. If the endpoint URL has the https: protocol, then once the tunnel is established, InterSystems IRIS negotiates the SSL connection. In this case, the HttpProxyHTTPS property is ignored because the tunnel establishes a direct connection with the target system.

FeedbackOpens in a new tab