virtualHost - Host Virtual (virtualHost)

Um host virtual fornece um agrupamento lógico para configurar aplicativos da web para um determinado nome de host. O host virtual padrão (default_host) é adequado para a maioria das configurações simples.

NameTypeDefaultDescription
idsequênciaUm ID de configuração exclusivo.
enabledbooleanotrueAtivar este host virtual.
allowFromEndpointRefLista de referências para os elementos httpEndpoint de nível superior (sequência separada por vírgula).Especifique o identificador de um ou mais terminais HTTP para restringir o tráfego de entrada para este host virtual aos terminais especificados.

hostAlias

Associe um host e uma porta a este host virtual usando a sintaxe host:port. O host especificado pode ser um endereço IP, nome do host do servidor de nomes de domínio (DNS) com um sufixo de nome de domínio, nome do host do DNS ou * para uma correspondência de curinga em todos os nomes de host. Observe que os endereços IPv6 devem ser colocados entre [].

allowFromEndpoint

Especifique o identificador de um ou mais terminais HTTP para restringir o tráfego de entrada para este host virtual aos terminais especificados.

NameTypeDefaultDescription
idsequênciaUm ID de configuração exclusivo.
onError
  • IGNORE
  • WARN
  • FAIL
WARNAção a ser tomada após uma falha para iniciar um terminal.
IGNORE
O servidor não emitirá mensagens de aviso e de erro quando incorrer em um erro de configuração.
WARN
O servidor emitirá mensagens de aviso e de erro quando incorrer em um erro de configuração.
FAIL
O servidor emitirá uma mensagem de aviso ou de erro na primeira ocorrência de erro e, em seguida, irá parar o servidor.
enabledbooleanotrueAlternar a disponibilidade de um terminal. Quando true, este terminal será ativado pelo dispatcher para manipular solicitações de HTTP.
hoststringlocalhostEndereço IP, nome do host do servidor de nomes de domínio (DNS) com sufixo de nome de domínio ou apenas o nome do host DNS, usado por um cliente para solicitar um recurso. Use '*' para todas as interfaces de rede disponíveis.
httpPortint
Min: -1

Max: 65535
A porta usada para solicitações de HTTP do cliente. Use -1 para desativar esta porta.
httpsPortint
Min: -1

Max: 65535
A porta usada para solicitações de HTTP do cliente protegidas com SSL (https). Use -1 para desativar esta porta.
httpOptionsRefUma referência para o elemento de nível httpOptions (sequência).defaultHttpOptionsOpções do protocolo HTTP para o terminal.
sslOptionsRefUma referência para o elemento de nível sslOptions (sequência).Opções do protocolo SSL para o terminal.
tcpOptionsRefUma referência para o elemento de nível tcpOptions (sequência).defaultTCPOptionsOpções do protocolo TCP para o terminal.
accessLoggingRefUma referência para o elemento de nível httpAccessLogging (sequência).Configuração de criação de log de acesso para o terminal.

allowFromEndpoint > httpOptions

Opções do protocolo HTTP para o terminal.

NameTypeDefaultDescription
keepAliveEnabledbooleanotrueAtiva as conexões persistentes (keep-alive de HTTP). Se true, as conexões são mantidas ativas para reutilização por diversas solicitações e respostas sequenciais. Se false, as conexões são encerradas após a resposta ser enviada.
maxKeepAliveRequestsint
Min: -1
100Número máximo de solicitações persistentes que são permitidas em uma única conexão HTTP se conexões persistentes estão ativadas. Um valor igual a -1 significa ilimitado.
persistTimeoutUm período de tempo com precisão de segundo30sQuantidade de tempo que um soquete terá permissão para permanecer inativo entre solicitações. Esta configuração se aplica apenas se conexões persistentes são ativadas. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
readTimeoutUm período de tempo com precisão de segundo60sQuantidade de tempo a esperar pela conclusão de uma solicitação de leitura em um soquete após a primeira leitura ocorrer. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
writeTimeoutUm período de tempo com precisão de segundo60sQuantidade de tempo a esperar em um soquete para cada parte dos dados de resposta serem transmitidos. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
removeServerHeaderbooleanofalseRemove informações de implementação do servidor de cabeçalhos de HTTP e também desativa a página de boas-vindas do perfil padrão do Liberty.
NoCacheCookiesControlbooleanotruePermite que o usuário controle se a presença de um cabeçalho Set-Cookie deve ou não atualizar o cabeçalho Cache-Control com um valor que não é de cache correspondente. Esse valor também inclui o cabeçalho Expires.
AutoDecompressionbooleanotrueEspecifica se o Canal HTTP automaticamente descompacta dados do corpo da solicitação de entrada.

allowFromEndpoint > sslOptions

Opções do protocolo SSL para o terminal.

NameTypeDefaultDescription
sessionTimeoutUm período de tempo com precisão de segundo1dQuantidade de tempo a aguardar pela conclusão de uma solicitação de leitura ou gravação em um soquete. Este valor é substituído pelos tempos limites específicos do protocolo. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
suppressHandshakeErrorsbooleanofalseDesative a criação de log de erros de handshake SSL. Os erros de handshake SSL podem ocorrer durante operação normal; no entanto, essas mensagens podem ser úteis quando o SSL está se comportando inesperadamente.
sslRefUma referência para o elemento de nível ssl (sequência).O repertório de configuração de SSL padrão. O valor padrão é defaultSSLSettings.
sslSessionTimeoutUm período de tempo com precisão de milissegundo8640msO limite do tempo limite para uma sessão SSL que é estabelecida pelo canal SSL. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m), segundos (s) ou milissegundos (ms). Por exemplo, especifique 500 milissegundos como 500 ms. É possível incluir diversos valores em uma única entrada. Por exemplo, 1s500ms é equivalente a 1,5 segundos.

allowFromEndpoint > tcpOptions

Opções do protocolo TCP para o terminal.

NameTypeDefaultDescription
inactivityTimeoutUm período de tempo com precisão de milissegundo60sQuantidade de tempo a aguardar pela conclusão de uma solicitação de leitura ou gravação em um soquete. Este valor é substituído pelos tempos limites específicos do protocolo. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m), segundos (s) ou milissegundos (ms). Por exemplo, especifique 500 milissegundos como 500 ms. É possível incluir diversos valores em uma única entrada. Por exemplo, 1s500ms é equivalente a 1,5 segundos.
soReuseAddrbooleanotrueAtiva a religação imediata para uma porta sem listener ativo.
addressIncludeListstringUma lista separada por vírgula de endereços que têm permissão para fazer conexões de entrada nesse endpoint. É possível especificar endereços IPv4 ou IPv6. Todos os valores em um endereço IPv4 ou IPv6 devem ser representados por um número ou por um caractere curinga de asterisco.
addressExcludeListstringUma lista separada por vírgula de endereços que não têm permissão para fazer conexões de entrada nesse endpoint. É possível especificar endereços IPv4 ou IPv6. Todos os valores em um endereço IPv4 ou IPv6 devem ser representados por um número ou por um caractere curinga de asterisco.
hostNameIncludeListstringUma lista separada por vírgula de nomes de host que têm permissão para fazer conexões de entrada nesse endpoint. Os nomes do host não tem distinção entre maiúsculas e minúsculas e podem começar com um asterisco, que é usado como um caractere curinga. No entanto, os asteriscos não podem estar em outro lugar no nome do host. Por exemplo, *.abc.com é válido, mas *.abc.* não é válido.
hostNameExcludeListstringUma lista separada por vírgula de nomes de host que não têm permissão para fazer conexões de entrada nesse endpoint. Os nomes do host não tem distinção entre maiúsculas e minúsculas e podem começar com um asterisco, que é usado como um caractere curinga. No entanto, os asteriscos não podem estar em outro lugar no nome do host. Por exemplo, *.abc.com é válido, mas *.abc.* não é válido.

allowFromEndpoint > accessLogging

Configuração de criação de log de acesso para o terminal.

NameTypeDefaultDescription
enabledbooleanotrueAtivar log de acesso..
filePathCaminho para um arquivo${server.output.dir}/logs/http_access.logCaminho do diretório e nome do arquivo de log de acesso. As substituições de variável padrão, como ${server.output.dir}, podem ser usadas ao especificar o caminho do diretório.
logFormatstring%h %u %{t}W "%r" %s %bEspecifica o formato de log que é usado ao registrar informações de acesso de cliente no log.
maxFileSizeint
Min: 0
20Tamanho máximo de um arquivo de log, em megabytes, antes de ser substituído; um valor igual a 0 significa sem limite.
maxFilesint
Min: 0
2Número máximo de arquivos de log que serão mantidos, antes que o arquivo mais antigo seja removido; um valor igual a 0 significa sem limite.