TsgcHTTPServer Właściwości

Opublikowane właściwości pogrupowane według przeznaczenia, a następnie pełna lista alfabetyczna.

Połączenie

Nazwa	Opis
Active	Uruchamia lub zatrzymuje serwer HTTP, otwierając gniazda nasłuchujące na skonfigurowanych powiązaniach.
Port	Port TCP, na którym serwer przyjmuje przychodzące połączenia HTTP.
Bindings	Kolekcja par IP/Port, na których nasłuchuje serwer; umożliwia jednoczesne powiązanie kilku punktów końcowych.
MaxConnections	Maksymalna liczba jednoczesnych połączeń klienta akceptowanych przez serwer.
KeepAlive	Utrzymuje połączenie HTTP otwarte po wysłaniu odpowiedzi, aby kolejne żądania mogły je ponownie wykorzystać.

HTTP

Nazwa	Opis
Charset	Zestaw znaków stosowany do odpowiedzi tekstowych serwowanych z DocumentRoot.
DocumentRoot	Katalog obsługiwany przez serwer HTTP dla plików statycznych (HTML, JavaScript, CSS, obrazy itp.).
HTTP2Options	Włącza i konfiguruje moduł obsługi protokołu HTTP/2 używany do obsługi żądań HTTPS.
HTTP3Options	Włącza nasłuch HTTP/3 (QUIC), który obsługuje żądania HTTP równolegle z HTTP/1.1 i HTTP/2, przez UDP.
HTTPCompression	Kompresuje odpowiedzi HTTP/1.1 przy pomocy gzip lub deflate, gdy klient zgłasza obsługę.
HTTPUploadFiles	Kontroluje sposób buforowania (pamięć lub strumień plikowy) i zapisywania na dysku plików przesłanych przez HTTP POST.
ParseParams	Analizuje ciąg zapytania oraz treść formularza (form-urlencoded) każdego żądania i zapisuje je w ARequestInfo.Params.

Sesje

Nazwa	Opis
AutoStartSession	Automatycznie tworzy nową sesję HTTP dla każdego przychodzącego żądania, gdy włączony jest stan sesji.
SessionClass	Klasa używana przez serwer do tworzenia nowych sesji HTTP; ustaw ją na własnego potomka TIdHTTPSession.
SessionList	Lista przechowująca aktywne sesje HTTP; odczytaj ją, aby zarządzać sesjami z poziomu kodu, albo przypisz własną listę.
SessionState	Włącza śledzenie sesji HTTP opartej na plikach cookie, ponad bezstanowym protokołem HTTP.
SessionTimeOut	Limit czasu bezczynności w milisekundach, po upływie którego sesja HTTP jest uznawana za wygasłą i kwalifikuje się do usunięcia.

Bezpieczeństwo

Nazwa	Opis
Authentication	Włącza i konfiguruje uwierzytelnianie użytkownik/hasło dla przychodzących połączeń HTTP.
SSL	Włącza TLS/SSL na serwerze, aby klienci mogli łączyć się przy użyciu https://.
SSLOptions	Przechowuje ścieżki certyfikatów, wybór wersji TLS oraz ustawienia OpenSSL dla nasłuchiwacza TLS.
SecurityOptions	Reguły dopuszczania uzgadniania połączenia odziedziczone ze współdzielonego silnika serwera; nie mają zastosowania w tym komponencie (patrz Uwagi).
MaxRequestBodySize	Maksymalny rozmiar w bajtach przychodzącej treści żądania HTTP; chroni serwer przed atakami wyczerpującymi pamięć.
StrictRequestParsing	Odrzuca niejednoznaczne żądania HTTP wykorzystywane w atakach typu request smuggling i stosuje bardziej rygorystyczną walidację kodowania chunked.
APIKeyManager	Opcjonalny komponent zarządzania kluczami API służący do weryfikacji przychodzących kluczy API przed akceptacją połączenia.

Niezawodność

Nazwa	Opis
WatchDog	Automatycznie restartuje serwer po nieoczekiwanym zamknięciu lub awarii nasłuchiwania.
FallBack	Odziedziczone ze współdzielonego silnika serwera; nie ma zastosowania w tym komponencie (patrz Uwagi).
RateLimiter	Przypisuje komponent ogranicznika szybkości, który ogranicza częstotliwość żądań na klienta lub na adres IP.
Firewall	Przypisuje komponent zapory sieciowej filtrujący przychodzące połączenia według adresu IP, regionu lub reguł niestandardowych.

Zaawansowane

Nazwa	Opis
Options	Grupuje różne flagi zachowania serwera: limity czasu, wbudowane strony testowe oraz nagłówek HTTP Server.
IOHandlerOptions	Wybiera strategię wejścia/wyjścia używaną do obsługi połączeń: wątek na połączenie, IOCP lub EPOLL.
ThreadPool	Włącza pulę wątków, która ponownie wykorzystuje wątki robocze zamiast je niszczyć po zamknięciu połączeń.
ThreadPoolOptions	Konfiguruje rozmiar i górną granicę wielokrotnie używanej puli wątków, gdy włączona jest opcja ThreadPool.
Throttle	Ogranicza przepustowość (bity na sekundę), jaką serwer odczytuje lub zapisuje dla każdego połączenia.

Diagnostyka

Nazwa	Opis
LogFile	Zapisuje każde przychodzące i wychodzące żądanie/odpowiedź HTTP do pliku dziennika na potrzeby debugowania i audytu.
NotifyEvents	Steruje sposobem synchronizowania wielowątkowych zdarzeń serwera z głównym wątkiem VCL.
Version	Ciąg znaków tylko do odczytu z wersją biblioteki sgcWebSockets osadzoną w pliku binarnym.

Wszystkie właściwości (alfabetycznie)

Nazwa	Opis
Active	Uruchamia lub zatrzymuje serwer HTTP, otwierając gniazda nasłuchujące na skonfigurowanych powiązaniach.
APIKeyManager	Opcjonalny komponent zarządzania kluczami API służący do weryfikacji przychodzących kluczy API przed akceptacją połączenia.
Authentication	Włącza i konfiguruje uwierzytelnianie użytkownik/hasło dla przychodzących połączeń HTTP.
AutoStartSession	Automatycznie tworzy nową sesję HTTP dla każdego przychodzącego żądania, gdy włączony jest stan sesji.
Bindings	Kolekcja par IP/Port, na których nasłuchuje serwer; umożliwia jednoczesne powiązanie kilku punktów końcowych.
Charset	Zestaw znaków stosowany do odpowiedzi tekstowych serwowanych z DocumentRoot.
DocumentRoot	Katalog obsługiwany przez serwer HTTP dla plików statycznych (HTML, JavaScript, CSS, obrazy itp.).
FallBack	Odziedziczone ze współdzielonego silnika serwera; nie ma zastosowania w tym komponencie (patrz Uwagi).
Firewall	Przypisuje komponent zapory sieciowej filtrujący przychodzące połączenia według adresu IP, regionu lub reguł niestandardowych.
HTTP2Options	Włącza i konfiguruje moduł obsługi protokołu HTTP/2 używany do obsługi żądań HTTPS.
HTTP3Options	Włącza nasłuch HTTP/3 (QUIC), który obsługuje żądania HTTP równolegle z HTTP/1.1 i HTTP/2, przez UDP.
HTTPCompression	Kompresuje odpowiedzi HTTP/1.1 przy pomocy gzip lub deflate, gdy klient zgłasza obsługę.
HTTPUploadFiles	Kontroluje sposób buforowania (pamięć lub strumień plikowy) i zapisywania na dysku plików przesłanych przez HTTP POST.
IOHandlerOptions	Wybiera strategię wejścia/wyjścia używaną do obsługi połączeń: wątek na połączenie, IOCP lub EPOLL.
KeepAlive	Utrzymuje połączenie HTTP otwarte po wysłaniu odpowiedzi, aby kolejne żądania mogły je ponownie wykorzystać.
LogFile	Zapisuje każde przychodzące i wychodzące żądanie/odpowiedź HTTP do pliku dziennika na potrzeby debugowania i audytu.
MaxConnections	Maksymalna liczba jednoczesnych połączeń klienta akceptowanych przez serwer.
MaxRequestBodySize	Maksymalny rozmiar w bajtach przychodzącej treści żądania HTTP; chroni serwer przed atakami wyczerpującymi pamięć.
NotifyEvents	Steruje sposobem synchronizowania wielowątkowych zdarzeń serwera z głównym wątkiem VCL.
Options	Grupuje różne flagi zachowania serwera: limity czasu, wbudowane strony testowe oraz nagłówek HTTP Server.
ParseParams	Analizuje ciąg zapytania oraz treść formularza (form-urlencoded) każdego żądania i zapisuje je w ARequestInfo.Params.
Port	Port TCP, na którym serwer przyjmuje przychodzące połączenia HTTP.
RateLimiter	Przypisuje komponent ogranicznika szybkości, który ogranicza częstotliwość żądań na klienta lub na adres IP.
SecurityOptions	Reguły dopuszczania uzgadniania połączenia odziedziczone ze współdzielonego silnika serwera; nie mają zastosowania w tym komponencie (patrz Uwagi).
SessionClass	Klasa używana przez serwer do tworzenia nowych sesji HTTP; ustaw ją na własnego potomka TIdHTTPSession.
SessionList	Lista przechowująca aktywne sesje HTTP; odczytaj ją, aby zarządzać sesjami z poziomu kodu, albo przypisz własną listę.
SessionState	Włącza śledzenie sesji HTTP opartej na plikach cookie, ponad bezstanowym protokołem HTTP.
SessionTimeOut	Limit czasu bezczynności w milisekundach, po upływie którego sesja HTTP jest uznawana za wygasłą i kwalifikuje się do usunięcia.
SSL	Włącza TLS/SSL na serwerze, aby klienci mogli łączyć się przy użyciu https://.
SSLOptions	Przechowuje ścieżki certyfikatów, wybór wersji TLS oraz ustawienia OpenSSL dla nasłuchiwacza TLS.
StrictRequestParsing	Odrzuca niejednoznaczne żądania HTTP wykorzystywane w atakach typu request smuggling i stosuje bardziej rygorystyczną walidację kodowania chunked.
ThreadPool	Włącza pulę wątków, która ponownie wykorzystuje wątki robocze zamiast je niszczyć po zamknięciu połączeń.
ThreadPoolOptions	Konfiguruje rozmiar i górną granicę wielokrotnie używanej puli wątków, gdy włączona jest opcja ThreadPool.
Throttle	Ogranicza przepustowość (bity na sekundę), jaką serwer odczytuje lub zapisuje dla każdego połączenia.
Version	Ciąg znaków tylko do odczytu z wersją biblioteki sgcWebSockets osadzoną w pliku binarnym.
WatchDog	Automatycznie restartuje serwer po nieoczekiwanym zamknięciu lub awarii nasłuchiwania.