Angepasste Eigenschaften für HTTP-Transportkanal

Wenn Sie einen HTTP-Transportkanal verwenden, können Sie den Konfigurationseinstellungen für diesen Kanal die folgenden angepassten Eigenschaften hinzufügen.

Fehler vermeiden Fehler vermeiden: Es gibt vier Transportketten für den Web-Container:
  • WCInboundAdmin
  • WCInboundAdminSecure
  • WCInboundDefault
  • WCInboundDefaultSecure

Ein Anwendungsserver oder ein Proxy-Server übernimmt die angepassten Eigenschaftswerte, die für die Transportkette "WCInboundAdmin" oder "WCInboundAdminSecure" angegeben sind, weil eine dieser Ketten gewöhnlich die erste Kette ist, die aktiviert wird, wenn der Anwendungsserver initialisiert wird. Deshalb müssen Sie vor der Festlegung angepasster Eigenschaften für die Transportkette des Web-Containers die Transportketten "WCInboundAdmin" und "WCInboundAdminSecure" inaktivieren.

gotcha
Gehen Sie zum Hinzufügen einer angepassten Eigenschaft wie folgt vor:
  1. Klicken Sie in der Administrationskonsole auf Server > Servertypen, und wählen Sie anschließend je nach Typ der zu erstellenden Kette eine der folgenden Optionen aus:
    • Anwendungsserver > > Servername. Klicken Sie unter "Einstellungen des Web-Containers" auf Transportketten für Web-Container > Kettenname > HTTP-Kanal für eingehende Anforderungen > Angepasste Eigenschaften > Neu.
    • Klicken Sie auf WebSphere-Proxy-Server > Servername. Klicken Sie unter "HTTP-Einstellungen für Proxy-Server" auf Transporte für Proxy-Server. Wählen Sie anschließend HTTPS_PROXY_CHAIN oder HTTP_PROXY_CHAIN aus und klicken Sie auf > HTTP-Kanal für eingehende Anforderungen > Angepasste Eigenschaften > Neu.
  2. Geben Sie unter Allgemeine Eigenschaften im Feld "Name" den Namen der angepassten Eigenschaft und im Feld "Wert" den zugehörigen Wert ein. Im Feld "Beschreibung" können Sie eine Beschreibung für diese Eigenschaft eingeben.
  3. Klicken Sie auf Anwenden oder OK.
  4. Klicken Sie auf Speichern, um die Konfigurationsänderungen zu speichern.
  5. Starten Sie den Server erneut.
Im Folgenden werden die angepassten Eigenschaften für HTTP-Transportkanäle beschrieben, die mit dem Produkt bereitgestellt werden. Diese Eigenschaften werden auf der Seite mit den Einstellungen für einen HTTP-Transportkanal nicht angezeigt. Sie können auf der Seite "Angepasste Eigenschaften" die folgenden Eigenschaften definieren:

accessLogFormat

Verwenden Sie die Eigenschaft "accessLogFormat", um die Informationen anzugeben, die in das NCSA-Zugriffsprotokoll für einen HTTP-Transportkanal eingeschlossen werden sollen, und festlegen, wie diese Informationen formatiert werden sollen. Der Wert für diese Eigenschaft ist eine durch Leerzeichen getrennte Liste mit Optionen. Die Reihenfolge, in der Sie die Optionen angeben, bestimmt das Format dieser Informationen im Protokoll.

Jede Option kann in Anführungszeichen eingeschlossen werden, aber die Anführungszeichen sind nicht erforderlich. Sofern nicht anders angegeben, wird der Wert - für eine Option ausgegeben, wenn die angeforderten Informationen für diese Option nicht abgerufen werden können.

In der folgenden Liste sind die verfügbaren Optionen sowie die Informationen aufgelistet, die ausgegeben werden, wenn diese Option als Teil des für diese Eigenschaft angegebenen Werts angegeben ist.
%a
Ferne IP-Adresse
%A
Lokale IP-Adresse
%b
Antwortgröße in Bytes ausschließlich Headern
%B
Antwortgröße in Bytes ausschließlich Headern

0 wird anstelle von - ausgegeben, wenn kein Wert gefunden wird.

%{CookieName}C oder %C
Es wird das in eckigen Klammern angegebene Anforderungscookie ausgegeben. Falls die eckigen Klammern nicht angegeben sind, werden alle Anforderungscookies ausgegeben.
%D
Die abgelaufene Zeit der Anforderung in Millisekundengenauigkeit, Mikrosekundenpräzision.
%h
Ferner Host
%i oder %{HeaderName}i
Wert des Headers HeaderName aus der Anforderung
%m
Anforderungsmethode
%o oder %{HeaderName}o
Wert des Headers HeaderName aus der Antwort
%q
Ausgabe der Abfragezeichenfolge mit einem mit Escapezeichen angegebenen Kennwort
%r
Erste Zeile der Anforderung
%s
Statuscode der Antwort
%t
NCSA-Format der Startzeit der Anforderung
%(t)W
Aktuelle Zeit, zu der die Nachricht für die Protokollierung im normalen NCSA-Format in die Warteschlange für das Zugriffsprotokoll eingereiht wird
%u
Ferner Benutzer entsprechend dem speziellen $WSRU-Header von WebSphere Application Server
%U
URL-Pfad ohne die Abfragezeichenfolge
%{X}W
Kontext-ID für komponentenübergreifendes Tracing (Cross Component Tracing, XCT)

Sie können beispielsweise die folgenden Anweisungen als Wert für diese Eigenschaft angeben:

 %h %i %u %t "%r" %s %b
Basierend auf dieser Einstellung enthält das NCSA-Zugriffsprotokoll die folgenden Informationen für jede Anforderung in der angegebenen Reihenfolge:
  • Ferner Host
  • Wert des Headers HeaderName aus der Anforderung
  • Ferner Benutzer entsprechend dem speziellen $WSRU-Header von WebSphere Specific Server
  • NCSA-Format der Startzeit der Anforderung
  • Erste Zeile der Anforderung
  • Statuscode der Antwort
  • Antwortgröße in Bytes ausschließlich Headern
Fehler vermeiden Fehler vermeiden: Wenn Sie diese angepasste Eigenschaft verwenden, stellen Sie sicher, dass die Option Kettenspezifische Protokollierung verwenden in Ihren Konfigurationseinstellungen für die NCSA-Zugriffsprotokollierung ausgewählt ist. Die Option "Globalen Protokollierungsservice verwenden" ist für die NCSA-Zugriffsprotokollierung standardmäßig ausgewählt. gotcha

CookiesConfigureNoCache

Mit der Eigenschaft "CookiesConfigureNoCache" können Sie angeben, ob ein Header des Typs Set-Cookie in einer HTTP-Antwortnachricht das Hinzufügen mehrerer Cache-bezogener Header auslöst. Wenn diese Eigenschaft auf "true" gesetzt ist, werden ein Header vom Typ "Expires" mit einem sehr alten Datum und ein Header vom Typ "Cache-Control", der den Client explizit anweist, den Header "Set-Cookie" nicht zwischenzuspeichern, automatisch hinzugefügt. Wenn diese Eigenschaft auf "false" gesetzt ist, werden diese Header nicht automatisch hinzugefügt.

Die Funktionalität dieser Eigenschaft entspricht der der Eigenschaft "com.ibm.websphere.cookies.no.header", die in früheren Versionen des Produkts verfügbar war.

Information Wert
Datentyp Boolean
Standardwert True

DoNotAllowDuplicateSetCookies

Verwenden Sie die Eigenschaft "DoNotAllowDuplicateSetCookies", um zu verhindern, dass der HTTP-Kanal mehrere "Set-Cookie"-Header mit demselben Namen sendet. Der Standardwert ist "false".

Information Wert
Standardwert False

EnableBuildBackupList

Verwenden Sie die Eigenschaft "EnableBuildBackupList", um dem HTTP-Kanal zu ermöglichen, die Protokolldateien im Verzeichnis mit den Zugriffs- und Fehlerprotokollen zu suchen und diese Dateien mit neueren Protokolldateien zu überschreiben, die erstellt werden.

Wenn Sie diese Eigenschaft auf true setzen, sucht der HTTP-Kanal die Protokolldateien im Verzeichnis mit den Zugriffs- und Fehlerprotokollen und überschreibt diese Dateien mit neuen Protokolldateien, die erstellt werden.

  • Nach der Konfiguration des HTTP-Fehlerprotokolls und des NCSA-Zugriffsprotokolls müssen Sie sicherstellen, dass das Feld NCSA-Zugriffsprotokollierung aktivieren für die HTTP-Kanäle ausgewählt ist, für die die Protokollierung durchgeführt werden soll. Um sicherzustellen, dass dieses Feld für einen HTTP-Kanal ausgewählt ist, klicken Sie auf Server > Servertypen > Anwendungsserver > Server > Transportketten des Web-Containers > HTTP-Kanal für eingehende Anforderungen. Diese Einstellung muss aktiviert werden, bevor die Einstellung dieser angepassten Eigenschaft auf true Auswirkungen auf die Funktionalität des HTTP-Kanals hat.
  • Wenn Sie diese angepasste Eigenschaft verwenden, müssen Sie auch sicherstellen, dass die Option Kettenspezifische Protokollierung verwenden in Ihren Konfigurationseinstellungen für die NCSA-Zugriffsprotokollierung ausgewählt ist. Die Option Globalen Protokollierungsservice verwenden ist für die NCSA-Zugriffsprotokollierung standardmäßig ausgewählt.
Information Wert
Datentyp Boolean
Standardwert False

HonorTransferEncoding

Verwenden Sie die Eigenschaft "HonorTransferEncoding", um festzulegen, ob die HTTP-Transportkanäle eine in Blöcke aufgeteilte Nachricht in eine Nachricht mit begrenzter Inhaltslänge konvertieren soll, wenn es nur einen einzigen Block gibt.

Wenn Sie diese Eigenschaft auf true setzen, schreiben die HTTP-Transportkanäle die Blöcke, anstatt die Nachricht in eine Nachricht mit begrenzter Inhaltslänge zu konvertieren, selbst wenn die Nachricht nur aus einem einzigen Block besteht. Diese Einstellung hat Auswirkungen auf die Leistung, weil die HTTP-Transportkanäle für jede Nachricht mit nur einem einzigen Block zwei Schreiboperationen durchführen: Zuerst schreiben sie die Nachricht und anschließend den Block mit null Bytes, der das Ende der Nachricht markiert.

Wenn Sie diese Eigenschaft auf false setzen, konvertieren die HTTP-Transportkanäle eine in Blöcke aufgeteilte Nachricht in eine Nachricht mit begrenzter Inhaltslänge, wenn es nur einen einzigen Block gibt. Diese Einstellung verbessert die Kanalleistung, weil der Kanal nur eine einzige Schreiboperation für eine Nachricht mit nur einem einzigen Block durchführt, die in eine Nachricht mit begrenzter Inhaltslänge konvertiert wird.

Information Wert
Datentyp Boolean
Standardwert False

limitFieldSize

Verwenden Sie die Eigenschaft "limitFieldSize", um die Größenlimits für verschiedene HTTP-Felder, wie z. B. Anforderungs-URLs, oder einzelne Headernamen oder -Werte umzusetzen. Das Umsetzen der Größenlimits für diese Felder bietet einen Schutz vor möglichen Denial-of-Service-Angriffen. Wenn ein Feld die zulässige Größe überschreitet, wird ein Fehler zurückgegeben.

Information Wert
Datentyp Integer
Standardwert 32768
Einstellmöglichkeiten 50 bis 32768

limitNumHeaders

Verwenden Sie die Eigenschaft "limitNumHeaders", um die Anzahl der HTTP-Header in eingehenden Nachrichten zu beschränken. Wenn dieser Grenzwert überschritten wird, wird ein Fehler an den Client zurückgegeben.

Information Wert
Datentyp Integer
Standardwert 500
Einstellmöglichkeiten 50 bis 4000

localLogFilenamePrefix

Verwenden Sie die Eigenschaft "localLogFilenamePrefix", um ein Präfix für den Dateinamen der Netzprotokolldatei anzugeben. Wenn die prozessinterne Optimierung aktiviert ist, werden Anforderungen auf dem prozessinternen Pfad normalerweise basierend auf den Protokollierungsattributen protokolliert, die für die Netzkanalkette des Web-Containers definiert sind. Sie können diese Eigenschaft verwenden, um dem Dateinamen der Netzprotokolldatei ein Präfix hinzuzufügen. Dieser neue Dateiname wird anschließend für die Protokolldatei für prozessinterne Anforderungen verwendet. Anforderungen, die über den prozessinternen Pfad gesendet werden, werden in dieser Datei und nicht in der Netzprotokolldatei protokolliert. Wenn die Protokolldatei für eine Netztransportkette beispielsweise den Namen .../httpaccess.log hat und diese Eigenschaft für den HTTP-Kanal in der Kette auf local gesetzt ist, erhält die Protokolldatei für prozessinterne Anforderungen an den Host, der dieser Kette zugeordnet ist, den Namen …/localhttpaccess.log.

Fehler vermeiden Fehler vermeiden: Wenn Sie einen Wert für die angepasste Eigenschaft "localLogFilenamePrefix" angeben, müssen Sie auch die angepasste Eigenschaft "accessLogFileName" des HTTP-Kanals auf den vollständig qualifizierten Namen der Protokolldatei setzen, die Sie für in Bearbeitung befindliche Anforderungen verwenden möchten. Für diese angepasste Eigenschaft kann keine Variable wie $(SERVER_LOG_ROOT) angegeben werden. gotcha
Information Wert
Datentyp String

loggingDisable

Verwenden Sie diese angepasste Eigenschaft, um NCSA, FRCA und die Fehlerprotokollierung für die angegebene Kette zu inaktivieren.

Information Wert
Datentyp Boolean
Standardwert False

QuoteAddedNoCacheValue

Verwenden Sie diese angepasste Eigenschaft, um ein in Anführungszeichen eingeschlossenes "no-cache"-Attribut zu einem "Cache-Control"-Antwortheader hinzuzufügen, der dieses Attribut noch nicht enthält.

Der HTTP-Kanal fügt das in Anführungszeichen eingeschlossene Attribut "no-cache" ordnungsgemäß hinzu. Im folgenden Beispiel wird das Attribut "no-cache" diesem Header hinzugefügt, der in der Antwort angegeben wird: Cache-Control: public, max-age=604800, no-cache="set-cookie".

Information Wert
Standardwert False

RemoveCLHeaderInTempStatusRespRFC7230compat

Verwenden Sie die Eigenschaft RemoveCLHeaderInTempStatusRespRFC7230compat, wenn Sie sicherstellen möchten, dass der HTTP-Kanal verhindert, dass "Content-Length"-Header in Antwortnachrichten mit dem Informationsstatus 1xx oder 204 gesendet werden.

Information Wert
Standardwert False

RemoveServerHeader

Verwenden Sie die Eigenschaft "RemoveServerHeader", um das Entfernen alle Server-Header aus HTTP-Antworten, die der Anwendungsserver sendet, zu erzwingen und damit die Identität des Serverprogramms zu verbergen.

Information Wert
Datentyp Boolean
Standardwert False

ServerHeaderValue

Verwenden Sie die Eigenschaft "ServerHeaderValue", um den Standardwert des Server-Headers, der allen abgehenden HTTP-Antworten nach Server hinzugefügt wird, falls noch kein Server-Header vorhanden ist. Der Standardwert für den Server-Header ist WebSphere Application Server v/x.x, wobei x.x für die Version von WebSphere Application Server steht, die auf dem System ausgeführt wird.

Wenn in einer älteren Version als 8.5.0.2 ein Server-Header noch nicht vorhanden ist, wird allen abgehenden HTTP-Antworten von Servern entweder der Server-Standard-Header oder der als Wert dieser Eigenschaft angebene Header hinzugefügt.

Ab Version 8.5.0.2 wird abgehenden HTTP-Antworten kein Server-Header mehr automatisch hinzugefügt, es sei denn, es ist bereits ein Server-Header vorhanden. Wenn Sie diese Eigenschaft mit einem Wert hinzufügen, wird dieser Wert in den Server-Header aufgenommen, der in der Antwort enthalten ist. Wenn Sie den Wert "DefaultServerValue" angeben, wird als die Angabe WebSphere Application Server v/x.x als Server-Header-Wert verwendet.

Information Wert
Datentyp String

SustainedHighVolumeLogging

Verwenden Sie die Eigenschaft "SustainedHighVolumeLogging", um dem Protokollierungscode zu ermöglichen, den Rückstand an Einträgen aufzuholen. Diese Eigenschaft wird in der Administrationskonsole unter Anwendungsserver > Servername > Transportketten für Web-Container > Kettenname > Name des HTTP-Kanals > Angepasste Eigenschaften gesetzt.

UseCaseSensitiveKeyMatcher

Die Eigenschaft "UseCaseSensitiveKeyMatcher" wird zusammen mit "accessLogFormat" verwendet.

Wenn Sie diese Eigenschaft auf "true" setzen, muss für die in accessLogFormat verwendete Schlüsselabgleichskomponente Key Matcher die Groß-/Kleinschreibung beachtet werden. Diese Einstellung deckt Fälle ab, in denen Anweisungen in Großschreibung und in Kleinschreibung existieren (z. B. %u und %U).

Information Wert
Standardwert False

v0CookieDateRFC1123compat

Verwenden Sie die Eigenschaft v0CookieDateRFC1123compat, um festzulegen, dass der Wert für das V0-Set-Cookie-Header-Attribut "Expires" in einem vierstelligen Jahresformat anstatt in einem zweistelligen Jahresformat angegeben ist.

Standardmäßig wird der Wert für das V0-Set-Cookie-Header-Attribut "Expires" in einem zweistelligen Jahresformat angegeben. Setzen Sie die Eigenschaft v0CookieDateRFC1123compat auf true, wenn die ältere RFC1123-Eigenschaft verendet werden soll, in der ein vierstelliges Jahresformat als Wert für das V0-Set-Cookie-Attribut "Expires" erforderlich ist.

Information Wert
Datentyp Boolean
Standardwert False

WaitForEndOfMessage

Verwenden Sie diese angepasste Eigenschaft, um zu erzwingen, dass der Kanal wartet, bis das Ende der Nachricht gelesen wurde, bevor er die Antwort liefert.

Information Wert
Standardwert False

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rrun_chain_httpcustom
Dateiname:rrun_chain_httpcustom.html