Propiedades personalizadas del canal de transporte HTTP

Si está utilizando el canal de transporte HTTP, puede añadir cualquiera de las propiedades personalizadas siguientes a los valores de configuración de dicho canal.

Avoid trouble Avoid trouble: Hay cuatro cadenas de transporte de contenedor web:
  • WCInboundAdmin
  • WCInboundAdminSecure
  • WCInboundDefault
  • WCInboundDefaultSecure

Los servidores de aplicaciones o proxy heredan los valores de propiedad personalizada especificados para las cadenas de transporte WCInboundAdmin o WCInboundAdminSecure porque una de estas cadenas suele ser la primera que se activa cuando se inicializa el servidor de aplicaciones. Por lo tanto, antes de especificar ninguna propiedad personalizada para una cadena de transporte de contenedor web, debe inhabilitar las cadenas de transporte WCInboundAdmin y WCInboundAdminSecure.

gotcha
Para añadir una propiedad personalizada:
  1. En la consola administrativa, pulse Servidores > Tipos de servidor y seleccione una de las opciones siguientes, en función del tipo de cadena que vaya a crear:
    • Servidores de aplicaciones > > nombre_servidor. En Valores de contenedor web, pulse Cadenas de transporte del contenedor web > nombre_cadena > Canal de entrada HTTP > Propiedades personalizadas > Nueva.
    • Servidores proxy WebSphere > nombre_servidor. En Valores de servidor proxy HTTP, pulse Transportes de servidor proxy. A continuación, seleccione HTTPS_PROXY_CHAIN o HTTP_PROXY_CHAIN y pulse > Canal de entrada HTTP > Propiedades personalizadas > Nueva.
  2. Bajo Propiedades generales, especifique el nombre de la propiedad personalizada en el campo Nombre y un valor para esta propiedad en el campo Valor. También puede especificar una descripción de esta propiedad en el campo Descripción.
  3. Pulse Aplicar o Aceptar.
  4. Pulse Guardar para guardar los cambios realizados en la configuración.
  5. Reinicie el servidor.
La siguiente es una descripción de las propiedades personalizadas del canal de transporte HTTP que se proporcionan con el producto. Estas propiedades no se muestran en la página de valores de un canal de transporte HTTP. Puede utilizar la página de propiedades personalizadas para definir las siguientes propiedades:

accessLogFormat

Utilice la propiedad accessLogFormat para especificar la información que desea incluir en el registro de acceso NCSA para un canal de transporte HTTP, y cómo desea que se formatee la información. El valor de esta propiedad es una lista de opciones separada por espacios. El orden en que se especifican las opciones determina el formato de esta información en el registro.

Cada opción se puede poner entre comillas, pero éstas no son obligatorias. A menos que se indique lo contrario, un valor de - se añade a una opción si la información solicitada no se puede obtener para dicha opción.

La lista siguiente indica las opciones disponibles y la información que se imprime si esa opción se especifica como parte del valor especificado para la propiedad.
%a
Dirección IP remota
%A
Dirección IP local
%b
Tamaño de respuesta en bytes sin contar las cabeceras
%B
Tamaño de respuesta en bytes sin contar las cabeceras

Se inserta 0 en lugar de - si no se encuentra ningún valor.

%{CookieName}C o %C
La cookie de solicitud especificada dentro de los corchetes, o si no se incluyen los corchetes, imprime todas las cookies de solicitud.
%D
El tiempo transcurrido de la solicitud - precisión de milisegundos, precisión de microsegundos
%h
Host remoto
%i o %{HeaderName}i
Valor de cabecera HeaderName de la solicitud
%m
Método de solicitud
%o o %{HeaderName}o
Valor de cabecera HeaderName de la respuesta
%q
Genera la serie de consulta con una contraseña con carácter de escape
%r
Primera línea de la solicitud
%s
Código de estado de la respuesta
%t
Formato NCSA de la hora de inicio de la solicitud
%(t)W
Hora actual a la que el mensaje al registro de acceso se pone en cola para registrarse en formato NCSA normal
%u
Usuario remoto de acuerdo con la cabecera $WSRU específica de WebSphere Application Server
%U
Vía de acceso de URL, sin incluir la serie de consulta
%{X}W
ID de contexto de rastreo de componentes cruzados (XCT)

Por ejemplo, puede especificar las directivas siguientes como valor para esta propiedad:

 %h %i %u %t "%r" %s %b
Basándose en esta configuración, el registro de acceso NCSA incluirá la siguiente información para cada solicitud en el orden especificado:
  • El host remoto
  • El valor de cabecera HeaderName de la solicitud
  • El usuario remoto de acuerdo con la cabecera $WSRU específica de WebSphere
  • El formato NCSA de la hora de inicio de la solicitud
  • La primera línea de la solicitud
  • El código de estado de la respuesta
  • El tamaño de respuesta en bytes sin contar las cabeceras
Avoid trouble Avoid trouble: Si utiliza esta propiedad personalizada, asegúrese de que la opción Utilizar registro específico de cadena esté seleccionada como parte de sus valores de configuración para el Registro de accesos NCSA. De forma predeterminada, la opción Utilizar servicio de registro global se selecciona para el registro de acceso NCSA. gotcha

CookiesConfigureNoCache

Utilice la propiedad CookiesConfigureNoCache para especificar si la presencia de una cabecera Set-Cookie en un mensaje de respuesta HTTP activa la adición de varias cabeceras relacionadas con la memoria caché. Si esta propiedad se establece en true, se añaden automáticamente una cabecera Expires con una fecha muy antigua y una cabecera Cache-Control que indica explícitamente al cliente que no ha de almacenar en la memoria caché la cabecera Set-Cookie. Estas cabeceras no se añaden automáticamente si la propiedad está establecida en false.

Esta propiedad es funcionalmente equivalente a la propiedad com.ibm.websphere.cookies.no.header disponible en versiones anteriores del producto.

Información Valor
Tipo de datos Booleano
Valor predeterminado True

DoNotAllowDuplicateSetCookies

Utilice la propiedad DoNotAllowDuplicateSetCookies para que el canal HTTP no envíe varias cabeceras Set-Cookie con el mismo nombre. El valor predeterminado es false.

Información Valor
Valor predeterminado False

EnableBuildBackupList

Utilice la propiedad EnableBuildBackupList para habilitar el canal HTTP para explorar en busca de los archivos históricos en el directorio de registros de acceso y errores y reiniciar estos archivos con los archivos de registros más nuevos que se creen.

Cuando esta propiedad se establece en true, el canal HTTP explora para ver si hay archivos históricos en el directorio de registros de acceso y errores y reinicia estos archivos con los archivos de registros más nuevos creados.

  • Después de haber configurado el registro de errores HTTP y el registro cronológico de acceso NCSA, asegúrese de que el campo Habilitar registro cronológico de acceso NCSA está seleccionado para los canales HTTP para los que desea que tenga lugar el registro cronológico. Para verificar que este campo se haya seleccionado para un canal HTTP, pulse Servidores > Tipos de servidor > Servidores de aplicaciones > servidor > Cadenas de transporte de contenedor web > Canal de entrada HTTP. Este valor debe habilitarse para que el establecimiento de esta propiedad personalizada en true afecte a la funcionalidad del canal HTTP.
  • Si utiliza esta propiedad personalizada, también debe asegurarse de que la opción Utilizar registro cronológico específico de cadena esté seleccionada como parte de sus valores de configuración para el Registro cronológico de accesos NCSA. De forma predeterminada, la opción Utilizar servicio de anotaciones globales se selecciona para las anotaciones de acceso NCSA.
Información Valor
Tipo de datos Booleano
Valor predeterminado False

HonorTransferEncoding

Utilice la propiedad HonorTransferEncoding para indicar si los canales de transporte HTTP deben convertir un mensaje fragmentado a un mensaje delimitado por la longitud de contenido cuando haya sólo un fragmento.

Cuando esta propiedad se establece en true, los canales de transporte HTTP graban los bloques en lugar de conmutar a un mensaje con longitud de contenido incluso si el mensaje sólo consta de un bloque. Hay un impacto de rendimiento en esta configuración porque los canales de transporte HTTP realizan dos grabaciones para cada mensaje de un solo bloque: la primera grabación es para el mensaje y la segunda es para el bloque de byte cero que marca el fin del mensaje

Cuando esta propiedad se establece en false, los canales de transporte HTTP convierten un mensaje fragmentado en un mensaje delimitado de longitud de contenido cuando hay un sólo fragmento. Este valor mejora el rendimiento de canal porque el canal sólo tiene una escritura para un mensaje de un solo bloque que se convierte en un mensaje con longitud de contenido.

Información Valor
Tipo de datos Booleano
Valor predeterminado False

limitFieldSize

Utilice la propiedad limitFieldSize para aplicar los límites de tamaño de diferentes campos HTTP como, por ejemplo, los URL de solicitud o los nombres o valores de las cabeceras individuales. Aplicar los límites de tamaño de estos campos impide posibles ataques de denegación de servicio. Se devuelve un error al cliente remoto si un campo supera el tamaño permitido.

Información Valor
Tipo de datos Entero
Valor predeterminado 32768
Rango 50-32768

limitNumHeaders

Utilice la propiedad limitNumHeaders para limitar el número de cabeceras HTTP que pueden estar presentes en un mensaje de entrada. Si se supera este límite, se devuelve un error al cliente.

Información Valor
Tipo de datos Entero
Valor predeterminado 500
Rango De 50 a 4000

localLogFilenamePrefix

Utilice la propiedad localLogFilenamePrefix para especificar un prefijo para el nombre de archivo del archivo de registro de red. Normalmente, cuando está habilitada la optimización en proceso, las solicitudes a través de la vía de acceso en proceso se registran basándose en los atributos de registro configurados para la cadena del canal de red del contenedor web. Puede utilizar esta propiedad para añadir un prefijo al nombre de archivo del archivo de registro de red. Este nuevo nombre de archivo se utiliza a continuación como el nombre de archivo del archivo de registro de las solicitudes en proceso. Las solicitudes enviadas mediante la vía de acceso de proceso se registran en este archivo en lugar del archivo de registro de red. Por ejemplo, si el archivo de registro de una cadena de transporte de red se denomina .../httpaccess.log y se establece esta propiedad en local para el canal HTTP en esa cadena, el nombre de archivo del archivo de registro de las solicitudes en proceso en el host asociado con dicha cadena es …/localhttpaccess.log.

Avoid trouble Avoid trouble: Si especifica un valor para la propiedad personalizada localLogFilenamePrefix, también debe establecer la propiedad personalizada del canal HTTP accessLogFileName al nombre plenamente calificado del archivo de anotaciones cronológicas que desea utilizar para las solicitudes de proceso de entrada. No puede especificar una variable como, por ejemplo, $(SERVER_LOG_ROOT), como el valor de esta propiedad personalizada.gotcha
Información Valor
Tipo de datos Serie

loggingDisable

Utilice esta propiedad personalizada para inhabilitar el registro de NCSA, FRCA y de errores en la cadena especificada.

Información Valor
Tipo de datos Booleano
Valor predeterminado False

QuoteAddedNoCacheValue

Utilice esta propiedad personalizada para añadir un atributo no-cache entre comillas a la cabecera de respuesta Cache-Control que no incluya el atributo.

El canal HTTP añadirá correctamente el atributo no-cache entre comillas a la cabecera. En el siguiente ejemplo, el atributo no-cache se añade a esta cabecera que se proporciona en la respuesta: Cache-Control: public, max-age=604800, no-cache="set-cookie".

Información Valor
Valor predeterminado False

RemoveCLHeaderInTempStatusRespRFC7230compat

Utilice la propiedad RemoveCLHeaderInTempStatusRespRFC7230compat para asegurarse de que el canal HTTP impida el envío de la cabecera Content-Length en los mensajes de respuesta con un estado de información 1xx o 204.

Información Valor
Valor predeterminado False

RemoveServerHeader

Utilice la propiedad RemoveServerHeader para forzar la supresión de cualquier cabecera de servidor de respuestas HTTP que el servidor de aplicaciones envía, ocultando, de este modo la identidad del programa del servidor.

Información Valor
Tipo de datos Booleano
Valor predeterminado False

ServerHeaderValue

Utilice la propiedad ServerHeaderValue para sustituir el valor predeterminado de la cabecera de servidor (Server) que el servidor añade a todas las respuestas HTTP de salida si aún no existe ninguna cabecera de servidor. El valor predeterminado para la cabecera de servidor es WebSphere Application Server v/x.x, donde x.x es la versión de WebSphere Application Server que se ejecuta en el sistema.

Antes de la versión 8.5.0.2, si aún no existe ninguna cabecera de servidor, el servidor añade la cabecera de servidor predeterminada o la cabecera que se especifique como valor de esta propiedad a todas las respuestas HTTP de salida.

A partir de la Versión 8.5.0.2, ya no se añade automáticamente una cabecera de servidor a todas las respuestas HTTP de salida si aún no existe ninguna cabecera de servidor. Si añade esta propiedad con un valor, dicho valor se añade la cabecera de servidor que aparece en la respuesta. Si especifica el valor DefaultServerValue, se utiliza WebSphere Application Server v/x.x como valor de cabecera de servidor.

Información Valor
Tipo de datos Serie

SustainedHighVolumeLogging

Utilice la propiedad SustainedHighVolumeLogging para permitir que el código de registro intente alcanzar el registro acumulado de entradas. Esta propiedad se establece en la consolada administrativa en Servidores de aplicaciones > Nombre de servidor > Cadenas de transporte de contenedor web > Nombre de cadena > Nombre de canal HTTP > Propiedades personalizadas.

UseCaseSensitiveKeyMatcher

UseCaseSensitiveKeyMatcher se va a utilizar conjuntamente con accessLogFormat.

El establecimiento de esta propiedad en true permitirá al buscador de coincidencias que se utiliza accessLogFormat distinguir entre mayúsculas y minúsculas. Esto soluciona el caso en el que existen directivas en mayúsculas y minúsculas (por ejemplo, %u y %U).

Información Valor
Valor predeterminado False

v0CookieDateRFC1123compat

Utilice la propiedad v0CookieDateRFC1123compat para indicar que el valor del atributo "V0 Set-Cookie header Expires" se ha especificado con un formato de año de cuatro dígitos en lugar de con un formato anual de dos dígitos.

De forma predeterminada, el valor del atributo "V0 Set-Cookie header Expires" se especifica con un formato de año de dos dígitos. Establezca la propiedad v0CookieDateRFC1123compat en true si necesita utilizar el RFC1123 anterior, que requiere un valor de formato de año de cuatro dígitos para el atributo "V0 Set-Cookie Expires".

Información Valor
Tipo de datos Booleano
Valor predeterminado False

WaitForEndOfMessage

Utilice esta propiedad personalizada para obligar al canal a esperar a que se lea el fin del mensaje antes de empezar a dar servicio a la respuesta.

Información Valor
Valor predeterminado False

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rrun_chain_httpcustom
File name: rrun_chain_httpcustom.html