icm/HTTP/redirect_<xx>

Use

This parameter is used to define an HTTP redirect (301). If the client attempts to access the URL in question, the server sends a redirect. This forces the client to access the new destination instead.

Integration

If this parameter is set, it calls the redirect subhandler of the HTTP plug-in. The HTTP request is therefore not sent to the backend (ABAP or J2EE server). Processing HTTP Requests describes the subhandler call sequence.

Properties

Work area

Internet Communication Manager, SAP Web Dispatcher

Unit

Character string

Standard value

-

Dynamically changeable

Local and on all servers

Value Range and Syntax

The parameter has the following syntax:

icm/HTTP/redirect_<xx> = PREFIX=<URL prefix>[, FROM=<pattern for URL>, FROMPROT=<incoming protocol>, FOR=<pattern for host name:port>,TO=<new URL prefix>, PROT=<protocol>, HOST=<host>, PORT=<port number/name>]  

<xx> must be specified in ascending order from 0.

Optional Parameters

With the optional parameters FROM and FROMPROT special requests can be selected for which a redirect is to be created:

?      FROM:

Pattern with wildcards *(character string) and ? (a character)

For example, the pattern /sap/* matches all requests beginning with /sap.

If FROM is not specified the redirect for URLs which match the PREFIX exactly is created.

?      FROMPROT:  

Value range: http or https. This argument is used to restrict requests to one receive protocol. If FROMPROT is not specified, a redirect is created for all protocols.

With the optional parameter FOR you can check whether a redirect is to be created at all.

?      FOR:

The pattern for host name:port can contain the wildcards * (character string) and ? (one character), and must match the value of the HTTP header field HOST. Only if it does, is a redirect executed. If it does not match the value or if the HOST header field is not set, a redirect is likewise not sent.

The pattern *.sap.com:* matches the HOST header field wassrv.sap.com:80 or wassrv2.sap.com:1080.

If the option FOR is not set, a redirect is executed for any value of the header field HOST.

You can use optional parameters PROT, HOST, PORT and TO to set the destination to a different protocol, a different host, a different port, or to a different URL. You can only specify the port and protocol once you have specified a host name. If you specify the PROT or PORT you also have to specify the HOST.

If the parameter TO is defined it describes the exact URL to which a request is forwarded. With TO no variable from the URL derived from the incoming URL can be created.

The default values for PROT, HOST, PORT and TO are values that are set when an incoming request is received. If the options are not set, these values are not changed for the redirect that is created.

Examples

Parameter Value

Description

icm/HTTP/redirect_0 = PREFIX=/, TO=/bc/bsp/demo/default.html

Access attempts on "/" are redirected to "/bc/bsp/demo/default.html".

icm/HTTP/redirect_0 = PREFIX=/, FROM=/mime/*,HOST=mimeserver, PORT=8080

Only requests with specific URL patterns are redirected to HTTPS

icm/HTTP/redirect_0 = PREFIX=/sap/bc/bex, FROMPROT=http, PROT=https, HOST=px155.sap.com

Only requests with a specific URL are redirected to HTTPS

icm/HTTP/redirect_0 = PREFIX=/, FROM=/sap*, FROMPROT=http, PROT=https, HOST=px155.sap.com

Only specific HTTP requests are redirected to HTTPS

icm/HTTP/redirect_0 = PREFIX=/, FROM=*, FROMPROT=http, PROT=https, HOST=px155.sap.com

All HTTP requests are redirected to HTTPS

icm/HTTP/redirect_0 = PREFIX=/, FROM=/mime/*,FOR=crm.sap.com*,HOST=crmserver, PORT=80

Requests with the URL prefix /mime/ and the HTTP header field HOST that matches the pattern crm.sap.com:* are redirected to the server crmserver:80.

More Information

Note the following documentation associated with this parameter:

Generic Profile Parameters with the Ending _<xx>