TsgcHTTPServer Proprietà

Proprietà pubblicate raggruppate per scopo, seguite dall'elenco alfabetico completo.

Connessione

Nome	Descrizione
Active	Avvia o ferma il server HTTP, aprendo i socket in ascolto sui binding configurati.
Port	Porta TCP su cui il server accetta le connessioni HTTP in ingresso.
Bindings	Insieme di coppie IP/Porta su cui il server è in ascolto; utilizzarlo per associare più endpoint contemporaneamente.
MaxConnections	Numero massimo di connessioni client simultanee accettate dal server.
KeepAlive	Mantiene aperta la connessione HTTP dopo l'invio di una risposta, in modo che le richieste successive possano riutilizzarla.

HTTP

Nome	Descrizione
Charset	Charset applicato alle risposte testuali servite da DocumentRoot.
DocumentRoot	Directory servita dal server HTTP per i file statici (HTML, JavaScript, CSS, immagini, ecc.).
HTTP2Options	Abilita e regola il gestore del protocollo HTTP/2 utilizzato per gestire le richieste HTTPS.
HTTP3Options	Abilita il listener HTTP/3 (QUIC) che gestisce le richieste HTTP insieme a HTTP/1.1 e HTTP/2, tramite UDP.
HTTPCompression	Comprime le risposte HTTP/1.1 con gzip o deflate quando il client dichiara di supportarli.
HTTPUploadFiles	Controlla come i file caricati tramite HTTP POST vengono memorizzati nel buffer (memoria o file stream) e salvati su disco.
ParseParams	Analizza la query string e il corpo form-urlencoded di ogni richiesta in ARequestInfo.Params.

Sessioni

Nome	Descrizione
AutoStartSession	Crea automaticamente una nuova sessione HTTP per ogni richiesta in arrivo quando lo stato della sessione è abilitato.
SessionClass	Classe utilizzata dal server per creare nuove sessioni HTTP; impostarla su una propria discendente di TIdHTTPSession.
SessionList	Elenco che contiene le sessioni HTTP attive; leggerlo per gestire le sessioni via codice, oppure assegnare un proprio elenco.
SessionState	Abilita il tracciamento delle sessioni HTTP basato su cookie sopra il protocollo HTTP stateless.
SessionTimeOut	Timeout di inattività, in millisecondi, dopo il quale una sessione HTTP viene considerata scaduta e candidata alla rimozione.

Sicurezza

Nome	Descrizione
Authentication	Abilita e configura l'autenticazione utente/password per le connessioni HTTP in entrata.
SSL	Abilita TLS/SSL sul server in modo che i client possano connettersi utilizzando https://.
SSLOptions	Contiene i percorsi dei certificati, la selezione della versione TLS e le impostazioni di ottimizzazione di OpenSSL per il listener TLS.
SecurityOptions	Regole di ammissione dell'handshake ereditate dal motore server condiviso; non applicabili a questo componente (vedere Note).
MaxRequestBodySize	Dimensione massima in byte di un corpo di richiesta HTTP in ingresso; protegge il server dagli attacchi di esaurimento della memoria.
StrictRequestParsing	Rifiuta le richieste HTTP ambigue utilizzate negli attacchi di request smuggling e applica una convalida più rigorosa della codifica chunked.
APIKeyManager	Componente gestore di chiavi API opzionale utilizzato per convalidare le chiavi API in arrivo prima di accettare una connessione.

Affidabilità

Nome	Descrizione
WatchDog	Riavvia automaticamente il server dopo un arresto imprevisto o un errore del listener.
FallBack	Ereditata dal motore server condiviso; non applicabile a questo componente (vedere Note).
RateLimiter	Assegna un componente rate-limiter che limita la frequenza delle richieste per client o per IP.
Firewall	Assegna un componente firewall che filtra le connessioni in entrata per IP, regione o regole personalizzate.

Avanzate

Nome	Descrizione
Options	Raggruppa vari flag di comportamento del server: timeout, pagine di test integrate e l'intestazione HTTP Server.
IOHandlerOptions	Seleziona la strategia I/O utilizzata per servire le connessioni: un thread per connessione, IOCP o EPOLL.
ThreadPool	Abilita un pool di thread che ricicla i thread di lavoro invece di eliminarli alla chiusura delle connessioni.
ThreadPoolOptions	Configura la dimensione e il limite superiore del pool di thread riutilizzabili utilizzato quando ThreadPool è abilitato.
Throttle	Limita la larghezza di banda (bit al secondo) che il server legge da o scrive su ogni connessione.

Diagnostica

Nome	Descrizione
LogFile	Scrive ogni richiesta/risposta HTTP in entrata e in uscita su un file di log per il debug e l'auditing.
NotifyEvents	Controlla la modalità di sincronizzazione degli eventi del server su thread con il thread principale VCL.
Version	Stringa di sola lettura con la versione della libreria sgcWebSockets incorporata nel binario.

Tutte le proprietà (in ordine alfabetico)

Nome	Descrizione
Active	Avvia o ferma il server HTTP, aprendo i socket in ascolto sui binding configurati.
APIKeyManager	Componente gestore di chiavi API opzionale utilizzato per convalidare le chiavi API in arrivo prima di accettare una connessione.
Authentication	Abilita e configura l'autenticazione utente/password per le connessioni HTTP in entrata.
AutoStartSession	Crea automaticamente una nuova sessione HTTP per ogni richiesta in arrivo quando lo stato della sessione è abilitato.
Bindings	Insieme di coppie IP/Porta su cui il server è in ascolto; utilizzarlo per associare più endpoint contemporaneamente.
Charset	Charset applicato alle risposte testuali servite da DocumentRoot.
DocumentRoot	Directory servita dal server HTTP per i file statici (HTML, JavaScript, CSS, immagini, ecc.).
FallBack	Ereditata dal motore server condiviso; non applicabile a questo componente (vedere Note).
Firewall	Assegna un componente firewall che filtra le connessioni in entrata per IP, regione o regole personalizzate.
HTTP2Options	Abilita e regola il gestore del protocollo HTTP/2 utilizzato per gestire le richieste HTTPS.
HTTP3Options	Abilita il listener HTTP/3 (QUIC) che gestisce le richieste HTTP insieme a HTTP/1.1 e HTTP/2, tramite UDP.
HTTPCompression	Comprime le risposte HTTP/1.1 con gzip o deflate quando il client dichiara di supportarli.
HTTPUploadFiles	Controlla come i file caricati tramite HTTP POST vengono memorizzati nel buffer (memoria o file stream) e salvati su disco.
IOHandlerOptions	Seleziona la strategia I/O utilizzata per servire le connessioni: un thread per connessione, IOCP o EPOLL.
KeepAlive	Mantiene aperta la connessione HTTP dopo l'invio di una risposta, in modo che le richieste successive possano riutilizzarla.
LogFile	Scrive ogni richiesta/risposta HTTP in entrata e in uscita su un file di log per il debug e l'auditing.
MaxConnections	Numero massimo di connessioni client simultanee accettate dal server.
MaxRequestBodySize	Dimensione massima in byte di un corpo di richiesta HTTP in ingresso; protegge il server dagli attacchi di esaurimento della memoria.
NotifyEvents	Controlla la modalità di sincronizzazione degli eventi del server su thread con il thread principale VCL.
Options	Raggruppa vari flag di comportamento del server: timeout, pagine di test integrate e l'intestazione HTTP Server.
ParseParams	Analizza la query string e il corpo form-urlencoded di ogni richiesta in ARequestInfo.Params.
Port	Porta TCP su cui il server accetta le connessioni HTTP in ingresso.
RateLimiter	Assegna un componente rate-limiter che limita la frequenza delle richieste per client o per IP.
SecurityOptions	Regole di ammissione dell'handshake ereditate dal motore server condiviso; non applicabili a questo componente (vedere Note).
SessionClass	Classe utilizzata dal server per creare nuove sessioni HTTP; impostarla su una propria discendente di TIdHTTPSession.
SessionList	Elenco che contiene le sessioni HTTP attive; leggerlo per gestire le sessioni via codice, oppure assegnare un proprio elenco.
SessionState	Abilita il tracciamento delle sessioni HTTP basato su cookie sopra il protocollo HTTP stateless.
SessionTimeOut	Timeout di inattività, in millisecondi, dopo il quale una sessione HTTP viene considerata scaduta e candidata alla rimozione.
SSL	Abilita TLS/SSL sul server in modo che i client possano connettersi utilizzando https://.
SSLOptions	Contiene i percorsi dei certificati, la selezione della versione TLS e le impostazioni di ottimizzazione di OpenSSL per il listener TLS.
StrictRequestParsing	Rifiuta le richieste HTTP ambigue utilizzate negli attacchi di request smuggling e applica una convalida più rigorosa della codifica chunked.
ThreadPool	Abilita un pool di thread che ricicla i thread di lavoro invece di eliminarli alla chiusura delle connessioni.
ThreadPoolOptions	Configura la dimensione e il limite superiore del pool di thread riutilizzabili utilizzato quando ThreadPool è abilitato.
Throttle	Limita la larghezza di banda (bit al secondo) che il server legge da o scrive su ogni connessione.
Version	Stringa di sola lettura con la versione della libreria sgcWebSockets incorporata nel binario.
WatchDog	Riavvia automaticamente il server dopo un arresto imprevisto o un errore del listener.