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.

- 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- Klicken Sie in der Administrationskonsole auf
- . Klicken Sie unter "Einstellungen des Web-Containers" auf Kettenname .
- Klicken Sie auf . Klicken Sie unter "HTTP-Einstellungen für Proxy-Server" auf . Wählen Sie anschließend oder aus und klicken Sie auf .
,
und wählen Sie anschließend je nach Typ der zu erstellenden Kette eine der folgenden Optionen aus:
- 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.
- Klicken Sie auf Anwenden oder OK.
- Klicken Sie auf Speichern, um die Konfigurationsänderungen zu speichern.
- Starten Sie den Server erneut.
- accessLogFormat
- CookiesConfigureNoCache
- DoNotAllowDuplicateSetCookies
- EnableBuildBackupList
- HonorTransferEncoding
- limitFieldSize
- limitNumHeaders
- localLogFilenamePrefix
- loggingDisable
- QuoteAddedNoCacheValue
- RemoveCLHeaderInTempStatusRespRFC7230compat
- RemoveServerHeader
- ServerHeaderValue
- UseCaseSensitiveKeyMatcher
- v0CookieDateRFC1123compat
- WaitForEndOfMessage
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.
- %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
- 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

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.

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