Show TOC

icm/HTTP/redirect_<xx>Locate this document in the navigation structure

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.

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.

Structure

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.

    Example

    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 .

More Information

Note the following documentation associated with this parameter:

Generic profile parameters with the ending _<xx>