TsgcWebSocketServer_HTTPAPI Proprietà

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

Connessione

Nome	Descrizione
Active	Avvia o arresta il listener HTTP.sys, registrando l'URL configurato con il driver del kernel di Windows.
Host	Hostname o indirizzo IP utilizzato per costruire l'URL registrato con il driver http.sys.
Port	Porta TCP che, insieme a `Host`, forma l'URL riservato dal driver http.sys per il server.
BindingOptions	Definisce con precisione come le prenotazioni URL e i certificati SSL vengono registrati con il driver http.sys all'avvio.
MaxConnections	Numero massimo di connessioni client simultanee accettate dal listener http.sys (zero significa illimitato).

Timeout

Nome	Descrizione
Timeouts	Sovrascrive i timeout predefiniti di http.sys per richiesta, corpo dell'entità, keep-alive e velocità di invio.

Sicurezza

Nome	Descrizione
Authentication	Abilita e configura l'autenticazione utente/password per le richieste WebSocket e HTTP in ingresso.
SSL	Abilita TLS/SSL sul listener http.sys in modo che i client possano connettersi utilizzando `wss://` o `https://`.
SSLOptions	Identifica la voce del Windows Certificate Store a cui http.sys associa il listener quando SSL è abilitato.
SecurityOptions	Definisce le regole di ammissione, come le origini consentite per gli handshake WebSocket del browser.
APIKeyManager	Componente gestore di chiavi API opzionale utilizzato per convalidare le chiavi API in arrivo prima di accettare una connessione.

Affidabilità

Nome	Descrizione
HeartBeat	Invia frame ping periodici per mantenere attive le connessioni WebSocket inattive e rilevare i peer non raggiungibili.
WatchDog	Riavvia automaticamente il server dopo un arresto imprevisto o un errore del listener.
Firewall	Assegna un componente firewall che filtra le connessioni in entrata per IP, regione o regole personalizzate.
RateLimiter	Assegna un componente rate-limiter che limita la frequenza delle richieste e dei messaggi per client o per IP.

Prestazioni

Nome	Descrizione
Asynchronous	Abilita gli invii fire-and-forget: il chiamante ritorna immediatamente e il completamento viene segnalato tramite l'evento `OnAsynchronous`.
MaxBandwidth	Larghezza di banda massima consentita in byte al secondo su tutte le connessioni (zero significa illimitato).
ThreadPoolSize	Numero di thread worker che servono la coda di richieste http.sys tramite IOCP.
ReadBufferSize	Dimensione in byte del buffer di ricezione allocato per ogni lettura overlapped in sospeso sulla coda delle richieste http.sys.
FineTune	Parametri a livello kernel che definiscono come http.sys mette in coda, distribuisce e completa le richieste.

HTTP

Nome	Descrizione
HTTPUploadFiles	Controlla come i file caricati tramite HTTP POST vengono memorizzati nel buffer (memoria o file stream) e salvati su disco.

Avanzate

Nome	Descrizione
Options	Raggruppa vari flag di comportamento del server: gestione dei frammenti, timeout di scrittura, pagine di test HTTP e validazione UTF-8.
QueueOptions	Serializza i messaggi in uscita tramite una coda interna per connessione per prevenire la contesa tra thread.
Extensions	Configura le estensioni del protocollo WebSocket, come la compressione per messaggio deflate.
Specifications	Abilita o disabilita le specifiche del protocollo WebSocket che il server accetterà.

Diagnostica

Nome	Descrizione
LogFile	Scrive ogni messaggio socket in entrata e in uscita su un file di log per il debug e l'auditing.
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 arresta il listener HTTP.sys, registrando l'URL configurato con il driver del kernel di Windows.
APIKeyManager	Componente gestore di chiavi API opzionale utilizzato per convalidare le chiavi API in arrivo prima di accettare una connessione.
Asynchronous	Abilita gli invii fire-and-forget: il chiamante ritorna immediatamente e il completamento viene segnalato tramite l'evento `OnAsynchronous`.
Authentication	Abilita e configura l'autenticazione utente/password per le richieste WebSocket e HTTP in ingresso.
BindingOptions	Definisce con precisione come le prenotazioni URL e i certificati SSL vengono registrati con il driver http.sys all'avvio.
Extensions	Configura le estensioni del protocollo WebSocket, come la compressione per messaggio deflate.
FineTune	Parametri a livello kernel che definiscono come http.sys mette in coda, distribuisce e completa le richieste.
Firewall	Assegna un componente firewall che filtra le connessioni in entrata per IP, regione o regole personalizzate.
HeartBeat	Invia frame ping periodici per mantenere attive le connessioni WebSocket inattive e rilevare i peer non raggiungibili.
Host	Hostname o indirizzo IP utilizzato per costruire l'URL registrato con il driver http.sys.
HTTPUploadFiles	Controlla come i file caricati tramite HTTP POST vengono memorizzati nel buffer (memoria o file stream) e salvati su disco.
LogFile	Scrive ogni messaggio socket in entrata e in uscita su un file di log per il debug e l'auditing.
MaxBandwidth	Larghezza di banda massima consentita in byte al secondo su tutte le connessioni (zero significa illimitato).
MaxConnections	Numero massimo di connessioni client simultanee accettate dal listener http.sys (zero significa illimitato).
Options	Raggruppa vari flag di comportamento del server: gestione dei frammenti, timeout di scrittura, pagine di test HTTP e validazione UTF-8.
Port	Porta TCP che, insieme a `Host`, forma l'URL riservato dal driver http.sys per il server.
QueueOptions	Serializza i messaggi in uscita tramite una coda interna per connessione per prevenire la contesa tra thread.
RateLimiter	Assegna un componente rate-limiter che limita la frequenza delle richieste e dei messaggi per client o per IP.
ReadBufferSize	Dimensione in byte del buffer di ricezione allocato per ogni lettura overlapped in sospeso sulla coda delle richieste http.sys.
SecurityOptions	Definisce le regole di ammissione, come le origini consentite per gli handshake WebSocket del browser.
Specifications	Abilita o disabilita le specifiche del protocollo WebSocket che il server accetterà.
SSL	Abilita TLS/SSL sul listener http.sys in modo che i client possano connettersi utilizzando `wss://` o `https://`.
SSLOptions	Identifica la voce del Windows Certificate Store a cui http.sys associa il listener quando SSL è abilitato.
ThreadPoolSize	Numero di thread worker che servono la coda di richieste http.sys tramite IOCP.
Timeouts	Sovrascrive i timeout predefiniti di http.sys per richiesta, corpo dell'entità, keep-alive e velocità di invio.
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.