TsgcHTTPServer › Propriétés

TsgcHTTPServer Propriétés

Propriétés publiées regroupées par objectif, suivies de la liste alphabétique complète.

Connexion

NomDescription
ActiveDémarre ou arrête le serveur HTTP, en ouvrant les sockets d'écoute sur les liaisons configurées.
PortPort TCP sur lequel le serveur accepte les connexions HTTP entrantes.
BindingsCollection de paires IP/Port sur lesquelles le serveur écoute ; utilisez-la pour lier plusieurs points de terminaison simultanément.
MaxConnectionsNombre maximum de connexions clientes simultanées acceptées par le serveur.
KeepAliveMaintient la connexion HTTP ouverte après l'envoi d'une réponse afin que les requêtes suivantes puissent la réutiliser.

HTTP

NomDescription
CharsetJeu de caractères appliqué aux réponses texte servies depuis DocumentRoot.
DocumentRootRépertoire servi par le serveur HTTP pour les fichiers statiques (HTML, JavaScript, CSS, images, etc.).
HTTP2OptionsActive et configure le gestionnaire de protocole HTTP/2 utilisé pour servir les requêtes HTTPS.
HTTP3OptionsActive l'écouteur HTTP/3 (QUIC) qui traite les requêtes HTTP en plus de HTTP/1.1 et HTTP/2, sur UDP.
HTTPCompressionCompresse les réponses HTTP/1.1 avec gzip ou deflate lorsque le client annonce la prise en charge.
HTTPUploadFilesContrôle comment les fichiers téléversés via HTTP POST sont mis en tampon (mémoire ou flux de fichier) et sauvegardés sur le disque.
ParseParamsAnalyse la chaîne de requête et le corps form-urlencoded de chaque requête dans ARequestInfo.Params.

Sessions

NomDescription
AutoStartSessionCrée automatiquement une nouvelle session HTTP pour chaque requête entrante lorsque l'état de session est activé.
SessionClassClasse utilisée par le serveur pour créer de nouvelles sessions HTTP ; réglez-la sur votre propre descendant de TIdHTTPSession.
SessionListListe contenant les sessions HTTP actives ; lisez-la pour gérer les sessions par code, ou affectez votre propre liste.
SessionStateActive le suivi de session HTTP basé sur les cookies par-dessus le protocole HTTP sans état.
SessionTimeOutDélai d'inactivité, en millisecondes, après lequel une session HTTP est considérée comme expirée et éligible à la suppression.

Sécurité

NomDescription
AuthenticationActive et configure l'authentification utilisateur/mot de passe pour les connexions HTTP entrantes.
SSLActive TLS/SSL sur le serveur afin que les clients puissent se connecter en utilisant https://.
SSLOptionsContient les chemins de certificat, la sélection de version TLS et le réglage OpenSSL pour l'écouteur TLS.
SecurityOptionsRègles d'admission du handshake héritées du moteur serveur partagé ; non applicables à ce composant (voir Remarques).
MaxRequestBodySizeTaille maximale en octets d'un corps de requête HTTP entrante ; protège le serveur des attaques par épuisement de mémoire.
StrictRequestParsingRejette les requêtes HTTP ambiguës utilisées dans les attaques de request-smuggling et applique une validation plus stricte du chunked-encoding.
APIKeyManagerComposant optionnel de gestion des clés API utilisé pour valider les clés API entrantes avant d'accepter une connexion.

Fiabilité

NomDescription
WatchDogRedémarre automatiquement le serveur après un arrêt inattendu ou un échec d'écouteur.
FallBackHérité du moteur serveur partagé ; non applicable à ce composant (voir Remarques).
RateLimiterAssigne un composant de limitation de débit qui plafonne les taux de requêtes par client ou par IP.
FirewallAssigne un composant pare-feu qui filtre les connexions entrantes par IP, région ou règles personnalisées.

Avancé

NomDescription
OptionsRegroupe divers indicateurs de comportement du serveur : délais d'expiration, pages de test intégrées et l'en-tête HTTP Server.
IOHandlerOptionsSélectionne la stratégie d'E/S utilisée pour traiter les connexions : thread par connexion, IOCP ou EPOLL.
ThreadPoolActive un pool de threads qui recycle les threads de travail au lieu de les détruire à la fermeture des connexions.
ThreadPoolOptionsConfigure la taille et la limite supérieure du pool de threads réutilisable utilisé lorsque ThreadPool est activé.
ThrottleLimite la bande passante (bits par seconde) que le serveur lit depuis ou écrit vers chaque connexion.

Diagnostics

NomDescription
LogFileÉcrit chaque requête et réponse HTTP entrante et sortante dans un fichier journal pour le débogage et l'audit.
NotifyEventsContrôle la façon dont les événements serveur threadés sont synchronisés avec le thread principal VCL.
VersionChaîne en lecture seule avec la version de la bibliothèque sgcWebSockets intégrée dans le binaire.

Toutes les propriétés (ordre alphabétique)

NomDescription
ActiveDémarre ou arrête le serveur HTTP, en ouvrant les sockets d'écoute sur les liaisons configurées.
APIKeyManagerComposant optionnel de gestion des clés API utilisé pour valider les clés API entrantes avant d'accepter une connexion.
AuthenticationActive et configure l'authentification utilisateur/mot de passe pour les connexions HTTP entrantes.
AutoStartSessionCrée automatiquement une nouvelle session HTTP pour chaque requête entrante lorsque l'état de session est activé.
BindingsCollection de paires IP/Port sur lesquelles le serveur écoute ; utilisez-la pour lier plusieurs points de terminaison simultanément.
CharsetJeu de caractères appliqué aux réponses texte servies depuis DocumentRoot.
DocumentRootRépertoire servi par le serveur HTTP pour les fichiers statiques (HTML, JavaScript, CSS, images, etc.).
FallBackHérité du moteur serveur partagé ; non applicable à ce composant (voir Remarques).
FirewallAssigne un composant pare-feu qui filtre les connexions entrantes par IP, région ou règles personnalisées.
HTTP2OptionsActive et configure le gestionnaire de protocole HTTP/2 utilisé pour servir les requêtes HTTPS.
HTTP3OptionsActive l'écouteur HTTP/3 (QUIC) qui traite les requêtes HTTP en plus de HTTP/1.1 et HTTP/2, sur UDP.
HTTPCompressionCompresse les réponses HTTP/1.1 avec gzip ou deflate lorsque le client annonce la prise en charge.
HTTPUploadFilesContrôle comment les fichiers téléversés via HTTP POST sont mis en tampon (mémoire ou flux de fichier) et sauvegardés sur le disque.
IOHandlerOptionsSélectionne la stratégie d'E/S utilisée pour traiter les connexions : thread par connexion, IOCP ou EPOLL.
KeepAliveMaintient la connexion HTTP ouverte après l'envoi d'une réponse afin que les requêtes suivantes puissent la réutiliser.
LogFileÉcrit chaque requête et réponse HTTP entrante et sortante dans un fichier journal pour le débogage et l'audit.
MaxConnectionsNombre maximum de connexions clientes simultanées acceptées par le serveur.
MaxRequestBodySizeTaille maximale en octets d'un corps de requête HTTP entrante ; protège le serveur des attaques par épuisement de mémoire.
NotifyEventsContrôle la façon dont les événements serveur threadés sont synchronisés avec le thread principal VCL.
OptionsRegroupe divers indicateurs de comportement du serveur : délais d'expiration, pages de test intégrées et l'en-tête HTTP Server.
ParseParamsAnalyse la chaîne de requête et le corps form-urlencoded de chaque requête dans ARequestInfo.Params.
PortPort TCP sur lequel le serveur accepte les connexions HTTP entrantes.
RateLimiterAssigne un composant de limitation de débit qui plafonne les taux de requêtes par client ou par IP.
SecurityOptionsRègles d'admission du handshake héritées du moteur serveur partagé ; non applicables à ce composant (voir Remarques).
SessionClassClasse utilisée par le serveur pour créer de nouvelles sessions HTTP ; réglez-la sur votre propre descendant de TIdHTTPSession.
SessionListListe contenant les sessions HTTP actives ; lisez-la pour gérer les sessions par code, ou affectez votre propre liste.
SessionStateActive le suivi de session HTTP basé sur les cookies par-dessus le protocole HTTP sans état.
SessionTimeOutDélai d'inactivité, en millisecondes, après lequel une session HTTP est considérée comme expirée et éligible à la suppression.
SSLActive TLS/SSL sur le serveur afin que les clients puissent se connecter en utilisant https://.
SSLOptionsContient les chemins de certificat, la sélection de version TLS et le réglage OpenSSL pour l'écouteur TLS.
StrictRequestParsingRejette les requêtes HTTP ambiguës utilisées dans les attaques de request-smuggling et applique une validation plus stricte du chunked-encoding.
ThreadPoolActive un pool de threads qui recycle les threads de travail au lieu de les détruire à la fermeture des connexions.
ThreadPoolOptionsConfigure la taille et la limite supérieure du pool de threads réutilisable utilisé lorsque ThreadPool est activé.
ThrottleLimite la bande passante (bits par seconde) que le serveur lit depuis ou écrit vers chaque connexion.
VersionChaîne en lecture seule avec la version de la bibliothèque sgcWebSockets intégrée dans le binaire.
WatchDogRedémarre automatiquement le serveur après un arrêt inattendu ou un échec d'écouteur.