icm/HTTP/redirect_<xx>
Mit diesem Parameterwert können Sie einen HTTP-Redirect(301) definieren. Versucht der Client auf die URL zuzugreifen, schickt der Server den Redirect und veranlasst den Client stattdessen auf das neu spezifizierte Ziel zuzugreifen.
Ist dieser Parameter gesetzt, wird der Redirect-Subhandler des HTTP-Plugins aufgerufen. Der HTTP-Request wird also nicht ins Backend (AS ABAP oder AS Java) geleitet. Die Aufrufreihenfolge der Subhandler ist im Abschnitt Bearbeitung von HTTP-Requests beschrieben.
|
Arbeitsgebiet |
Internet Communication Manager, SAP Web Dispatcher |
|
Einheit |
Zeichenkette |
|
Standardwert |
- |
|
Dynamisch änderbar |
Lokal und auf allen Servern |
Wertebereich und Syntax
Der Parameter hat folgende 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> muss dabei von 0 aufsteigend angegeben werden.
Optionale Parameter
Mit den optionalen Parametern FROM und FROMPROT können spezielle Requests ausgewählt werden, für die ein Redirect erzeugt werden soll:
-
FROM :
Muster mit den Wildcards * (Zeichenkette) und ? (ein Zeichen)
z.B. passt das Muster /sap/* auf alle Requests, die mit /sap beginnen.
Wird FROM nicht angegeben, wird der Redirect für URLs erzeugt, die mit PREFIX exakt übereinstimmen.
-
FROMPROT :
Wertebereich: http oder https . Mit diesem Argument können Requests auf ein Empfangsprotokoll eingeschränkt werden. Wird FROMPROT nicht angegeben, wird für alle Protokolle ein Redirect erzeugt.
Mit dem optionalen Parameter FOR können Sie prüfen, ob überhaupt ein Redirect erzeugt werden soll:
-
FOR :
Das Muster für Rechnername:port kann die Wildcards * (Zeichenkette) und ? (ein Zeichen) enthalten und muss auf den Wert des HTTP-Headerfeldes HOST passen. Nur dann wird ein Redirect durchgeführt. Passt es nicht oder ist das HOST -Headerfeld nicht gesetzt, erfolgt ebenfalls kein Redirect.
BeispielDas Muster *.sap.com:* passt auf das HOST -Headerfeld wassrv.sap.com:80 oder wassrv2.sap.com:1080 .
Ist die Option FOR nicht gesetzt, wird ein Redirect für beliebige Werte des Headerfeldes HOST durchgeführt.
Mit den optionalen Parametern PROT , HOST , PORT und TO kann das Ziel auf ein anderes Protokoll, einen anderen Rechner, einen anderen Port oder eine andere URL gesetzt werden. Port und Protokoll können allerdings nur angegeben werden, wenn auch ein Rechnername angegeben wurde. Die Angabe von PROT oder PORT erfordert also auch die Angabe von HOST .
Wenn der Parameter TO angegeben ist, beschreibt er exakt die URL, an die eine Anfrage weitergeleitet wird. Mit TO kann keine variable, von der eingehenden URL abgeleitete URL erzeugt werden.
Die Standardwerte für PROT , HOST und PORT und TO sind die Werte, die beim eingehenden Request gesetzt sind. Sind die Optionen nicht gesetzt, so werden diese Werte beim erzeugten Redirect nicht verändert.
Beispiele
|
Parameterwert |
Bedeutung |
|---|---|
|
icm/HTTP/redirect_0 = PREFIX=/, TO=/bc/bsp/demo/default.html |
Zugriffe auf / werden auf /bc/bsp/demo/default.html umgeleitet. |
|
icm/HTTP/redirect_0 = PREFIX=/, FROM=/mime/*,HOST=mimeserver, PORT=8080 |
Nur Requests mit bestimmten URL-Mustern werden auf HTTPS umgeleitet |
|
icm/HTTP/redirect_0 = PREFIX=/sap/bc/bex, FROMPROT=http, PROT=https, HOST=px155.sap.com |
Nur Requests mit einer bestimmten URL werden auf HTTPS umgeleitet |
|
icm/HTTP/redirect_0 = PREFIX=/, FROM=/sap*, FROMPROT=http, PROT=https, HOST=px155.sap.com |
Nur bestimmte HTTP-Requests werden auf HTTPS umgeleitet |
|
icm/HTTP/redirect_0 = PREFIX=/, FROM=*, FROMPROT=http, PROT=https, HOST=px155.sap.com |
Alle HTTP-Requests werden auf HTTPS umgeleitet |
|
icm/HTTP/redirect_0 = PREFIX=/, FROM=/mime/*,FOR=crm.sap.com*,HOST=crmserver, PORT=80 |
Anfragen mit dem URL-Präfix /mime/ und dem HTTP-Headerfeld HOST , dass auf das Muster crm.sap.com:* passt, werden auf den Rechner crmserver:80 umgeleitet. |
Beachten Sie im Zusammenhang mit diesem Parameter folgende Dokumentation: