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.

- 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- No console administrativo, clique em
- . Em Configurações dos contêineres de web, clique em chain_name .
- . Em Configurações do Servidor Proxy HTTP, clique em . Em seguida, selecione ou e clique em .
e selecione uma das opções a seguir, dependendo do tipo de cadeia sendo criada: - 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.
- Clique em Aplicar ou OK.
- Clique em Salvar para salvar suas alterações na configuração.
- Inicie novamente o servidor.
- accessLogFormat
- CookiesConfigureNoCache
- DoNotAllowDuplicateSetCookies
- EnableBuildBackupList
- HonorTransferEncoding
- limitFieldSize
- limitNumHeaders
- localLogFilenamePrefix
- loggingDisable
- QuoteAddedNoCacheValue
- RemoveCLHeaderInTempStatusRespRFC7230compat
- RemoveServerHeader
- ServerHeaderValue
- UseCaseSensitiveKeyMatcher
- v0CookieDateRFC1123compat
- WaitForEndOfMessage
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
- 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
- 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

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.

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