HTTPAPI | URL 予約

HTTP.SYS URL 予約は Windows オペレーティングシステムの機能で、ユーザーがアプリケーションやサービスのために特定の URL を予約できます。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/

 

すべての URL を表示

このコマンドは、システム上のすべての登録済み URL 予約のリストを表示します。

 

netsh http show urlacl

 

TsgcWebSocketServer_HTTPAPI

HTTP.SYS サーバーは起動時に自動的に URL を登録します。これは以下のパラメータとメソッドを使用して行われます。

 

• Host と Port: Host が空でなく、Port がゼロでない場合、サーバーは URL を登録しようとします。例: URL https://127.0.0.1:5000 は次のプロパティを使用して登録されます
  • Host = '127.0.0.1';
  • Port = 5000
  • SSL = True
• NewBinding: このメソッドを使用して1つまたは複数の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 アドレスの代わりにワイルドカード "+" です。

 

 

ポート 443 をサーバーのすべての IP アドレスに登録し、エンドポイント「/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 サーバー SSL