TsgcWebSocketServer_HTTPAPI › Eigenschaften

TsgcWebSocketServer_HTTPAPI Eigenschaften

Veröffentlichte Eigenschaften, nach Zweck gruppiert, gefolgt von der vollständigen alphabetischen Liste.

Verbindung

NameBeschreibung
ActiveStartet oder stoppt den HTTP.sys-Listener und registriert die konfigurierte URL beim Windows-Kerneltreiber.
HostHostname oder IP-Adresse, die verwendet wird, um die beim http.sys-Treiber registrierte URL zu erstellen.
PortTCP-Port, der zusammen mit Host die URL bildet, die der http.sys-Treiber für den Server reserviert.
BindingOptionsStellt fein ein, wie URL-Reservierungen und SSL-Zertifikate beim Start beim http.sys-Treiber registriert werden.
MaxConnectionsMaximale Anzahl gleichzeitiger Client-Verbindungen, die vom http.sys-Listener akzeptiert werden (null bedeutet unbegrenzt).

Timeouts

NameBeschreibung
TimeoutsÜberschreibt die standardmäßigen http.sys-Timeouts für Anfrage, Entity-Body, Keep-Alive und Sendrate.

Sicherheit

NameBeschreibung
AuthenticationAktiviert und konfiguriert die Benutzer-/Passwort-Authentifizierung für eingehende WebSocket- und HTTP-Anfragen.
SSLAktiviert TLS/SSL auf dem http.sys-Listener, sodass Clients sich über wss:// oder https:// verbinden können.
SSLOptionsIdentifiziert den Windows-Zertifikatspeichereintrag, den http.sys an den Listener bindet, wenn SSL aktiviert ist.
SecurityOptionsDefiniert Zulassungsregeln wie erlaubte Origins für Browser-WebSocket-Handshakes.
APIKeyManagerOptionale API-Schlüssel-Manager-Komponente, die verwendet wird, um eingehende API-Schlüssel zu validieren, bevor eine Verbindung akzeptiert wird.

Zuverlässigkeit

NameBeschreibung
HeartBeatSendet periodische Ping-Frames, um inaktive WebSocket-Verbindungen am Leben zu halten und tote Peers zu erkennen.
WatchDogStartet den Server nach einem unerwarteten Herunterfahren oder einem Listener-Fehler automatisch neu.
FirewallWeist eine Firewall-Komponente zu, die eingehende Verbindungen nach IP, Region oder benutzerdefinierten Regeln filtert.
RateLimiterWeist eine Rate-Limiter-Komponente zu, die die Anfrage- und Nachrichtenraten pro Client oder pro IP begrenzt.

Leistung

NameBeschreibung
AsynchronousErmöglicht Fire-and-Forget-Sendevorgänge: Der Aufrufer kehrt sofort zurück, und der Abschluss wird über das OnAsynchronous-Ereignis signalisiert.
MaxBandwidthMaximal zulässige Bandbreite in Bytes pro Sekunde über alle Verbindungen hinweg (null bedeutet unbegrenzt).
ThreadPoolSizeAnzahl der Worker-Threads, die die http.sys-Request-Queue über IOCP bedienen.
ReadBufferSizeGröße in Bytes des Empfangspuffers, der pro ausstehendem überlapptem Read gegen die http.sys-Request-Queue zugewiesen wird.
FineTuneLow-Level-Kernel-Mode-Stellschrauben, die festlegen, wie http.sys Anfragen in eine Queue stellt, verteilt und abschließt.

HTTP

NameBeschreibung
HTTPUploadFilesSteuert, wie über HTTP POST hochgeladene Dateien gepuffert werden (Speicher- oder Datei-Stream) und auf der Festplatte gespeichert werden.

Erweitert

NameBeschreibung
OptionsBündelt verschiedene Server-Verhaltens-Flags: Fragmentbehandlung, Schreib-Timeouts, HTTP-Testseiten und UTF-8-Validierung.
QueueOptionsSerialisiert ausgehende Nachrichten über eine interne Warteschlange pro Verbindung, um Konkurrenz zwischen Threads zu vermeiden.
ExtensionsKonfiguriert WebSocket-Protokollerweiterungen wie Per-Message-Deflate-Komprimierung.
SpecificationsAktiviert oder deaktiviert die WebSocket-Protokollspezifikationen, die der Server akzeptieren wird.

Diagnose

NameBeschreibung
LogFileSchreibt jede eingehende und ausgehende Socket-Nachricht zu Debugging- und Auditing-Zwecken in eine Protokolldatei.
VersionSchreibgeschützte Zeichenkette mit der in der Binärdatei eingebetteten Version der sgcWebSockets-Bibliothek.

Alle Eigenschaften (alphabetisch)

NameBeschreibung
ActiveStartet oder stoppt den HTTP.sys-Listener und registriert die konfigurierte URL beim Windows-Kerneltreiber.
APIKeyManagerOptionale API-Schlüssel-Manager-Komponente, die verwendet wird, um eingehende API-Schlüssel zu validieren, bevor eine Verbindung akzeptiert wird.
AsynchronousErmöglicht Fire-and-Forget-Sendevorgänge: Der Aufrufer kehrt sofort zurück, und der Abschluss wird über das OnAsynchronous-Ereignis signalisiert.
AuthenticationAktiviert und konfiguriert die Benutzer-/Passwort-Authentifizierung für eingehende WebSocket- und HTTP-Anfragen.
BindingOptionsStellt fein ein, wie URL-Reservierungen und SSL-Zertifikate beim Start beim http.sys-Treiber registriert werden.
ExtensionsKonfiguriert WebSocket-Protokollerweiterungen wie Per-Message-Deflate-Komprimierung.
FineTuneLow-Level-Kernel-Mode-Stellschrauben, die festlegen, wie http.sys Anfragen in eine Queue stellt, verteilt und abschließt.
FirewallWeist eine Firewall-Komponente zu, die eingehende Verbindungen nach IP, Region oder benutzerdefinierten Regeln filtert.
HeartBeatSendet periodische Ping-Frames, um inaktive WebSocket-Verbindungen am Leben zu halten und tote Peers zu erkennen.
HostHostname oder IP-Adresse, die verwendet wird, um die beim http.sys-Treiber registrierte URL zu erstellen.
HTTPUploadFilesSteuert, wie über HTTP POST hochgeladene Dateien gepuffert werden (Speicher- oder Datei-Stream) und auf der Festplatte gespeichert werden.
LogFileSchreibt jede eingehende und ausgehende Socket-Nachricht zu Debugging- und Auditing-Zwecken in eine Protokolldatei.
MaxBandwidthMaximal zulässige Bandbreite in Bytes pro Sekunde über alle Verbindungen hinweg (null bedeutet unbegrenzt).
MaxConnectionsMaximale Anzahl gleichzeitiger Client-Verbindungen, die vom http.sys-Listener akzeptiert werden (null bedeutet unbegrenzt).
OptionsBündelt verschiedene Server-Verhaltens-Flags: Fragmentbehandlung, Schreib-Timeouts, HTTP-Testseiten und UTF-8-Validierung.
PortTCP-Port, der zusammen mit Host die URL bildet, die der http.sys-Treiber für den Server reserviert.
QueueOptionsSerialisiert ausgehende Nachrichten über eine interne Warteschlange pro Verbindung, um Konkurrenz zwischen Threads zu vermeiden.
RateLimiterWeist eine Rate-Limiter-Komponente zu, die die Anfrage- und Nachrichtenraten pro Client oder pro IP begrenzt.
ReadBufferSizeGröße in Bytes des Empfangspuffers, der pro ausstehendem überlapptem Read gegen die http.sys-Request-Queue zugewiesen wird.
SecurityOptionsDefiniert Zulassungsregeln wie erlaubte Origins für Browser-WebSocket-Handshakes.
SpecificationsAktiviert oder deaktiviert die WebSocket-Protokollspezifikationen, die der Server akzeptieren wird.
SSLAktiviert TLS/SSL auf dem http.sys-Listener, sodass Clients sich über wss:// oder https:// verbinden können.
SSLOptionsIdentifiziert den Windows-Zertifikatspeichereintrag, den http.sys an den Listener bindet, wenn SSL aktiviert ist.
ThreadPoolSizeAnzahl der Worker-Threads, die die http.sys-Request-Queue über IOCP bedienen.
TimeoutsÜberschreibt die standardmäßigen http.sys-Timeouts für Anfrage, Entity-Body, Keep-Alive und Sendrate.
VersionSchreibgeschützte Zeichenkette mit der in der Binärdatei eingebetteten Version der sgcWebSockets-Bibliothek.
WatchDogStartet den Server nach einem unerwarteten Herunterfahren oder einem Listener-Fehler automatisch neu.