Propriedades Personalizadas do Canal de Transporte HTTP

Se você estiver utilizando um canal de transporte HTTP, poderá incluir qualquer uma das seguintes propriedades customizadas nas definições de configuração para esse canal.

Evitar Problemas Evitar Problemas: Existem quatro cadeias de transporte do contêiner de Web:
  • WCInboundAdmin
  • WCInboundAdminSecure
  • WCInboundDefault
  • WCInboundDefaultSecure

Um servidor de aplicativos ou um servidor proxy herda os valores da propriedade customizada que são especificados para a cadeia de transporte WCInboundAdmin ou WCInboundAdminSecure porque uma destas cadeias geralmente é a primeira cadeia a ser ativada quando o servidor de aplicativos é inicializado. Portanto, antes de especificar quaisquer propriedades customizadas para uma cadeia de transporte do contêiner de Web, você deve desativar as cadeias de transporte WCInboundAdmin e WCInboundAdminSecure.

gotcha
Para incluir uma propriedade customizada:
  1. No console administrativo, clique em Servidores > Tipos de Servidor e selecione uma das opções a seguir, dependendo do tipo de cadeia sendo criada:
    • Servidores de aplicativos > > server_name. Em Configurações dos contêineres de web, clique em Cadeias de transporte de contêineres de web > chain_name > Cadeia de entrada HTTP > Propriedades customizadas > Nova.
    • Servidores Proxy WebSphere > server_name. Em Configurações do Servidor Proxy HTTP, clique em Transportes de Servidor Proxy. Em seguida, selecione HTTPS_PROXY_CHAIN ou HTTP_PROXY_CHAIN e clique em > Cadeia de entrada HTTP > Propriedades customizadas > Nova.
  2. Em General Properties especifique o nome da propriedade customizada no campo Nome e um valor para essa propriedade no campo Valor. Você também pode especificar uma descrição dessa propriedade no campo Descrição.
  3. Clique em Aplicar ou OK.
  4. Clique em Salvar para salvar suas alterações na configuração.
  5. Inicie novamente o servidor.
Seguem as descrições das propriedades customizadas do canal de transporte HTTP fornecidas com o produto. Essas propriedades não são mostradas na página de configurações para um canal de transporte HTTP. É possível utilizar a página de propriedades customizadas para definir as seguintes propriedades:

accessLogFormat

Use a propriedade accessLogFormat para especificar as informações que deseja incluir no log de acesso NCSA para um canal de transporte HTTP e como deseja que essas informações sejam formatadas. O valor para essa propriedade é uma lista de opções delimitada por espaço. A ordem especificada para as opções determina o formato dessas informações no log.

Cada opção pode ser encerrada entre aspas, mas as aspas não são necessárias. A menos que seja indicado de outra forma, um valor de - é impresso para uma opção se as informações solicitadas não puderem ser obtidas para essa opção.

A lista a seguir indica as opções disponíveis e as informações impressas, se essa opção estiver especificada como parte do valor especificado para essa propriedade.
%a
Endereço IP remoto
%A
Endereço IP local
%b
Tamanho da resposta em bytes, excluindo cabeçalhos
%B
Tamanho da resposta em bytes, excluindo cabeçalhos

0 é impresso em vez de - se nenhum valor for localizado.

%{CookieName}C ou %C
O cookie da solicitação especificado em colchetes ou, se os colchetes não forem incluídos, imprime todos os cookies de solicitação.
%D
O tempo decorrido da solicitação - com precisão de milissegundos, precisão de microssegundos
%h
Host remoto
%i ou %{HeaderName}i
O valor de cabeçalho HeaderName da solicitação
%m
Método de solicitação
%o ou %{HeaderName}o
O valor de cabeçalho HeaderName da resposta
%q
Saída da sequência de consultas com uma senha declarada
%r
Primeira linha da solicitação
%s
Código de status da resposta
%t
Formato NCSA do horário de início da solicitação
%(t)W
O horário atual quando a mensagem ao log de acesso é colocada em fila para ser registrada no formato NCSA normal
%u
Usuário remoto de acordo com o cabeçalho $WSRU específico do WebSphere Application Server
%U
Caminho do URL, não incluindo a sequência de consultas
%{X}W
ID de contexto Cross Component Tracing (XCT)

Por exemplo, é possível especificar as diretivas a seguir como valor para essa propriedade:

 %h %i %u %t "%r" %s %b
Com base nesta configuração, o log de acesso NCSA incluirá as informações a seguir para cada solicitação na ordem especificada:
  • O host remoto
  • O valor de cabeçalho HeaderName da solicitação
  • O usuário remoto de acordo com o cabeçalho $WSRU específico do WebSphere
  • O formato NCSA do horário de início da solicitação
  • A primeira linha da solicitação
  • O código de status da resposta
  • O tamanho da resposta em bytes, excluindo cabeçalhos
Evitar Problemas Evitar Problemas: Se você usar esta propriedade customizada, assegure-se de que a opção Usar criação de log específico de cadeia esteja selecionada como parte das suas definições de configuração para criação de log de acesso NCSA. Por padrão, a opção Usar serviço de criação de log global será selecionada para criação de log de acesso NCSA.gotcha

CookiesConfigureNoCache

Utilize a propriedade CookiesConfigureNoCache para especificar se a presença de um cabeçalho Set-Cookie em uma mensagem de resposta HTTP aciona a inclusão de vários cabeçalhos relacionados a cache. Se essa propriedade for configurada como true, serão incluídos automaticamente um cabeçalho Expires com uma data muito antiga e um cabeçalho Cache-Control que instrui explicitamente o cliente a não armazenar em cache o cabeçalho Set-Cookie. Esses cabeçalhos não serão incluídos automaticamente se essa propriedade for configurada como false.

Esta propriedade é funcionalmente equivalente à propriedade com.ibm.websphere.cookies.no.header que estava disponível nas versões anteriores do produto.

Informações Valor
Tipo de D]ados Booleano
Padrão Verdadeiro

DoNotAllowDuplicateSetCookies

Use a propriedade DoNotAllowDuplicateSetCookies para evitar que o canal HTTP envie vários cabeçalhos Set-Cookie com o mesmo nome. O valor padrão é false

Informações Valor
Padrão False

EnableBuildBackupList

Use a propriedade EnableBuildBackupList para permitir o canal HTTP varrer por arquivos históricos no diretório de logs de acesso e de erro, e realizar rollover com quaisquer arquivos de log mais novos criados.

Quando esta propriedade é configurada como true, o Canal HTTP varre pelos arquivos históricos no diretório de logs de acesso e de erro, e realiza rollover desses arquivos com quaisquer arquivos de log mais novos criados.

  • Após configurar o log de erro HTTP e o log de acesso NCSA, certifique-se de que o campo Ativar criação de log de acesso NCSA esteja selecionado para os canais HTTP nos quais deseja que ocorra a criação de log. Para verificar se este campo está selecionado para um canal HTTP, clique em Servidores > Tipos de Servidor > Servidores de Aplicativoss > server > Cadeias de Transporte de Contêiner de Web > Canal de Entrada HTTP. Esta configuração precisa ser ativada antes da configuração desta propriedade customizada como true ter qualquer efeito na funcionalidade do canal HTTP.
  • Se você usar esta propriedade customizada, também deverá assegurar que a opção Usar Criação de Log Específica da Cadeia esteja selecionada como parte de suas definições de configuração para criação de log de acesso NCSA. Por padrão, a opção Utilizar Serviço de Criação de Log Global é selecionada para criação de log de acesso NCSA.
Informações Valor
Tipo de D]ados Booleano
Padrão False

HonorTransferEncoding

Use a propriedade HonorTransferEncoding para indicar se os canais de transportes HTTP devem converter uma mensagem em partes em uma mensagem delimitada pelo comprimento de conteúdo quando houver apenas uma parte.

Quando esta propriedade estiver configurada como true, os canais de transporte HTTP gravam as partes em vez de alternar para uma mensagem de tamanho do conteúdo mesmo se a mensagem consistir apenas em uma parte. Existe um impacto no desempenho desta configuração porque os canais de transportes HTTP fazem duas gravações para cada mensagem em parte única: a primeira gravação destina-se à mensagem e a segunda gravação destina-se à parte de byte zero que marca o final da mensagem

Quando esta propriedade estiver configurada como false, os canais de transporte HTTP convertem uma mensagem em partes em uma mensagem delimitada pelo tamanho do conteúdo quando há apenas uma parte. Essa configuração melhora o desempenho do canal porque ele faz apenas uma gravação para uma mensagem em parte única que é convertida em uma mensagem por comprimento do conteúdo.

Informações Valor
Tipo de D]ados Booleano
Padrão False

limitFieldSize

Utilize a propriedade limitFieldSize para impor limites de tamanho sobre os vários campos HTTP, como URLs de pedido, ou nomes ou valores individuais de cabeçalho. A imposição de limites de tamanho desses campos protege contra possíveis ataques de Negação de Serviço. Um erro será retornado ao cliente remoto se um campo exceder o tamanho permitido.

Informações Valor
Tipo de D]ados Integer
Padrão 32768
Range 50-32768

limitNumHeaders

Utilize a propriedade limitNumHeaders para limitar o número de cabeçalhos HTTP que podem estar presentes em uma mensagem que chega. Se esse limite for excedido, um erro será retornado ao cliente.

Informações Valor
Tipo de D]ados Integer
Padrão 500
Range 50 a 4000

localLogFilenamePrefix

Utilize a propriedade localLogFilenamePrefix para especificar um prefixo para o nome do arquivo de log de rede. Normalmente, quando a otimização em processo está ativada, as solicitações por meio do caminho em processo são registradas com base nos atributos configurados para a cadeia de canais de rede do contêiner da Web. Você pode utilizar essa propriedade para incluir um prefixo no nome do arquivo referente ao arquivo de log da rede. Esse novo nome de arquivo é então utilizado como o nome para o arquivo de log para pedidos em processo. Os pedidos enviados através do caminho em processo são registrados nesse arquivo em vez de no arquivo de log da rede. Por exemplo, se o arquivo de log para uma cadeia de transporte de rede for denominado .../httpaccess.log e esta propriedade for configurada como local para o canal HTTP nessa cadeia, o nome do arquivo de log para solicitações em processo para o host associado a essa cadeia será …/localhttpaccess.log.

Evitar Problemas Evitar Problemas: Se você especificar um valor para a propriedade customizada localLogFilenamePrefix, deverá também definir a propriedade customizada de canal HTTP accessLogFileName com o nome completo do arquivo de log que você deseja utilizar nos pedidos de processo. Você não pode especificar uma variável, por exemplo, $(SERVER_LOG_ROOT), como o valor para essa propriedade customizada.gotcha
Informações Valor
Tipo de D]ados Sequência de caracteres

loggingDisable

Utilize essa propriedade customizada para desativar NCSA, FRCA, e a criação de log de erros na cadeia especificada.

Informações Valor
Tipo de D]ados Booleano
Padrão False

QuoteAddedNoCacheValue

Use essa propriedade customizada para incluir um atributo no-cache entre aspas em um cabeçalho de resposta Cache-Control que ainda não contém o atributo.

O canal HTTP incluirá corretamente o atributo no-cache entre aspas no cabeçalho. No exemplo a seguir, o atributo no-cache é incluído nesse cabeçalho que é fornecido na resposta: Cache-Control: public, max-age=604800, no-cache="set-cookie".

Informações Valor
Padrão False

RemoveCLHeaderInTempStatusRespRFC7230compat

Use a propriedade RemoveCLHeaderInTempStatusRespRFC7230compat para assegurar que o canal HTTP impeça o envio do cabeçalho Content-Length em mensagens de resposta com um status de informações de 1xx ou 204.

Informações Valor
Padrão False

RemoveServerHeader

Utilize a propriedade RemoveServerHeader para forçar a remoção de todo cabeçalho do servidor das respostas HTTP que o servidor de aplicativos envia, ocultando assim a identidade do programa do servidor.

Informações Valor
Tipo de D]ados Booleano
Padrão False

ServerHeaderValue

Utilize a propriedade ServerHeaderValue para substituir o valor padrão do cabeçalho do Servidor que é incluído para todas as respostas HTTP de saída por servidor se um cabeçalho do Servidor ainda não existir. O valor padrão para o cabeçalho do Servidor é WebSphere Application Server v/x.x em que x.x é a versão do WebSphere Application Server que está executando em seu sistema.

Antes da Versão 8.5.0.2, se um cabeçalho de Servidor já não existir, o cabeçalho padrão do Servidor, ou o cabeçalho que você especificar como o valor dessa propriedade, era incluído para todas as respostas HTTP pelo servidor.

Iniciando com a Versão 8.5.0.2, um cabeçalho do Servidor não é mais incluído automaticamente para todas as respostas HTTP de saída se um cabeçalho de Servidor ainda não existir. Se você incluir essa propriedade com um valor, esse valor será incluído no cabeçalho do Servidor que aparece na resposta. Se você especificar o valor DefaultServerValue, o WebSphere Application Server v/x.x será utilizado como o valor do cabeçalho do Servidor.

Informações Valor
Tipo de D]ados Sequência de caracteres

SustainedHighVolumeLogging

Use a propriedade SustainedHighVolumeLogging para permitir que o código de log tente capturar a lista não processada de entradas. Essa propriedade é configurada no console Admin Servidores de aplicativos > Nome do servidor > Cadeias de transporte de contêineres de web > Nome da cadeia > Nome do canal HTTP > Propriedades customizadas.

UseCaseSensitiveKeyMatcher

UseCaseSensitiveKeyMatcher deve ser usado em conjunto com accessLogFormat.

A configuração dessa propriedade como true permitirá que o Key Matcher usado em accessLogFormat faça distinção entre maiúsculas e minúsculas. Isso trata o caso em que existem diretivas em letras minúsculas e maiúsculas (por exemplo, %u e %U).

Informações Valor
Padrão False

v0CookieDateRFC1123compat

Use a propriedade v0CookieDateRFC1123compat para indicar que o valor para o atributo Expires do cabeçalho V0 Set-Cookie é especificado no formato de ano de quatro dígitos em vez de no formato de ano de dois dígitos.

Por padrão, o valor para o atributo Expires do cabeçalho V0 Set-Cookie é especificado no formato de ano de dois dígitos. Configure a propriedade v0CookieDateRFC1123compat como true se precisar usar o RFC1123 mais antigo, que requer um valor de formato de ano de quatro dígitos para o atributo V0 Set-Cookie Expires.

Informações Valor
Tipo de D]ados Booleano
Padrão False

WaitForEndOfMessage

Use essa propriedade customizada para forçar o canal a esperar o final da leitura das mensagens antes de começar a atender à resposta.

Informações Valor
Padrão False

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rrun_chain_httpcustom
Nome do arquivo: rrun_chain_httpcustom.html