To use the gateway specification functionality:

1. Specify the gateway host name, port number, and URL scheme for redirect destination for each redirector.
2. Restart the Web server.

Specify the gateway host name, port number, and URL scheme for redirect destination in the Easy Setup definition file. Specify the following parameters in the <configuration> tag of the logical Web server (web-server):

• Host name: JkGatewayHost
• Port number: JkGatewayPort
• URL scheme for redirect destination: JkGatewayHttpsScheme

For details about the Easy Setup definition file and the parameters, see 4.6 Easy Setup definition file in the uCosminexus Application Server Definition Reference Guide.

The following figure shows the example settings for the gateway specification functionality:

Figure 4-25 Example settings for the gateway specification functionality

In this example, an SSL accelerator is placed between the client and Web server. Even if a client accesses an SSL accelerator via HTTPS, the SSL accelerator accesses a Web server via HTTP, which causes the Web container to assume that the access uses HTTP. For this reason, HTTP is used for the URL scheme for the top page of the Web application or Form authentication window that is the redirection destination. In this situation, by using the gateway specification function to specify that the scheme be always considered as HTTPS, you can ensure that accesses are properly redirected.

An example of the Easy Setup definition file is described below. Specify On in the JkGatewayHttpsScheme parameter so that the URL scheme for redirect destination is always considered to be HTTPS.

Example of Easy Setup definition file

 
...
<param>
 <param-name>JkGatewayHost</param-name>
 <param-value>host1</param-value>
</param>
<param>
 <param-name>JkGatewayPort</param-name>
 <param-value>4443</param-value>
</param>
<param>
 <param-name>JkGatewayHttpsScheme</param-name>
 <param-value>On</param-value>
</param>
...