HTTPAPI | URL Reservation

HTTP.SYS URL 예약은 Windows 운영 체제의 기능으로, 사용자가 자신의 애플리케이션이나 서비스를 위해 특정 URL(Uniform Resource Locator)을 예약할 수 있게 합니다. HTTP.SYS를 사용하여 URL을 예약하면 운영 체제는 해당 URL에 대한 들어오는 HTTP 요청을 가로채 지정된 애플리케이션이나 서비스로 라우팅합니다.

 

HTTP.SYS를 사용하여 URL을 예약하려면 애플리케이션 또는 서비스가 먼저 HTTP API를 호출하여 URL을 HTTP.SYS 드라이버에 등록해야 합니다. 애플리케이션 또는 서비스는 URL, HTTP 메서드(예: GET, POST) 및 인증 요구 사항과 같은 추가 설정을 지정합니다.

 

URL이 등록되면, HTTP.SYS는 해당 URL에 대한 들어오는 HTTP 요청을 가로채고 URL과 메서드를 기준으로 등록된 애플리케이션 또는 서비스를 조회합니다. 일치하는 애플리케이션 또는 서비스가 발견되면, HTTP.SYS 드라이버는 처리를 위해 해당 애플리케이션 또는 서비스로 요청을 전달합니다.

 

NETSH Commands

URL 등록

이 예제에서는 URL http://example.com:80/ 이 사용자 DOMAIN\user에 대해 등록됩니다. 이를 원하는 URL과 사용자로 대체할 수 있습니다.

 

netsh http add urlacl url=http://example.com:80/ user=DOMAIN\user

 

URL 삭제

이 예제에서는 URL http://example.com:80/이 삭제됩니다. 이를 삭제하려는 URL로 대체할 수 있습니다.

 

netsh http delete urlacl url=http://example.com:80/

 

Show All URLs

이 명령은 시스템에 등록된 모든 URL 예약 목록을 표시합니다.

 

netsh http show urlacl

 

TsgcWebSocketServer_HTTPAPI

HTTP.SYS 서버는 시작될 때 URL을 자동으로 등록합니다. 이는 다음 매개변수와 메서드를 사용하여 수행됩니다.

 

• Host and Port: Host가 비어 있지 않고 Port가 0과 다르면 서버는 URL을 등록하려고 시도합니다. 예제: URL https://127.0.0.1:5000은 다음 속성을 사용하여 등록됩니다
  • Host = '127.0.0.1';
  • Port = 5000
  • SSL = True
• NewBinding: 하나 또는 여러 URL을 등록하려면 이 메서드를 사용하십시오.
  • url https://127.0.0.1:5000 등록 --> NewBinding('127.0.0.1', 5000, '/', True)
  • url http://+:5000/ws/ 등록 --> NewBinding('+', 5000, '/ws/')

 

URL 등록은 다음 경우에 관리자 권한이 필요합니다:

• 포트 번호가 1024 미만임
• 호스트는 ip 주소 대신 와일드카드 "+"입니다.

 

 

서버의 모든 IP 주소에 대해 포트 443을 등록하고 엔드포인트 "/ws/"에서만 수신 대기하되 서버를 관리자 권한으로 실행하고 싶지 않다면 다음 단계를 수행하십시오:

 

• netsh를 사용하여 URL 등록
  • netsh http add urlacl url=https://+:443/ws/ user=DOMAIN\user
• 다음 바인딩으로 서버를 구성합니다.
  • NewBinding('+', 443, '/ws/', True);
• ConfigureSSLCertificate 속성을 비활성화하십시오
  • TsgcWebSocketServer_HTTPAPI.BindingOptions.ConfigureSSLCertificate = false;
• SSL 인증서 구성
  • HTTPAPI Server SSL