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 mod_jk.conf when using Cosminexus HTTP Server as the Web server and in isapi_redirect.conf when using Microsoft IIS as the Web server. The keys specified are as follows:

For details on mod_jk.conf (redirector operation definition file for HTTP Server), see 9.3 mod_jk.conf (redirector operation definition file for HTTP Server) in the uCosminexus Application Server Definition Reference Guide.

For details on isapi_redirect.conf (redirector operation definition file for Microsoft IIS), see 9.2 isapi_redirect.conf (redirector operation definition file for Microsoft IIS) in the uCosminexus Application Server Definition Reference Guide.

• In mod_jk.conf
  Host name: JkGatewayHost key
  Port number: JkGatewayPort key
  URL scheme for redirect destination: JkGatewayHttpsScheme key
  
• In isapi_redirect.conf
  Host name: gateway_host key
  Port number: gateway_port key
  URL scheme for redirect destination: gateway_https_scheme key
  

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

Figure 4-26 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.

Examples of the mod_jk.conf and isapi_redirect.conf files are shown below. Specify On in the JkGatewayHttpsScheme key of mod_jk.conf and true in the gateway_https_scheme key of isapi_redirect.conf so that the URL scheme for redirect destination is always considered to be HTTPS.

Example of mod_jk.conf (in Cosminexus HTTP Server)

JkGatewayHost host1

JkGatewayPort 4443

JkGatewayHttpsScheme On

Example of isapi_redirect.conf (In Microsoft IIS)

gateway_host=host1

gateway_port=4443

gateway_https_scheme=true