TsgcWebSocketServer › Properties

TsgcWebSocketServer Properties

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

Connection

NameDescription
ActiveStarts or stops the server, opening the listening sockets on the configured bindings.
PortTCP port on which the server accepts incoming WebSocket and HTTP 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.

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.
HTTP2OptionsEnables and tunes the HTTP/2 protocol handler used to serve HTTPS requests.
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.
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 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.
BindingsCollection of IP/Port pairs the server listens on; use it to bind several endpoints simultaneously.
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.
IOHandlerOptionsSelects the I/O strategy used to service connections: thread-per-connection, IOCP or EPOLL.
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 WebSocket and HTTP 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.
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.
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.