TsgcHTTPServer Properties

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

Connection

Name	Description
Active	Starts or stops the HTTP server, opening the listening sockets on the configured bindings.
Port	TCP port on which the server accepts incoming HTTP connections.
Bindings	Collection of IP/Port pairs the server listens on; use it to bind several endpoints simultaneously.
MaxConnections	Maximum number of concurrent client connections accepted by the server.
KeepAlive	Keeps the HTTP connection open after a response has been sent so that subsequent requests can reuse it.

HTTP

Name	Description
Charset	Charset applied to text responses served from DocumentRoot.
DocumentRoot	Directory served by the HTTP server for static files (HTML, JavaScript, CSS, images, etc.).
HTTP2Options	Enables and tunes the HTTP/2 protocol handler used to serve HTTPS requests.
HTTP3Options	Enables the HTTP/3 (QUIC) listener that serves HTTP requests alongside HTTP/1.1 and HTTP/2, over UDP.
HTTPCompression	Compresses HTTP/1.1 responses with gzip or deflate when the client advertises support.
HTTPUploadFiles	Controls how files uploaded through HTTP POST are buffered (memory or file stream) and saved to disk.
ParseParams	Parses the query string and form-urlencoded body of every request into ARequestInfo.Params.

Sessions

Name	Description
AutoStartSession	Creates a new HTTP session automatically for every incoming request when session state is enabled.
SessionClass	Class used by the server to create new HTTP sessions; set it to your own TIdHTTPSession descendant.
SessionList	List holding the active HTTP sessions; read it to manage sessions by code, or assign your own list.
SessionState	Enables cookie-based HTTP session tracking on top of the stateless HTTP protocol.
SessionTimeOut	Idle timeout, in milliseconds, after which an HTTP session is considered expired and eligible for removal.

Security

Name	Description
Authentication	Enables and configures user/password authentication for incoming HTTP connections.
SSL	Enables TLS/SSL on the server so that clients can connect using https://.
SSLOptions	Holds certificate paths, TLS version selection and OpenSSL tuning for the TLS listener.
SecurityOptions	Handshake admission rules inherited from the shared server engine; not applicable to this component (see Remarks).
MaxRequestBodySize	Maximum size in bytes of an inbound HTTP request body; protects the server from memory-exhaustion attacks.
StrictRequestParsing	Rejects ambiguous HTTP requests used in request-smuggling attacks and applies stricter chunked-encoding validation.
APIKeyManager	Optional API-key manager component used to validate incoming API keys before accepting a connection.

Reliability

Name	Description
WatchDog	Automatically restarts the server after an unexpected shutdown or listener failure.
FallBack	Inherited from the shared server engine; not applicable to this component (see Remarks).
RateLimiter	Assigns a rate-limiter component that caps request rates per client or per IP.
Firewall	Assigns a firewall component that filters incoming connections by IP, region or custom rules.

Advanced

Name	Description
Options	Bundles miscellaneous server behaviour flags: timeouts, built-in test pages and the HTTP Server header.
IOHandlerOptions	Selects the I/O strategy used to service connections: thread-per-connection, IOCP or EPOLL.
ThreadPool	Enables a thread pool that recycles worker threads instead of destroying them when connections close.
ThreadPoolOptions	Configures the size and upper bound of the reusable thread pool used when ThreadPool is enabled.
Throttle	Caps the bandwidth (bits per second) that the server reads from or writes to each connection.

Diagnostics

Name	Description
LogFile	Writes every incoming and outgoing HTTP request/response to a log file for debugging and auditing.
NotifyEvents	Controls how threaded server events are synchronized with the main VCL thread.
Version	Read-only string with the sgcWebSockets library version embedded in the binary.

All Properties (alphabetical)

Name	Description
Active	Starts or stops the HTTP server, opening the listening sockets on the configured bindings.
APIKeyManager	Optional API-key manager component used to validate incoming API keys before accepting a connection.
Authentication	Enables and configures user/password authentication for incoming HTTP connections.
AutoStartSession	Creates a new HTTP session automatically for every incoming request when session state is enabled.
Bindings	Collection of IP/Port pairs the server listens on; use it to bind several endpoints simultaneously.
Charset	Charset applied to text responses served from DocumentRoot.
DocumentRoot	Directory served by the HTTP server for static files (HTML, JavaScript, CSS, images, etc.).
FallBack	Inherited from the shared server engine; not applicable to this component (see Remarks).
Firewall	Assigns a firewall component that filters incoming connections by IP, region or custom rules.
HTTP2Options	Enables and tunes the HTTP/2 protocol handler used to serve HTTPS requests.
HTTP3Options	Enables the HTTP/3 (QUIC) listener that serves HTTP requests alongside HTTP/1.1 and HTTP/2, over UDP.
HTTPCompression	Compresses HTTP/1.1 responses with gzip or deflate when the client advertises support.
HTTPUploadFiles	Controls how files uploaded through HTTP POST are buffered (memory or file stream) and saved to disk.
IOHandlerOptions	Selects the I/O strategy used to service connections: thread-per-connection, IOCP or EPOLL.
KeepAlive	Keeps the HTTP connection open after a response has been sent so that subsequent requests can reuse it.
LogFile	Writes every incoming and outgoing HTTP request/response to a log file for debugging and auditing.
MaxConnections	Maximum number of concurrent client connections accepted by the server.
MaxRequestBodySize	Maximum size in bytes of an inbound HTTP request body; protects the server from memory-exhaustion attacks.
NotifyEvents	Controls how threaded server events are synchronized with the main VCL thread.
Options	Bundles miscellaneous server behaviour flags: timeouts, built-in test pages and the HTTP Server header.
ParseParams	Parses the query string and form-urlencoded body of every request into ARequestInfo.Params.
Port	TCP port on which the server accepts incoming HTTP connections.
RateLimiter	Assigns a rate-limiter component that caps request rates per client or per IP.
SecurityOptions	Handshake admission rules inherited from the shared server engine; not applicable to this component (see Remarks).
SessionClass	Class used by the server to create new HTTP sessions; set it to your own TIdHTTPSession descendant.
SessionList	List holding the active HTTP sessions; read it to manage sessions by code, or assign your own list.
SessionState	Enables cookie-based HTTP session tracking on top of the stateless HTTP protocol.
SessionTimeOut	Idle timeout, in milliseconds, after which an HTTP session is considered expired and eligible for removal.
SSL	Enables TLS/SSL on the server so that clients can connect using https://.
SSLOptions	Holds certificate paths, TLS version selection and OpenSSL tuning for the TLS listener.
StrictRequestParsing	Rejects ambiguous HTTP requests used in request-smuggling attacks and applies stricter chunked-encoding validation.
ThreadPool	Enables a thread pool that recycles worker threads instead of destroying them when connections close.
ThreadPoolOptions	Configures the size and upper bound of the reusable thread pool used when ThreadPool is enabled.
Throttle	Caps the bandwidth (bits per second) that the server reads from or writes to each connection.
Version	Read-only string with the sgcWebSockets library version embedded in the binary.
WatchDog	Automatically restarts the server after an unexpected shutdown or listener failure.