TsgcWebSocketServer_HTTPAPI › Właściwości

Właściwości TsgcWebSocketServer_HTTPAPI

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

Połączenie

NazwaOpis
ActiveUruchamia lub zatrzymuje nasłuchiwanie HTTP.sys, rejestrując skonfigurowany URL w sterowniku jądra systemu Windows.
HostNazwa hosta lub adres IP używany do budowania URL rejestrowanego w sterowniku http.sys.
PortPort TCP, który w połączeniu z Host tworzy URL zastrzeżony przez sterownik http.sys dla serwera.
BindingOptionsPrecyzuje sposób rejestrowania rezerwacji URL i certyfikatów SSL w sterowniku http.sys podczas uruchamiania.
MaxConnectionsMaksymalna liczba jednoczesnych połączeń klienckich akceptowanych przez detektor http.sys (zero oznacza brak limitu).

Limity czasu

NazwaOpis
TimeoutsZastępuje domyślne limity czasu żądań, treści encji, keep-alive i szybkości wysyłania http.sys.

Bezpieczeństwo

NazwaOpis
AuthenticationWłącza i konfiguruje uwierzytelnianie użytkownik/hasło dla przychodzących żądań WebSocket i HTTP.
SSLWłącza TLS/SSL na odbiorniku http.sys, dzięki czemu klienci mogą łączyć się przy użyciu wss:// lub https://.
SSLOptionsIdentyfikuje wpis magazynu certyfikatów Windows, do którego http.sys wiąże odbiornik przy włączonej obsłudze SSL.
SecurityOptionsDefiniuje reguły dostępu, takie jak dozwolone źródła dla uzgadniania połączeń WebSocket przeglądarki.
APIKeyManagerOpcjonalny komponent zarządzania kluczami API służący do weryfikacji przychodzących kluczy API przed akceptacją połączenia.

Niezawodność

NazwaOpis
HeartBeatWysyła okresowe ramki ping w celu utrzymania przy życiu bezczynnych połączeń WebSocket i wykrywania nieaktywnych partnerów.
WatchDogAutomatycznie restartuje serwer po nieoczekiwanym zamknięciu lub awarii nasłuchiwania.
FirewallPrzypisuje komponent zapory sieciowej filtrujący przychodzące połączenia według adresu IP, regionu lub reguł niestandardowych.
RateLimiterPrzypisuje komponent ogranicznika szybkości, który ogranicza częstotliwość żądań i wiadomości na klienta lub na adres IP.

Wydajność

NazwaOpis
AsynchronousWłącza wysyłanie w trybie „fire-and-forget": wywołujący natychmiast powraca, a zakończenie operacji jest sygnalizowane przez zdarzenie OnAsynchronous.
MaxBandwidthMaksymalna dozwolona przepustowość w bajtach na sekundę dla wszystkich połączeń łącznie (zero oznacza brak limitu).
ThreadPoolSizeLiczba wątków roboczych obsługujących kolejkę żądań http.sys przez IOCP.
ReadBufferSizeRozmiar w bajtach bufora odbiorczego przydzielonego dla każdego oczekującego nakładkowego odczytu względem kolejki żądań http.sys.
FineTuneNiskopoziomowe ustawienia trybu jądra kształtujące sposób, w jaki http.sys kolejkuje, wysyła i finalizuje żądania.

HTTP

NazwaOpis
HTTPUploadFilesKontroluje sposób buforowania (pamięć lub strumień plikowy) i zapisywania na dysku plików przesłanych przez HTTP POST.

Zaawansowane

NazwaOpis
OptionsGrupuje różne flagi zachowania serwera: obsługę fragmentów, limity czasu zapisu, strony testowe HTTP i walidację UTF-8.
QueueOptionsSerializuje wychodzące wiadomości przez wewnętrzną kolejkę per-połączenie, zapobiegając rywalizacji między wątkami.
ExtensionsKonfiguruje rozszerzenia protokołu WebSocket, takie jak kompresja per-message deflate.
SpecyfikacjeWłącza lub wyłącza specyfikacje protokołu WebSocket akceptowane przez serwer.

Diagnostyka

NazwaOpis
LogFileZapisuje każdą przychodzącą i wychodzącą wiadomość gniazda do pliku dziennika na potrzeby debugowania i audytu.
VersionCiąg znaków tylko do odczytu z wersją biblioteki sgcWebSockets osadzoną w pliku binarnym.

Wszystkie właściwości (alfabetycznie)

NazwaOpis
ActiveUruchamia lub zatrzymuje nasłuchiwanie HTTP.sys, rejestrując skonfigurowany URL w sterowniku jądra systemu Windows.
APIKeyManagerOpcjonalny komponent zarządzania kluczami API służący do weryfikacji przychodzących kluczy API przed akceptacją połączenia.
AsynchronousWłącza wysyłanie w trybie „fire-and-forget": wywołujący natychmiast powraca, a zakończenie operacji jest sygnalizowane przez zdarzenie OnAsynchronous.
AuthenticationWłącza i konfiguruje uwierzytelnianie użytkownik/hasło dla przychodzących żądań WebSocket i HTTP.
BindingOptionsPrecyzuje sposób rejestrowania rezerwacji URL i certyfikatów SSL w sterowniku http.sys podczas uruchamiania.
ExtensionsKonfiguruje rozszerzenia protokołu WebSocket, takie jak kompresja per-message deflate.
FineTuneNiskopoziomowe ustawienia trybu jądra kształtujące sposób, w jaki http.sys kolejkuje, wysyła i finalizuje żądania.
FirewallPrzypisuje komponent zapory sieciowej filtrujący przychodzące połączenia według adresu IP, regionu lub reguł niestandardowych.
HeartBeatWysyła okresowe ramki ping w celu utrzymania przy życiu bezczynnych połączeń WebSocket i wykrywania nieaktywnych partnerów.
HostNazwa hosta lub adres IP używany do budowania URL rejestrowanego w sterowniku http.sys.
HTTPUploadFilesKontroluje sposób buforowania (pamięć lub strumień plikowy) i zapisywania na dysku plików przesłanych przez HTTP POST.
LogFileZapisuje każdą przychodzącą i wychodzącą wiadomość gniazda do pliku dziennika na potrzeby debugowania i audytu.
MaxBandwidthMaksymalna dozwolona przepustowość w bajtach na sekundę dla wszystkich połączeń łącznie (zero oznacza brak limitu).
MaxConnectionsMaksymalna liczba jednoczesnych połączeń klienckich akceptowanych przez detektor http.sys (zero oznacza brak limitu).
OptionsGrupuje różne flagi zachowania serwera: obsługę fragmentów, limity czasu zapisu, strony testowe HTTP i walidację UTF-8.
PortPort TCP, który w połączeniu z Host tworzy URL zastrzeżony przez sterownik http.sys dla serwera.
QueueOptionsSerializuje wychodzące wiadomości przez wewnętrzną kolejkę per-połączenie, zapobiegając rywalizacji między wątkami.
RateLimiterPrzypisuje komponent ogranicznika szybkości, który ogranicza częstotliwość żądań i wiadomości na klienta lub na adres IP.
ReadBufferSizeRozmiar w bajtach bufora odbiorczego przydzielonego dla każdego oczekującego nakładkowego odczytu względem kolejki żądań http.sys.
SecurityOptionsDefiniuje reguły dostępu, takie jak dozwolone źródła dla uzgadniania połączeń WebSocket przeglądarki.
SpecyfikacjeWłącza lub wyłącza specyfikacje protokołu WebSocket akceptowane przez serwer.
SSLWłącza TLS/SSL na odbiorniku http.sys, dzięki czemu klienci mogą łączyć się przy użyciu wss:// lub https://.
SSLOptionsIdentyfikuje wpis magazynu certyfikatów Windows, do którego http.sys wiąże odbiornik przy włączonej obsłudze SSL.
ThreadPoolSizeLiczba wątków roboczych obsługujących kolejkę żądań http.sys przez IOCP.
TimeoutsZastępuje domyślne limity czasu żądań, treści encji, keep-alive i szybkości wysyłania http.sys.
VersionCiąg znaków tylko do odczytu z wersją biblioteki sgcWebSockets osadzoną w pliku binarnym.
WatchDogAutomatycznie restartuje serwer po nieoczekiwanym zamknięciu lub awarii nasłuchiwania.