Proxy Configuration (Configuring Java CAPS Environment Components for Communications Adapters)

Configuring Java CAPS Environment Components for Communications Adapters

Proxy Configuration

The properties in this section specify the information required for the Adapter to access the external systems through a proxy server.

Use the Proxy Configuration settings in the client HTTPS Environment properties, when setting the desired URL dynamically within a Collaboration (Java) or Business Process.

Note –

It is a known behavior of the Java Virtual Machine (JVM) to bypass an invalid proxy server through a local connection. As a result, you may still get a response, even if the proxy setting is invalid. This false response only happens with an HTTP connection. An HTTPS connection ensures authenticated handshaking from the proxy.

The HTTPS Adapter client bypasses the proxy server when accessing local addresses. This contrasts a web browser’s behavior where all requests are sent to a proxy even if they are local.

Proxy Configuration includes the configuration parameters listed in the following table.

Table 61 Environment Configuration—Proxy Configuration


Name	Description	Required Value
Proxy Host	Specifies the host name of the HTTP proxy. This specifies the HTTPS proxy host to which requests to an HTTP server or reception of data from an HTTP server may be delegated to a proxy. This sets the proxy port for secured HTTP connections.	A valid HTTPS proxy host name.
Proxy Port	Specifies the port of the HTTPS proxy. This specifies the HTTPS proxy port to which requests to an HTTP server or reception of data from an HTTP server may be delegated to a proxy. This sets the proxy port for secured HTTP connections.	A valid HTTPS proxy port. The default is 8080.
Proxy Username	Specifies the user name necessary for authentication to access the proxy server.	A valid user name. Note – The user name is required by URLs that require HTTP basic authentication to access the site. Be sure to enter a value for this property before you enter a value for the Proxy password properties.
Proxy Password	Specifies the password required for accessing the HTTPS proxy.	The appropriate password. Note – Be sure to enter a value for the Proxy username properties before entering this property.

An additional task to properly configure the Proxy properties is to edit the PropertyPermission utility of the server.policy file in the application server:

To Edit the Property Permission Utility of the server.policy File

Navigate to
c:\JavaCAPS\appserver\is\lib\install\templates\
where, c:\JavaCAPS is the location of your installation.

Add the following syntax to the server.policy file:

permission java.util.PropertyPermission “*”, “read,write”;

For the permission changes to take place, you need to create a new domain.

See Creating and Starting the Domain to create a new domain.