TsgcWebSocketServer_HTTPAPI › 속성

TsgcWebSocketServer_HTTPAPI 속성

용도별로 그룹화된 published 속성과 그에 이어지는 전체 알파벳순 목록.

연결

Name설명
Active구성된 URL을 Windows 커널 드라이버에 등록하여 HTTP.sys 리스너를 시작하거나 중지합니다.
Hosthttp.sys 드라이버에 등록된 URL을 빌드하는 데 사용되는 hostname 또는 IP 주소.
PortHost와 결합하여 http.sys 드라이버가 서버를 위해 예약하는 URL을 형성하는 TCP 포트입니다.
BindingOptionsURL 예약과 SSL 인증서가 시작 시 http.sys 드라이버에 등록되는 방법을 세밀하게 조정합니다.
MaxConnectionshttp.sys 리스너가 수락하는 최대 동시 클라이언트 연결 수(0은 무제한을 의미).

Timeouts

Name설명
Timeouts기본 http.sys 요청, entity-body, keep-alive, send-rate 시간 초과를 재정의합니다.

Security

Name설명
Authentication들어오는 WebSocket 및 HTTP 요청에 대한 사용자/비밀번호 인증을 활성화하고 구성합니다.
SSLhttp.sys 리스너에서 TLS/SSL을 활성화하여 클라이언트가 wss:// 또는 https://를 사용하여 연결할 수 있도록 합니다.
SSLOptionsSSL이 활성화될 때 http.sys가 리스너에 바인딩하는 Windows Certificate Store 항목을 식별합니다.
SecurityOptions브라우저 WebSocket 핸드셰이크에 허용되는 origin과 같은 승인 규칙을 정의합니다.
APIKeyManager연결을 수락하기 전에 들어오는 API 키를 검증하는 데 사용되는 선택적 API 키 관리자 구성 요소입니다.

안정성

Name설명
HeartBeat유휴 WebSocket 연결을 활성 상태로 유지하고 죽은 피어를 감지하기 위해 주기적인 ping 프레임을 보냅니다.
WatchDog예기치 않은 종료 또는 리스너 실패 후 서버를 자동으로 다시 시작합니다.
Firewall들어오는 연결을 IP, 지역 또는 사용자 지정 규칙으로 필터링하는 방화벽 구성 요소를 할당합니다.
RateLimiter클라이언트별 또는 IP별로 요청 및 메시지 속도를 제한하는 rate-limiter 구성 요소를 할당합니다.

성능

Name설명
Asynchronousfire-and-forget 전송을 활성화합니다: 호출자는 즉시 반환되고 완료는 OnAsynchronous 이벤트를 통해 신호됩니다.
MaxBandwidth모든 연결에 걸친 최대 허용 대역폭(초당 바이트)입니다(0은 무제한을 의미함).
ThreadPoolSizeIOCP를 통해 http.sys 요청 큐를 제공하는 worker 스레드 수입니다.
ReadBufferSizehttp.sys 요청 큐에 대한 대기 중인 오버랩 읽기마다 할당되는 수신 버퍼의 바이트 단위 크기입니다.
FineTunehttp.sys가 요청을 대기열에 넣고, 디스패치하고, 완료하는 방식을 형성하는 저수준 커널 모드 설정입니다.

HTTP

Name설명
HTTPUploadFilesHTTP POST를 통해 업로드된 파일이 어떻게 버퍼링되고(메모리 또는 파일 스트림) 디스크에 저장되는지 제어합니다.

고급

Name설명
Options기타 서버 동작 플래그를 묶습니다: 프래그먼트 처리, write timeout, HTTP 테스트 페이지, UTF-8 검증.
QueueOptions스레드 간 경합을 방지하기 위해 내부 연결별 큐를 통해 발신 메시지를 직렬화합니다.
Extensions메시지별 deflate 압축과 같은 WebSocket 프로토콜 확장을 구성합니다.
Specifications서버가 수락할 WebSocket 프로토콜 사양을 활성화하거나 비활성화합니다.

진단

Name설명
LogFile디버깅 및 감사를 위해 수신 및 발신 소켓 메시지를 로그 파일에 작성합니다.
Version바이너리에 임베드된 sgcWebSockets 라이브러리 버전이 있는 읽기 전용 문자열.

All Properties (alphabetical)

Name설명
Active구성된 URL을 Windows 커널 드라이버에 등록하여 HTTP.sys 리스너를 시작하거나 중지합니다.
APIKeyManager연결을 수락하기 전에 들어오는 API 키를 검증하는 데 사용되는 선택적 API 키 관리자 구성 요소입니다.
Asynchronousfire-and-forget 전송을 활성화합니다: 호출자는 즉시 반환되고 완료는 OnAsynchronous 이벤트를 통해 신호됩니다.
Authentication들어오는 WebSocket 및 HTTP 요청에 대한 사용자/비밀번호 인증을 활성화하고 구성합니다.
BindingOptionsURL 예약과 SSL 인증서가 시작 시 http.sys 드라이버에 등록되는 방법을 세밀하게 조정합니다.
Extensions메시지별 deflate 압축과 같은 WebSocket 프로토콜 확장을 구성합니다.
FineTunehttp.sys가 요청을 대기열에 넣고, 디스패치하고, 완료하는 방식을 형성하는 저수준 커널 모드 설정입니다.
Firewall들어오는 연결을 IP, 지역 또는 사용자 지정 규칙으로 필터링하는 방화벽 구성 요소를 할당합니다.
HeartBeat유휴 WebSocket 연결을 활성 상태로 유지하고 죽은 피어를 감지하기 위해 주기적인 ping 프레임을 보냅니다.
Hosthttp.sys 드라이버에 등록된 URL을 빌드하는 데 사용되는 hostname 또는 IP 주소.
HTTPUploadFilesHTTP POST를 통해 업로드된 파일이 어떻게 버퍼링되고(메모리 또는 파일 스트림) 디스크에 저장되는지 제어합니다.
LogFile디버깅 및 감사를 위해 수신 및 발신 소켓 메시지를 로그 파일에 작성합니다.
MaxBandwidth모든 연결에 걸친 최대 허용 대역폭(초당 바이트)입니다(0은 무제한을 의미함).
MaxConnectionshttp.sys 리스너가 수락하는 최대 동시 클라이언트 연결 수(0은 무제한을 의미).
Options기타 서버 동작 플래그를 묶습니다: 프래그먼트 처리, write timeout, HTTP 테스트 페이지, UTF-8 검증.
PortHost와 결합하여 http.sys 드라이버가 서버를 위해 예약하는 URL을 형성하는 TCP 포트입니다.
QueueOptions스레드 간 경합을 방지하기 위해 내부 연결별 큐를 통해 발신 메시지를 직렬화합니다.
RateLimiter클라이언트별 또는 IP별로 요청 및 메시지 속도를 제한하는 rate-limiter 구성 요소를 할당합니다.
ReadBufferSizehttp.sys 요청 큐에 대한 대기 중인 오버랩 읽기마다 할당되는 수신 버퍼의 바이트 단위 크기입니다.
SecurityOptions브라우저 WebSocket 핸드셰이크에 허용되는 origin과 같은 승인 규칙을 정의합니다.
Specifications서버가 수락할 WebSocket 프로토콜 사양을 활성화하거나 비활성화합니다.
SSLhttp.sys 리스너에서 TLS/SSL을 활성화하여 클라이언트가 wss:// 또는 https://를 사용하여 연결할 수 있도록 합니다.
SSLOptionsSSL이 활성화될 때 http.sys가 리스너에 바인딩하는 Windows Certificate Store 항목을 식별합니다.
ThreadPoolSizeIOCP를 통해 http.sys 요청 큐를 제공하는 worker 스레드 수입니다.
Timeouts기본 http.sys 요청, entity-body, keep-alive, send-rate 시간 초과를 재정의합니다.
Version바이너리에 임베드된 sgcWebSockets 라이브러리 버전이 있는 읽기 전용 문자열.
WatchDog예기치 않은 종료 또는 리스너 실패 후 서버를 자동으로 다시 시작합니다.