TsgcWebSocketHTTPServer › Properties

TsgcWebSocketHTTPServer Properties

Published properties grouped by purpose, followed by the full alphabetical list.

Connection

NameDescription
ActiveStarts or stops the HTTP/WebSocket server, opening the listening sockets on the configured bindings.
PortTCP port on which the server accepts incoming HTTP and WebSocket connections.
BindingsCollection of IP/Port pairs the server listens on; use it to bind several endpoints simultaneously.
MaxConnectionsMaximum number of concurrent client connections accepted by the server.
KeepAliveKeeps the HTTP connection open after a response has been sent so that subsequent requests can reuse it.

HTTP

NameDescription
DocumentRootDirectory served by the built-in HTTP server for static files (HTML, JavaScript, CSS, images, etc.).
HTTP2OptionsEnables and tunes the HTTP/2 protocol handler used to serve HTTPS requests.
HTTPUploadFilesControls how files uploaded through HTTP POST are buffered (memory or file stream) and saved to disk.

Sessions

NameDescription
AutoStartSessionCreates a new HTTP session automatically for every incoming request when session state is enabled.
SessionStateEnables cookie-based HTTP session tracking on top of the stateless HTTP protocol.
SessionTimeOutIdle timeout, in milliseconds, after which an HTTP session is considered expired and eligible for removal.

Security

NameDescription
AuthenticationEnables and configures user/password authentication for incoming WebSocket and HTTP connections.
SSLEnables TLS/SSL on the server so that clients can connect using wss:// or https://.
SSLOptionsHolds certificate paths, TLS version selection and OpenSSL tuning for the TLS listener.
SecurityOptionsDefines admission rules such as allowed origins for browser WebSocket handshakes.
APIKeyManagerOptional API-key manager component used to validate incoming API keys before accepting a connection.

Reliability

NameDescription
HeartBeatSends periodic ping frames to keep idle client connections alive and detect dead peers.
WatchDogAutomatically restarts the server after an unexpected shutdown or listener failure.
LoadBalancerConfigures the built-in client used to register this server with a Load Balancer Server instance.
FallBackProvides alternative transports for browsers that do not support native WebSockets.
RateLimiterAssigns a rate-limiter component that caps request and message rates per client or per IP.
FirewallAssigns a firewall component that filters incoming connections by IP, region or custom rules.

Advanced

NameDescription
OptionsBundles miscellaneous server behaviour flags: fragment handling, timeouts, HTTP test pages and UTF-8 validation.
QueueOptionsSerialises outbound messages through an internal per-connection queue to prevent contention between threads.
ExtensionsConfigures WebSocket protocol extensions such as per-message deflate compression.
SpecificationsEnables or disables the WebSocket protocol specifications the server will accept.
IOHandlerOptionsSelects the I/O strategy used to service connections: thread-per-connection, IOCP or EPOLL.
ThreadPoolEnables a thread pool that recycles worker threads instead of destroying them when connections close.
ThreadPoolOptionsConfigures the size and upper bound of the reusable thread pool used when ThreadPool is enabled.
ThrottleCaps the bandwidth (bits per second) that the server reads from or writes to each connection.

Diagnostics

NameDescription
LogFileWrites every incoming and outgoing socket message to a log file for debugging and auditing.
NotifyEventsControls how threaded WebSocket events are synchronized with the main VCL thread.
VersionRead-only string with the sgcWebSockets library version embedded in the binary.

All Properties (alphabetical)

NameDescription
ActiveStarts or stops the HTTP/WebSocket server, opening the listening sockets on the configured bindings.
APIKeyManagerOptional API-key manager component used to validate incoming API keys before accepting a connection.
AuthenticationEnables and configures user/password authentication for incoming WebSocket and HTTP connections.
AutoStartSessionCreates a new HTTP session automatically for every incoming request when session state is enabled.
BindingsCollection of IP/Port pairs the server listens on; use it to bind several endpoints simultaneously.
DocumentRootDirectory served by the built-in HTTP server for static files (HTML, JavaScript, CSS, images, etc.).
ExtensionsConfigures WebSocket protocol extensions such as per-message deflate compression.
FallBackProvides alternative transports for browsers that do not support native WebSockets.
FirewallAssigns a firewall component that filters incoming connections by IP, region or custom rules.
HeartBeatSends periodic ping frames to keep idle client connections alive and detect dead peers.
HTTP2OptionsEnables and tunes the HTTP/2 protocol handler used to serve HTTPS requests.
HTTPUploadFilesControls how files uploaded through HTTP POST are buffered (memory or file stream) and saved to disk.
IOHandlerOptionsSelects the I/O strategy used to service connections: thread-per-connection, IOCP or EPOLL.
KeepAliveKeeps the HTTP connection open after a response has been sent so that subsequent requests can reuse it.
LoadBalancerConfigures the built-in client used to register this server with a Load Balancer Server instance.
LogFileWrites every incoming and outgoing socket message to a log file for debugging and auditing.
MaxConnectionsMaximum number of concurrent client connections accepted by the server.
NotifyEventsControls how threaded WebSocket events are synchronized with the main VCL thread.
OptionsBundles miscellaneous server behaviour flags: fragment handling, timeouts, HTTP test pages and UTF-8 validation.
PortTCP port on which the server accepts incoming HTTP and WebSocket connections.
QueueOptionsSerialises outbound messages through an internal per-connection queue to prevent contention between threads.
RateLimiterAssigns a rate-limiter component that caps request and message rates per client or per IP.
SecurityOptionsDefines admission rules such as allowed origins for browser WebSocket handshakes.
SessionStateEnables cookie-based HTTP session tracking on top of the stateless HTTP protocol.
SessionTimeOutIdle timeout, in milliseconds, after which an HTTP session is considered expired and eligible for removal.
SpecificationsEnables or disables the WebSocket protocol specifications the server will accept.
SSLEnables TLS/SSL on the server so that clients can connect using wss:// or https://.
SSLOptionsHolds certificate paths, TLS version selection and OpenSSL tuning for the TLS listener.
ThreadPoolEnables a thread pool that recycles worker threads instead of destroying them when connections close.
ThreadPoolOptionsConfigures the size and upper bound of the reusable thread pool used when ThreadPool is enabled.
ThrottleCaps the bandwidth (bits per second) that the server reads from or writes to each connection.
VersionRead-only string with the sgcWebSockets library version embedded in the binary.
WatchDogAutomatically restarts the server after an unexpected shutdown or listener failure.