Proprietà di configurazione per un endpoint HTTP.
Name | Type | Default | Description |
---|---|---|---|
id | stringa | Un ID di configurazione univoco. | |
onError |
| WARN | Azione 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. |
enabled | booleano | true | Attivare/disattivare la disponibilità di un endpoint. Quando questa opzione è impostata su true, questo endpoint verrà attivato dal dispatcher per gestire le richieste HTTP. |
host | string | localhost | L'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. |
httpPort | int Min: -1 Max: 65535 | La porta utilizzata per le richieste HTTP del client. Utilizzare -1 per disabilitare questa porta. | |
httpsPort | int Min: -1 Max: 65535 | La porta utilizzata per le richieste HTTP del client resa sicura con SSL (https). Utilizzare -1 per disabilitare questa porta. | |
httpOptionsRef | Un riferimento allelemento di livello più alto {0} (stringa). | defaultHttpOptions | Le opzioni del protocollo HTTP per l'endpoint. |
sslOptionsRef | Un riferimento allelemento di livello più alto {0} (stringa). | Le opzioni del protocollo SSL per l'endpoint. | |
tcpOptionsRef | Un riferimento allelemento di livello più alto {0} (stringa). | defaultTCPOptions | Le opzioni del protocollo TCP per l'endpoint. |
accessLoggingRef | Un riferimento allelemento di livello più alto {0} (stringa). | Configurazione della registrazione accessi HTTP per l'endpoint. |
Le opzioni del protocollo HTTP per l'endpoint.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | booleano | true | Abilita 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. |
maxKeepAliveRequests | int Min: -1 | 100 | Il numero massimo di richieste persistenti consentite su una singola connessione HTTP, se le connessioni persistenti sono abilitate. Un valore -1 indica un numero illimitato. |
persistTimeout | Un periodo di tempo con precisione al secondo | 30s | L'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. |
readTimeout | Un periodo di tempo con precisione al secondo | 60s | L'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. |
writeTimeout | Un periodo di tempo con precisione al secondo | 60s | L'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. |
removeServerHeader | booleano | false | Rimuove le informazioni di implementazione del server dalle intestazioni HTTP e disabilita anche la pagina di benvenuto del Liberty Profile predefinito. |
NoCacheCookiesControl | booleano | true | Permette 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. |
AutoDecompression | booleano | true | Specifica se il canale HTTP decomprime automaticamente i dati del corpo richiesta in entrata. |
Le opzioni del protocollo SSL per l'endpoint.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Un periodo di tempo con precisione al secondo | 1d | L'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. |
suppressHandshakeErrors | booleano | false | Disabilitare 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. |
sslRef | Un riferimento allelemento di livello più alto {0} (stringa). | Il repertorio di configurazione SSL predefinito. Il valore predefinito è defaultSSLSettings. | |
sslSessionTimeout | Un periodo di tempo con precisione al millisecondo | 8640ms | Il 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. |
Le opzioni del protocollo TCP per l'endpoint.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Un periodo di tempo con precisione al millisecondo | 60s | L'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. |
soReuseAddr | booleano | true | Abilita il rebind immediato a una porta senza un listener attivo. |
addressIncludeList | string | Un 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. | |
addressExcludeList | string | Un 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. | |
hostNameIncludeList | string | Un 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. | |
hostNameExcludeList | string | Un 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. |
Configurazione della registrazione accessi HTTP per l'endpoint.
Name | Type | Default | Description |
---|---|---|---|
enabled | booleano | true | Abilita la registrazione degli accessi. |
filePath | Percorso a un file | ${server.output.dir}/logs/http_access.log | Percorso 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}. |
logFormat | string | %h %u %{t}W "%r" %s %b | Specifica il formato del log che viene utilizzato durante la registrazione delle informazioni di accesso al client. |
maxFileSize | int Min: 0 | 20 | La dimensione massima di un file di log, in megabyte, prima che ne venga eseguito il rollover; un valore 0 indica nessun limite. |
maxFiles | int Min: 0 | 2 | Il numero massimo di file di log che verrà conservato prima che venga rimosso il file meno recente; un valore 0 indica nessun limite. |