HTTPウェブリクエストのURLの報告（クラシック）

Webとクラウド製品を購入した場合、エンドユーザーが選択したドメイン名グループにアドレスを振るHTTPウェブリクエストのURLをCollectorが送信するように設定できます。デフォルトでは、各ウェブリクエストに対して、Collectorはリクエスト内のドメイン名のみをEngineに報告し（完全なURLではなく）、生成されるネットワークトラフィック量を抑え、URL過多の問題を防ぎます。ただし、Collectorが少数のウェブリクエストのURLを報告する許可を得ている場合でも、トラフィックは依然として低く抑えられ、この追加情報を利用して特定のURLパスに基づくサービスを定義したりURL条件による調査を行ったりできます。

本章では、エンドユーザーのデバイスからアドレスを振るHTTPリクエストからCollectorがURLを報告する必要があるドメイン名リストを指定する方法を探ります。

受理可能なドメインの構文

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

上記同様（連続する複数のアスタリスクは一つとカウントされます）

ftp.example.com

ftp.example.comにアドレスを振る全HTTPリクエストにマッチします(プロトコルはHTTPであり、FTPではありません)

ftp://ftp.example.com

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

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

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

-example.com

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

エラー: 完全合致アスタリスクパターンは単独で許可されていません

Collectorでドメインリストを設定

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

Collectorを展開する前：
- パラメーターをMSIに渡します。
- Nexthink Collectorインストーラを使用します。
Collectorを展開した後：
- Nexthink Collector Configuration Toolを使用します。
- レジストリキーの値を変更します。

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

パラメーターをMSIに渡す

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

このオプションを使ってCollectorがウェブ関連情報を収集するには、パラメーター DRV_WEB_AND_CLOUD_DATA が1(デフォルト値)に設定されている必要があります

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

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

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

Nexthink Collector Configuration Toolを使用する

Collectorを既に展開している場合、Nexthink Collector Configuration Toolを使用して、特定のデバイスからアクセスされる完全なURLを報告するためのドメインのリストを変更します。この操作には、デバイスにNexthink Collector Configuration Toolが存在する必要があります。これは、デフォルトで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の_query string_部分を決して報告しません。これは、ウェブアプリケーションによく使用されるパラメーターのリストで、URLの最後に?を付けます。クエリ文字列は、ログイン名やパスワードなどの機密情報を含むことがよくあります。