httpEndpoint - Endpoint HTTP (httpEndpoint)

Proprietà di configurazione per un endpoint HTTP.

NameTypeDefaultDescription
idstringaUn ID di configurazione univoco.
onError
  • IGNORE
  • WARN
  • FAIL
WARNAzione da eseguire dopo un errore di avvio di un endpoint.
IGNORE
Il server non emetterà messaggi di avvertenza e di errore quando si verifica un errore di configurazione.
WARN
Il server emetterà messaggi di avvertenza e di errore quando si verifica un errore di configurazione.
FAIL
Il server emetterà un messaggio di avvertenza o di errore alla prima ricorrenza dell'errore, quindi si arresterà il server.
enabledbooleanotrueAttivare/disattivare la disponibilità di un endpoint. Quando questa opzione è impostata su true, questo endpoint verrà attivato dal dispatcher per gestire le richieste HTTP.
hoststringlocalhostL'indirizzo IP, il nome host DNS (domain name server) con il suffisso del nome del dominio, o solo il nome host DNS, utilizzato da un client per richiedere una risorsa. Utilizzare '*' per tutte le interfacce di rete disponibili.
httpPortint
Min: -1

Max: 65535
La porta utilizzata per le richieste HTTP del client. Utilizzare -1 per disabilitare questa porta.
httpsPortint
Min: -1

Max: 65535
La porta utilizzata per le richieste HTTP del client resa sicura con SSL (https). Utilizzare -1 per disabilitare questa porta.
httpOptionsRefUn riferimento allelemento di livello più alto {0} (stringa).defaultHttpOptionsLe opzioni del protocollo HTTP per l'endpoint.
sslOptionsRefUn riferimento allelemento di livello più alto {0} (stringa).Le opzioni del protocollo SSL per l'endpoint.
tcpOptionsRefUn riferimento allelemento di livello più alto {0} (stringa).defaultTCPOptionsLe opzioni del protocollo TCP per l'endpoint.
accessLoggingRefUn riferimento allelemento di livello più alto {0} (stringa).Configurazione della registrazione accessi HTTP per l'endpoint.

httpOptions

Le opzioni del protocollo HTTP per l'endpoint.

NameTypeDefaultDescription
keepAliveEnabledbooleanotrueAbilita le connessioni persistenti (keepalive HTTP). Se l'opzione è impostata su true, le connessioni vengono mantenute attive in modo da essere riutilizzate da più richieste e risposte in sequenza. Se l'opzione è impostata su false, le connessioni vengono chiuse una volta inviata la risposta.
maxKeepAliveRequestsint
Min: -1
100Il numero massimo di richieste persistenti consentite su una singola connessione HTTP, se le connessioni persistenti sono abilitate. Un valore -1 indica un numero illimitato.
persistTimeoutUn periodo di tempo con precisione al secondo30sL'intervallo di tempo durante il quale un socket può rimanere inattivo tra le richieste. Questa impostazione viene applicata solo se le connessioni persistenti sono abilitate. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
readTimeoutUn periodo di tempo con precisione al secondo60sL'intervallo di tempo di attesa del completamento di una richiesta di lettura su un socket dopo che si è verificata la prima lettura. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
writeTimeoutUn periodo di tempo con precisione al secondo60sL'intervallo di tempo di attesa su un socket per la trasmissione di ciascuna porzione dei dati della risposta. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
removeServerHeaderbooleanofalseRimuove le informazioni di implementazione del server dalle intestazioni HTTP e disabilita anche la pagina di benvenuto del Liberty Profile predefinito.
NoCacheCookiesControlbooleanotruePermette all'utente di controllare se la presenza di un'intestazione Set-Cookie deve o meno aggiornare l'intestazione Cache-Control con un valore no-cache corrispondente. Ciò aggiunge anche l'intestazione Scadenza.
AutoDecompressionbooleanotrueSpecifica se il canale HTTP decomprime automaticamente i dati del corpo richiesta in entrata.

sslOptions

Le opzioni del protocollo SSL per l'endpoint.

NameTypeDefaultDescription
sessionTimeoutUn periodo di tempo con precisione al secondo1dL'intervallo di tempo di attesa del completamento di una richiesta di lettura o scrittura su un socket. Questo valore viene sostituito dai timeout specifici del protocollo. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
suppressHandshakeErrorsbooleanofalseDisabilitare la registrazione degli errori di handshake SSL. Gli errori di handshake SSL possono verificarsi durante il normale funzionamento; tuttavia, questi messaggi possono essere utili in caso di funzionamento imprevisto di SSL.
sslRefUn riferimento allelemento di livello più alto {0} (stringa).Il repertorio di configurazione SSL predefinito. Il valore predefinito è defaultSSLSettings.
sslSessionTimeoutUn periodo di tempo con precisione al millisecondo8640msIl limite di timeout per una sessione SSL stabilito dal canale SSL. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.

tcpOptions

Le opzioni del protocollo TCP per l'endpoint.

NameTypeDefaultDescription
inactivityTimeoutUn periodo di tempo con precisione al millisecondo60sL'intervallo di tempo di attesa del completamento di una richiesta di lettura o scrittura su un socket. Questo valore viene sostituito dai timeout specifici del protocollo. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.
soReuseAddrbooleanotrueAbilita il rebind immediato a una porta senza un listener attivo.
addressIncludeListstringUn elenco separato da virgole di indirizzi a cui è consentito effettuare connessioni in entrata su questo endpoint. È possibile specificare gli indirizzi IPv4 o IPv6. Tutti i valori in un indirizzo IPv4 o IPv6 devono essere rappresentati da un numero o da un carattere jolly asterisco.
addressExcludeListstringUn elenco separato da virgole di indirizzi a cui non è consentito effettuare connessioni in entrata su questo endpoint. È possibile specificare gli indirizzi IPv4 o IPv6. Tutti i valori in un indirizzo IPv4 o IPv6 devono essere rappresentati da un numero o da un carattere jolly asterisco.
hostNameIncludeListstringUn elenco separato da virgole di nomi host a cui è consentito effettuare connessioni in entrata su questo endpoint. I nomi host non sono sensibili al maiuscolo/minuscolo e possono iniziare con un asterisco, che viene utilizzato come un carattere jolly. Tuttavia, l'asterisco non può trovarsi altrove nel nome host. Ad esempio, *.abc.com è valido, ma *.abc.* non è valido.
hostNameExcludeListstringUn elenco separato da virgole di nomi host a cui non è consentito effettuare connessioni in entrata su questo endpoint. I nomi host non sono sensibili al maiuscolo/minuscolo e possono iniziare con un asterisco, che viene utilizzato come un carattere jolly. Tuttavia, l'asterisco non può trovarsi altrove nel nome host. Ad esempio, *.abc.com è valido, ma *.abc.* non è valido.

accessLogging

Configurazione della registrazione accessi HTTP per l'endpoint.

NameTypeDefaultDescription
enabledbooleanotrueAbilita la registrazione degli accessi.
filePathPercorso a un file${server.output.dir}/logs/http_access.logPercorso di directory e nome del file di log di accesso. Quando si specifica il percorso di directory, è possibile utilizzare le sostituzioni della variabile standard, ad esempio ${server.output.dir}.
logFormatstring%h %u %{t}W "%r" %s %bSpecifica il formato del log che viene utilizzato durante la registrazione delle informazioni di accesso al client.
maxFileSizeint
Min: 0
20La dimensione massima di un file di log, in megabyte, prima che ne venga eseguito il rollover; un valore 0 indica nessun limite.
maxFilesint
Min: 0
2Il numero massimo di file di log che verrà conservato prima che venga rimosso il file meno recente; un valore 0 indica nessun limite.