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.
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 AS Java server). Processing HTTP Requests describes the subhandler call sequence.
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-Präfix> [, FROM=<Muster für URL>, FROMPROT=<Eingangsprotokoll>, FOR=<Muster für Rechnername:port>, TO=<neuer URL-Präfix>, PROT=<Protokoll>, HOST=<Rechner>, PORT=<Portnummer/name>]
<xx> must be specfiied from 0 in ascending order.
Optional Parameters
With the optional parameters FROM and FROMPORT 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 |
Meaning |
---|---|
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 . |
Note the following documentation associated with this parameter: