AJAX proxy - General configuration parameters
Overview
Add general proxy configuration parameters to proxy-config.xml by using meta-data elements.
Configure HTTP connection handling
Use the following configration parameters to influence the HTTP connection handling of the proxy:
- socket-timeout
- Timeout, in millseconds, the proxy server waits for data after successfully establishing a connection with the target server.
Default is 20 seconds. A timeout value of zero is infinite.
- retries
- Number of retries that should be performed if the proxy could not establish a connection with the target server. Default is 2 retries.
- max-total-connections
- Maximum number of HTTP connections that the proxy can open to connect to arbitrary target hosts. Default is 100 connections.
- max-connections-per-host
- Number of HTTP connections the proxy can open to connect to a specific host. Default is 5 connections per host.
- unsigned_ssl_certificate_support
- If true, the proxy connects to any HTTPS URL allowed by the policy, regardless of whether or not it trusts the specified host. The default setting is true.
- forward-http-errors
- Whether the proxy forwards additional HTTP error codes to the client. Valid values are false and true:
- false
- Default. Only 2xx and 3xx status codes are forwarded, whereas 4xx error codes are automatically mapped to a 404 'Not Found' error.
- true
- If true makes the proxy forward every status code, even if it represents an error code.
- forward-credentials-from-vault
- Whether user credentials retrieved from the credential vault of the portal can be forwarded to the specified target host using a HTTP authorization request header. Default is false which means that the proxy does not forward credentials.
Configure a Boundary (Passthru) Proxy
Use the following configuration parameters to make connections through a boundary (passthru) proxy:
- passthru_host
- Host name of the passthru proxy.
- passthru_port
- Port of the passthru proxy.
- passthru_realm
- Optional. Authentication realm of the passthru proxy.
- passthru_username
- Optional. User name for the passthru proxy.
- passthru_password
- Optional. Password for the passthru proxy.
Parent topic:
The proxy-config.xml file
Related reference
Access policies
Context path mappings
IP filtering
Examples of AJAX proxy configurations