HTTP WebリクエストのURLの報告（クラシック）

Webおよびクラウド製品を購入した場合、エンドユーザーが指定したドメイン名のグループに向けたHTTPウェブリクエストのURLを送信するように、Collectorを設定できます。デフォルトでは、Collectorはネットワークトラフィックの生成量を低く抑え、エンジンを多数のURLであふれさせないために、各ウェブリクエスト内のドメイン名だけをエンジンに報告します（完全なURLは報告しません）。しかし、限定されたウェブリクエストのURLだけを報告する場合でも、生成されるトラフィックは依然として合理的な低さを保ちます。特定のURLパスに基づいてサービスを定義したり、URLの条件を含む調査を行うといった追加情報を活用することが可能です。

この章では、エンドユーザーのデバイスからそれらのHTTPリクエストが向けられるドメイン名のリストを特定する方法を探ります。

ドメインリストの受け入れられる構文

Collectorの設定に選ばれた方法に関係なく、ドメイン指定の受け入れられる構文は同じです。ドメイン名を記述するための許可された文字は、次を含むASCII文字セットのサブセットです。

aからzおよびAからZまでの範囲の文字。
0から9までの数字。
シンボル**.（ドット）と-**（ハイフン）。
シンボル**:（コロン）と/**（スラッシュ）。
シンボル*****（アスタリスク）を使用し、ゼロまたは複数の文字を代替します。

次の表には、ドメイン名の例とCollectorによる解釈の方法が含まれています。

www.example.com

www.example.comに向けたすべてのHTTPリクエストと一致します。

[Workflows APIの概要](http://www.example.com)

上記と同様: www.example.comに向けたHTTPリクエストと一致します。

www.example.com

www.example.comに向けたすべてのHTTPリクエストと一致します。

[Workflows APIの概要](http://example.com/index.html)

www.example.comと同じように一致します（ホスト名の後のURLパスは無視されます）。

*.example.com

最初のドットの前に任意のプレフィックスがあるもの（例: www.example.com、ftp.example.com、www.example.com、ただしanother-example.comは除く）と一致します。

*example.com

任意のプレフィックスとの一致（例: www.example.com、ftp.example.com、www.example.com、another-example.com）

***example.com

上記と同じ（連続する複数のアスタリスクは1つとしてカウントされます）。

ftp.example.com

ftp.example.comに向けたすべてのHTTPリクエストと一致します（プロトコルはHTTPであり、FTPではありません）。

ftp://ftp.example.com

エラー: 許可されているのはHTTPスキームのみです。

https://example.comを参照してください

エラー: 許可されているのはHTTPスキームのみです。

-example.com

エラー: ドメイン名はハイフンで始めたり終わったりすることはできません。

エラー: "全てに一致"するアスタリスクパターンは単独では許可されていません。

Collectorにおけるドメインリストの設定

Collectorを展開する前または後に、CollectorがウェブリクエストのURLを報告するドメインリストを指定します。

Collectorの展開前:
- MSIにパラメーターを渡します。
- Nexthink Collectorインストーラーを使用します。
Collectorの展開後:
- Nexthink Collector構成ツールを使用します。
- レジストリキーの値を変更します。

Updaterを使用してCollectorを展開する場合、MSIの多くのパラメーター、および特にドメインリストは、インストール時に設定できず、更新間で保存されません。 Collectorの自動更新ごとに、展開後に設定を再適用する必要があります。

MSIにパラメーターを渡す

CollectorをMSIファイルを使用してインストールする際に、パラメーターDRV_WEB_AND_CLOUD_HOSTSの値を設定して、ドメイン名のリストを指定します。供給される値は、前のセクションで定義された構文によるカンマ区切りのドメインリストでなければなりません。

このオプションを利用するためには、Collectorがウェブ関連情報を収集するためにパラメーターDRV_WEB_AND_CLOUD_DATAを1（デフォルト値）に設定する必要があります。

Nexthink Collectorインストーラーを使用する

CollectorをNexthink Collectorインストーラーで展開する場合、「設定」ボタンをクリックした際に表示される「Webおよびクラウド設定」ダイアログボックスで、完全なURLを取得したいドメインリストを指定します。

Collectorを更新している場合、新しい設定が以前に設定されたドメインリストを置き換えます。

Nexthink Collector構成ツールを使用する

すでにCollectorを展開している場合、特定のデバイスからアクセスされた完全なURLを報告するドメインリストを変更するには、Nexthink Collector構成ツールを使用してください。このツールは、デバイスに存在する必要があります。これはデフォルトでCollectorとともにインストールされますが、MSIオプションCFG_INSTALLを0に設定しなければなりません。

管理者権限でツールを実行し、ドメインリストをコマンドラインのパラメーターとして、カンマで区切って指定してください。

C:\Windows\System32\nxtcfg.exe /s wm_domains="csv_list_of_domains"

レジストリキーの値を設定する

完全なURLを報告するためのドメインリストは、次の場所のレジストリに保存されます：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\nxtrdrv\params\hosts

この変数の値を変更すると、Collectorはその変更を検出し、変更を適用します。ドメインの構文にエラーが検出された場合、そのエラーはログに記録されますが、サービスはリスト内の次のドメインに進むだけです。高負荷下では、Collectorが環境変数の変更を見逃す可能性があります。変更を強制するために再起動が必要です。このため、この方法はプレプロダクション環境でのテストにのみ推奨されます。

デバッグ目的で、この場合にのみ"全てに一致"するアスタリスクパターン*****を使用することが許可されます。これはルールの唯一の例外であり、特定のデバイスでの接続性問題を検出するのに役立つ可能性があります。

技術的およびセキュリティの制限

記載されているどの方法を使用しても、最大20ドメインまで指定できます。 Collectorは、URLの長さを最大1024文字までに制限します。 1024文字を超えるURLを処理する稀なケースでは、Collectorはそれを最初の1024文字に切り詰めます。

この機能は、HTTPリクエストでのみ使用でき、HTTPSリクエストでは使用できないことに注意してください。 TLS暗号化のため、HTTPSリクエストのURLを取得することはできません。さらに、HTTPSリクエストの正確なURLを報告することで、セキュリティやプライバシーの侵害が発生する可能性があります。

同様に、CollectorはURLのクエリ文字列部分（すなわち、ウェブアプリケーションが使用するオプションのパラメーターリストを、URLの末尾に追加するもの）は決して報告しません。クエリ文字列には、ログイン名やパスワードなどの機密情報が含まれることが多いです。