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). The section "Processing HTTP Requests" describes the subhandler call sequence.

Structure

Work area

Internet Communication Manager, SAP Web Dispatcher

Unit

Character string

Default 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>]
            

The <xx> index is a number without a leading 0.

Tip The indexes of ICM and SAP Web Dispatcher vector parameters do not have to be assigned sequentially, they can normally contain gaps. Exceptions are the two profile parameters icm/HTTP/server_cache and is/HTTP/virt_host. See the metadata of the respective profile parameter.

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 wild cards * (character string) and ? (a 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 can be created from the URL derived from the incoming URL.

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.