httpEndpoint - Punto final HTTP (httpEndpoint)

Propiedades de configuración para un punto final HTTP.

NameTypeDefaultDescription
idstringUn ID de configuración exclusivo.
onError
  • IGNORE
  • WARN
  • FAIL
WARNAcción a realizar después de una anomalía para iniciar un punto final.
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.
FAIL
El servidor emitirá un mensaje de aviso o error con el primer error y después se detendrá el servidor.
enabledbooleantrueConmuta la disponibilidad de un punto final. Si tiene el valor true, el asignador activará este punto final para manejar las solicitudes HTTP.
hoststringlocalhostDirecció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.
httpPortint
Min: -1

Max: 65535
Puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto.
httpsPortint
Min: -1

Max: 65535
Puerto utilizado para las solicitudes HTTP de cliente con SSL (https). Utilice -1 para inhabilitar este puerto.
httpOptionsRefUna referencia a un elemento httpOptions de nivel superior (string).defaultHttpOptionsOpciones del protocolo HTTP para el punto final.
sslOptionsRefUna referencia a un elemento sslOptions de nivel superior (string).Opciones del protocolo SSL para el punto final.
tcpOptionsRefUna referencia a un elemento tcpOptions de nivel superior (string).defaultTCPOptionsOpciones del protocolo TCP para el punto final.
accessLoggingRefUna referencia a un elemento httpAccessLogging de nivel superior (string).Configuración de registro de acceso HTTP para el punto final.

httpOptions

Opciones del protocolo HTTP para el punto final.

NameTypeDefaultDescription
keepAliveEnabledbooleantrueHabilita 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.
maxKeepAliveRequestsint
Min: -1
100Nú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.
persistTimeoutUn período de tiempo con precisión de segundos30sCantidad 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.
readTimeoutUn período de tiempo con precisión de segundos60sCantidad 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.
writeTimeoutUn período de tiempo con precisión de segundos60sCantidad 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.
removeServerHeaderbooleanfalseElimina la información de implementación del servidor de las cabeceras HTTP y también inhabilita la página de bienvenida por omisión del perfil de Liberty.
NoCacheCookiesControlbooleantruePermite 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.
AutoDecompressionbooleantrueEspecifica si el canal HTTP descomprime automáticamente los datos del cuerpo de solicitud entrantes.

sslOptions

Opciones del protocolo SSL para el punto final.

NameTypeDefaultDescription
sessionTimeoutUn período de tiempo con precisión de segundos1dCantidad 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.
suppressHandshakeErrorsbooleanfalseInhabilita 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.
sslRefUna referencia a un elemento ssl de nivel superior (string).El repertorio de configuración SSL por omisión. El valor por omisión es defaultSSLSettings.
sslSessionTimeoutUn período de tiempo con precisión de milisegundos8640msEl 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.

tcpOptions

Opciones del protocolo TCP para el punto final.

NameTypeDefaultDescription
inactivityTimeoutUn período de tiempo con precisión de milisegundos60sCantidad 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.
soReuseAddrbooleantruePermite reenlazar de inmediato con un puerto sin un escucha activo.
addressIncludeListstringLista 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.
addressExcludeListstringLista 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.
hostNameIncludeListstringLista 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.
hostNameExcludeListstringLista 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.

accessLogging

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

NameTypeDefaultDescription
enabledbooleantrueHabilitar el registro de acceso.
filePathVía de acceso a un archivo${server.output.dir}/logs/http_access.logVí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.
logFormatstring%h %u %{t}W "%r" %s %bEspecifica el formato de registro que se utiliza al registrar la información de acceso del cliente.
maxFileSizeint
Min: 0
20Tamañ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.
maxFilesint
Min: 0
2Nú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.