Host virtual (virtualHost)

allowFromEndpointRef

Lista de referencias a elementos httpEndpoint de nivel superior (serie separada por comas).

Especifique el identificador de uno o más puntos finales HTTP para restringir el tráfico de entrada de este host virtual a los puntos finales especificados.

enabled

boolean

true

Habilita este host virtual.

hostAlias

string

Asocie un host y puerto con este host virtual, utilizando la sintaxis host:puerto. El host especificado puede ser una dirección IP, un nombre de host de servidor de nombres de dominio (DNS) con un sufijo de nombre de dominio, el nombre de host DNS, o * como comodín de coincidencia para todos los nombres de host. Tenga en cuenta que las direcciones IPv6 deben ir entre [].

id

string

Un ID de configuración exclusivo.

accessLoggingRef

Una referencia a un elemento httpAccessLogging de nivel superior (string).

Configuración de registro de acceso HTTP para el punto final.

compressionRef

Una referencia a un elemento compression de nivel superior (string).

defaultCompression

Opciones de compresión para el punto final.

enabled

boolean

true

Conmuta la disponibilidad de un punto final. Si tiene el valor true, el asignador activará este punto final para manejar las solicitudes HTTP.

headersRef

Una referencia a un elemento headers de nivel superior (string).

defaultHeaders

Opciones de cabecera para el punto final.

host

string

localhost

Dirección IP, servidor de nombres de dominio (DNS), nombre de host con sufijo de nombre de dominio o sólo el nombre de host DNS utilizados por un cliente para solicitar un recurso. Utilice '*' para todas las interfaces de red disponibles.

httpOptionsRef

Una referencia a un elemento httpOptions de nivel superior (string).

defaultHttpOptions

Opciones del protocolo HTTP para el punto final.

httpPort

int
Mín: -1
Máx: 65535

Puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto.

httpsPort

int
Mín: -1
Máx: 65535

Puerto utilizado para las solicitudes HTTP de cliente con SSL (https). Utilice -1 para inhabilitar este puerto.

id

string

Un ID de configuración exclusivo.

onError

WARN

Acción a realizar después de una anomalía para iniciar un punto final.
FAIL
El servidor emitirá un mensaje de aviso o error con el primer error y después se detendrá el servidor.
IGNORE
El servidor no emitirá mensajes de aviso y error cuando se produzca un error de configuración.
WARN
El servidor emitirá mensajes de aviso y error cuando se produzca un error de configuración.

protocolVersion

string

Cuando una API de Servlet 4.0 está habilitada como característica, establezca este atributo en http/1.1 para inhabilitar el proceso de HTTP/2 para los puertos que se han definido para el elemento httpEndpoint. Cuando la API de Servlet 3.1 está habilitada como una característica, establezca este atributo en http/2 para habilitar el proceso de HTTP/2 para los puertos que están definidos para el elemento httpEndpoint.

remoteIpRef

Una referencia a un elemento remoteIp de nivel superior (string).

defaultRemoteIp

Opciones IP remotas para el punto final.

samesiteRef

Una referencia a un elemento samesite de nivel superior (string).

defaultSameSite

Opciones de SameSite para el punto final.

sslOptionsRef

Una referencia a un elemento sslOptions de nivel superior (string).

Opciones del protocolo SSL para el punto final.

tcpOptionsRef

Una referencia a un elemento tcpOptions de nivel superior (string).

defaultTCPOptions

Opciones del protocolo TCP para el punto final.

enabled

boolean

true

Permite el registro de acceso cuando se define el elemento de configuración accessLogging. Nota: Se debe configurar el registro de acceso para que este atributo entre en vigor.

filePath

Vía de acceso a un archivo

${server.output.dir}/logs/http_access.log

Vía de acceso y nombre de directorio del archivo de registro de acceso. Las sustituciones de variables estándar, como ${server.output.dir}, se pueden utilizar al especificar la vía de acceso del directorio.

logFormat

string

%h %u %{t}W "%r" %s %b

Especifica el formato de registro que se utiliza al registrar la información de acceso del cliente.

maxFileSize

int
Mín: 0

20

Tamaño máximo de un archivo de registro, en megabytes, antes de que se retrotraiga; un valor 0 significa que no hay ningún límite.

maxFiles

int
Mín: 0

2

Número máximo que se mantendrá de archivos de registro, antes de que se elimine el archivo más antiguo; un valor 0 significa que no hay ningún límite.

rolloverInterval

Un período de tiempo con precisión de minutos

-1

El intervalo de tiempo entre los reinicios del registro, en minutos si no se especifica una unidad de tiempo. Especifique un entero positivo seguido de una unidad de tiempo, que puede ser días (d), horas (h), o minutos (m). Por ejemplo, especifique 5 horas como 5h. Puede incluir varios valores en una sola entrada. Por ejemplo, 1d5h equivale a 1 día y 5 horas. Si se especifica rolloverStartTime, el valor predeterminado de rolloverInterval es 1 día. Si no se especifican tanto rolloverInterval como rolloverStartTime, el reinicio del registro basado en tiempo está inhabilitado. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h) o minutos (m). Por ejemplo, especifique 30 minutos como 30m. Puede incluir varios valores en una sola entrada. Por ejemplo, 1h30m es equivalente a 90 minutos.

rolloverStartTime

string

La hora planificada del día para que los registros se reinicien por primera vez. La duración del intervalo de reinicio comienza a la hora de inicio del reinicio. Los valores válidos siguen un formato de fecha y hora ISO-8601 de 24 horas de HH:MM, donde 00:00 representa la medianoche. Se necesitan ceros de relleno. Si se especifica rolloverInterval, el valor predeterminado de rolloverStartTime es 00:00, medianoche. Si no se especifican tanto rolloverInterval como rolloverStartTime, el reinicio del registro basado en tiempo está inhabilitado.

serverPreferredAlgorithm

string

none

El algoritmo de compresión configurado se utiliza para comprimir el cuerpo de respuestas cuando se especifica con un valor de calidad no cero en la cabecera Accept-Encoding de la solicitud. Los algoritmos de compresión válidos incluyen: deflate, gzip, x-gzip, zlib e identity.

types

string
Esto se especifica como un elemento hijo en lugar de como un atributo XML (máximo de apariciones 5000).

text/*

Para incluir un tipo de contenido además de los valores predeterminados, fije el carácter de adición (+) como prefijo para dicho tipo de contenido. Para excluir un tipo de contenido para compresión, fije el carácter de eliminación (-) como prefijo para dicho tipo de contenido. Nota: El carácter comodín (*) sólo se soporta como subtipo de contenido, por ejemplo text/*.

add

string

Especifica los nombres y valores de cabecera que se añaden a cada respuesta HTTP. Los valores de cabecera se incluyen opcionalmente utilizando un delimitador de dos puntos (:). Cualquier nombre de cabecera definido utilizando este atributo no debe estar vacío ni debe aparecer en las configuraciones de cabecera 'remove', 'set' o 'setIfMissing'.

remove

string

Especifica los nombres de cabecera que se eliminan de cada respuesta HTTP. Cualquier nombre de cabecera definido utilizando este atributo no debe estar vacío. No se esperan valores de cabecera. Cualquier nombre de cabecera definido utilizando este atributo no debe aparecer en las configuraciones de cabecera 'add', 'set' o 'setIfMissing'.

set

string

Especifica los nombres y valores de cabecera que se establecen a cada respuesta HTTP. Los valores de cabecera se incluyen opcionalmente utilizando un delimitador de dos puntos (:). Cualquier nombre de cabecera definido utilizando este atributo no debe estar vacío, no debe estar definido más de una vez ni debe aparecer en las configuraciones de cabecera 'remove', 'add' o 'setIfEmpty'. Si la cabecera ya aparece en la respuesta, los valores existentes se sobrescriben son esta configuración.

setIfMissing

string

Especifica los nombres y valores de cabecera que se establecen a cada respuesta HTTP si no están ya presentes. Los valores de cabecera se incluyen opcionalmente utilizando un delimitador de dos puntos (:). Cualquier nombre de cabecera definido utilizando este atributo no debe estar vacío, no debe estar definido más de una vez ni debe aparecer en las configuraciones de cabecera 'remove', 'add' o 'set'.

AutoDecompression

boolean

true

Especifica si el canal HTTP descomprime automáticamente los datos del cuerpo de solicitud entrantes.

DoNotAllowDuplicateSetCookies

string

false

Impide que el canal HTTP envíe varias cabeceras Set-Cookie con el mismo nombre.

MessageSizeLimit

long

-1

Limita el tamaño aceptable de un mensaje entrante. Si el mensaje llega con un tamaño mayor que este valor, se devuelve un mensaje al cliente remoto.

NoCacheCookiesControl

boolean

true

Permite al usuario controlar cuando se debe modificar la presencia de una cabecera Set-Cookie con un valor de no-cache coincidente. También se añade la cabecera Expires.

ThrowIOEForInboundConnections

boolean

Especifica si el canal HTTP crea una excepción de E/S cuando se cierra una conexión de entrada mientras el servlet todavía la está utilizando. El valor predeterminado se establece en función de la característica de servlet configurada. Antes de Servlet 4.0, el valor predeterminado es false; a partir de Servlet 4.0, el valor predeterminado es true.

connectionWindowSize

int
Mín: 65535
Máx: 2147483647

65535

Especifica el tamaño de ventana en octetos para el control de flujo de nivel de conexión HTTP/2. Este valor se puede configurar en cualquier tamaño dentro del rango de 65.535 a 2.147.483.647 octetos, ambos incluidos. Si no se especifica ningún valor, el valor predeterminado es de 65.535 octetos.

decompressionRatioLimit

int
Mín: 1

200

Especifica la proporción máxima de carga útil de cuerpo de solicitud descomprimido a comprimido. El canal HTTP lee el cuerpo de solicitud y verifica la proporción a medida que el cuerpo se descomprime. El canal detiene la descompresión del cuerpo de solicitud si la proporción de descompresión permanece por encima del valor configurado y se alcanza la tolerancia de descompresión.

decompressionTolerance

int
Mín: 0

3

Especifica el número máximo de veces que el canal HTTP tolera una proporción de descompresión por encima de la proporción configurada, indicada por el atributo decompressionRatioLimit de httpOption. Si se alcanza este número y el siguiente ciclo de descompresión aún contiene una proporción de descompresión por encima del límite de proporción, el canal HTTP deja de descomprimir el cuerpo de solicitud.

http2ConnectionIdleTimeout

Un período de tiempo con precisión de segundos

0

Especifica la cantidad de tiempo, en segundos, que se permitirá que una conexión HTTP/2 permanezca inactiva entre operaciones de E/S de socket. Si no se especifica, o se establece en un valor de 0, no hay ningún tiempo de espera de conexión establecido. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

incomingBodyBufferSize

int
Mín: 1024
Máx: 1048576

32768

Especifica el tamaño de cada almacenamiento intermedio utilizado al leer el cuerpo de un mensaje HTTP entrante.

keepAliveEnabled

boolean

true

Habilita las conexiones persistentes (estado activo HTTP). Si tienen el valor true, las conexiones se mantendrán activas para ser reutilizadas por varias solicitudes y respuestas secuenciales. Si tienen el valor false, las conexiones se cierran después de enviarse la respuesta.

limitFieldSize

int
Mín: 50
Máx: 2147483647

32768

Impone los límites de tamaño en diversos campos HTTP, como los URL de solicitud o nombres o valores de 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 excede el tamaño permitido.

limitNumHeaders

int
Mín: 50
Máx: 500

500

Limita el número de cabeceras HTTP que pueden existir en un mensaje entrante. Si se supera este límite, se devuelve un error al cliente remoto.

limitWindowUpdateFrames

boolean

false

Especifica si el servidor espera hasta agotar la mitad de las ventanas de nivel de conexión HTTP/2 y de nivel de secuencia antes de enviar tramas WINDOW_UPDATE. Los valores válidos son true o false. Si no se especifica ningún valor, el valor predeterminado es false.

maxConcurrentStreams

int

100

Especifica el número máximo de corrientes que una conexión HTTP/2 puede tener activas en cualquier punto determinado. La apertura de corrientes por encima del límite producirá un REFUSED_STREAM (0x7). Si no se especifica, el valor predeterminado de corrientes simultáneas se establecerá en 200.

maxFrameSize

int
Mín: 16384
Máx: 16777215

57344

Especifica el tamaño máximo permitido de una carga útil de trama que el servidor anunciará en el trama de valores SETTINGS_MAX_FRAME_SIZE HTTP/2. Esto se puede configurar en cualquier tamaño dentro del rango de 16.384 a 16.777.215 bytes, inclusive. Si no se especifica, el valor predeterminado se establece en 57.344 bytes.

maxHeaderBlockSize

long
Mín: 0

512000

Especifica el tamaño máximo en bytes para el bloque de cabecera de corrientes HTTP2 individuales. Si se supera este valor, la conexión se cierra con un error. Establezca este parámetro en 0 para inhabilitar la comprobación.

maxKeepAliveRequests

int
Mín: -1

-1

Número máximo de solicitudes persistentes que se permiten en una única conexión HTTP si están habilitadas las conexiones persistentes. El valor -1 indica ilimitado. Esta opción admite aplicaciones de alto rendimiento o baja latencia y conexiones SSL para utilizarlas en situaciones donde la creación de una nueva conexión puede ser muy costosa.

maxResetFrames

int
Mín: 0

100

Especifica el número máximo de marcos de restablecimiento por conexión que se permiten durante la ventana de marco de restablecimiento. Si se supera este valor, se cierra la conexión. Establezca este parámetro en 0 para inhabilitar la comprobación.

maxStreamsRefused

int
Mín: 0

100

Especifica el número máximo de corrientes que se rechazan después de que se alcance el límite máximo de corrientes simultáneas. Si se supera este valor, se cierra la conexión. Establezca este parámetro en 0 para inhabilitar la comprobación.

persistTimeout

Un período de tiempo con precisión de segundos

30s

Cantidad de tiempo que un socket puede permanecer desocupado entre solicitudes. Este valor sólo se aplica si están habilitadas las conexiones persistentes. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

readTimeout

Un período de tiempo con precisión de segundos

60s

Cantidad de tiempo que se debe esperar en un socket hasta que se complete una solicitud de lectura después de la primera lectura. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

removeServerHeader

boolean

false

Elimina información de implementación del servidor de las cabeceras HTTP.

resetFramesWindow

Un período de tiempo con precisión de milisegundos

30s

Especifica la ventana de tiempo durante la cual se cuentan los marcos de restablecimiento en cada conexión. Establezca este parámetro en 0 para una ventana de tiempo ilimitada. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m), segundos (s) o milisegundos (ms). Por ejemplo, especifique 500 milisegundos como 500ms. Puede incluir varios valores en una sola entrada. Por ejemplo, 1s500ms es equivalente a 1,5 segundos.

settingsInitialWindowSize

int
Mín: 1
Máx: 2147483647

65535

Especifica el tamaño de ventana inicial en octetos para el control de flujo de nivel de secuencia HTTP/2. Este valor se puede configurar en cualquier tamaño dentro del rango de 1 a 2.147.483.647 octetos, ambos inclusive. Si no se especifica ningún valor, el valor predeterminado es de 65.535 octetos.

writeTimeout

Un período de tiempo con precisión de segundos

60s

Cantidad de tiempo que se debe esperar en un socket hasta que se transmita cada parte de los datos de respuesta. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

proxies

string

10\.\d{1,3}\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3}|169\.254\.\d{1,3}\.\d{1,3}|127\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.1[6-9]{1}\.\d{1,3}\.\d{1,3}|172\.2[0-9]{1}\.\d{1,3}\.\d{1,3}|172\.3[0-1]{1}\.\d{1,3}\.\d{1,3}|0:0:0:0:0:0:0:1|::1

Expresión regular que define proxies de confianza.

useRemoteIpInAccessLog

boolean

false

Si esta propiedad se establece en true y el canal HTTP verificó la información del cliente remoto, el registro de acceso NCSA refleja las cabeceras Rewarded o X-Forwarded-*. Estas cabeceras se reflejan cuando se registra uno o más de los elementos siguientes: la IP del cliente remoto, el host o el protocolo de solicitud.

lax

string

Lista de nombres de cookie o patrones para los que el atributo de SameSite se ha establecido en un valor de Lax, si aún no se ha definido. Se soporta un carácter comodín único (*) como valor autónomo o a continuación de los prefijos de nombre de cookie. Cualquier nombre de cookie o patrón definido por esta lista debe ser exclusivo y no debe estar presente en las configuraciones 'none' ni 'strict'.

none

string

Lista de nombres de cookie o patrones para los que el atributo de SameSite se ha establecido en un valor de None, si aún no se ha definido. Se soporta un carácter comodín único (*) como valor autónomo o a continuación de los prefijos de nombre de cookie. Cualquier nombre de cookie o patrón definido por esta lista debe ser exclusivo y no debe estar presente en las configuraciones 'lax' ni 'strict'. Cada cookie modificado para contener un valor de SameSite de None como resultado de esta configuración también está establecido en Secure.

strict

string

Lista de nombres de cookie o patrones para los que el atributo de SameSite se ha establecido en un valor de Strict, si aún no se ha definido. Se soporta un carácter comodín único (*) como valor autónomo o a continuación de los prefijos de nombre de cookie. Cualquier nombre de cookie o patrón definido por esta lista debe ser exclusivo y no debe estar presente en las configuraciones 'lax' ni 'none'.

sessionTimeout

Un período de tiempo con precisión de segundos

1d

Cantidad de tiempo que se debe esperar a que una solicitud de lectura o escritura se complete en un socket. Este valor se sustituye por tiempos de espera específicos de protocolo. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

sslRef

Una referencia a un elemento ssl de nivel superior (string).

El repertorio de configuración SSL por omisión. El valor predeterminado es defaultSSLConfig.

sslSessionTimeout

Un período de tiempo con precisión de milisegundos

86400s

El límite de tiempo de espera de una sesión SSL establecida por el canal SSL. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m), segundos (s) o milisegundos (ms). Por ejemplo, especifique 500 milisegundos como 500ms. Puede incluir varios valores en una sola entrada. Por ejemplo, 1s500ms es equivalente a 1,5 segundos.

suppressHandshakeErrors

boolean

false

Inhabilita el registro de errores de reconocimiento de comunicación SSL. Los errores de reconocimiento de comunicación SSL se pueden producir durante el funcionamiento normal, pero estos mensajes pueden resultar de utilidad si SSL no se comporta de forma esperada. Si está inhabilitado, los registros de mensajes y de consola no registran errores de reconocimiento de comunicación y el registro de rastreo registra los errores de reconocimiento de comunicación cuando el rastreo del canal SSL está activo.

acceptThread

boolean

false

Si el valor true, los puertos de escucha no comparten la misma hebra para aceptar conexiones. Si no lo es, comparten la misma hebra.

addressExcludeList

string

Lista de direcciones separadas por comas que no están autorizadas para realizar conexiones de entrada en este punto final. Puede especificar direcciones IPv4 o IPv6. Todos los valores de una dirección IPv4 o IPv6 deben estar representados por un número o por un carácter comodín de tipo asterisco. Estos son algunos ejemplos de direcciones IPv4 válidas para esta lista: "*.1.255.0", "254.*.*.9", y "1.*.*.*", y estas son algunas direcciones IPv6 válidas: "0:*:*:0:007F:0:0001:0001", "F:FF:FFF:FFFF:1:01:001:0001" y "1234:*:4321:*:9F9f:*:*:0000".

addressIncludeList

string

Lista de direcciones separadas por comas que están autorizadas para realizar conexiones de entrada en este punto final. Puede especificar direcciones IPv4 o IPv6. Todos los valores de una dirección IPv4 o IPv6 deben estar representados por un número o por un carácter comodín de tipo asterisco. Estos son algunos ejemplos de direcciones IPv4 válidas para esta lista: "*.1.255.0", "254.*.*.9", y "1.*.*.*", y estas son algunas direcciones IPv6 válidas: "0:*:*:0:007F:0:0001:0001", "F:FF:FFF:FFFF:1:01:001:0001" y "1234:*:4321:*:9F9f:*:*:0000".

hostNameExcludeList

string

Lista de nombres de host separados por comas que no están autorizados para realizar conexiones de entrada en este punto final. Los nombres de host no distinguen entre mayúsculas y minúsculas y pueden empezar por un asterisco, que se utiliza como carácter comodín. Pero, no puede haber asteriscos en ninguna otra posición en el nombre de host. Por ejemplo, *.abc.com es válido, pero *.abc.* no es válido.

hostNameIncludeList

string

Lista de nombres de host separados por comas que están autorizados para realizar conexiones de entrada en este punto final. Los nombres de host no distinguen entre mayúsculas y minúsculas y pueden empezar por un asterisco, que se utiliza como carácter comodín. Pero, no puede haber asteriscos en ninguna otra posición en el nombre de host. Por ejemplo, *.abc.com es válido, pero *.abc.* no es válido.

inactivityTimeout

Un período de tiempo con precisión de milisegundos

60s

Cantidad de tiempo que se debe esperar a que una solicitud de lectura o escritura se complete en un socket. Este valor se sustituye por tiempos de espera específicos de protocolo. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m), segundos (s) o milisegundos (ms). Por ejemplo, especifique 500 milisegundos como 500ms. Puede incluir varios valores en una sola entrada. Por ejemplo, 1s500ms es equivalente a 1,5 segundos.

maxOpenConnections

int

128000

Define el número máximo de conexiones que pueden abrirse en este punto final.

portOpenRetries

int
Mín: 0
Máx: 100000

0

Número de reintentos para abrir un puerto TCP/IP durante el inicio de servidor. Habrá un retardo de un segundo entre reintentos, hasta que la apertura se realice satisfactoriamente o se alcance el número de reintentos de apertura de puerto.

soReuseAddr

boolean

true

Permite reenlazar de inmediato con un puerto sin un escucha activo.

waitToAccept

boolean

false

Consulta si este canal TCP retrasará la aceptación de conexiones hasta que se reinicie el servidor. Si tiene el valor false, las conexiones se cierran hasta que se reinicie el servidor. Si el valor es true, el valor de acceptThread tcpOption también se establece en true, y las conexiones se retrasan hasta que se reinicie el servidor.