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

Webおよびクラウド製品を購入した場合、エンドユーザーが選択した一部のドメイン名にアドレスするHTTPウェブリクエストのURLをコレクターが送信するように設定できます。デフォルトでは、コレクターは生成されるネットワークトラフィックを抑え、エンジンにURIがあふれないようにするため、ウェブリクエストごとにエンジンに報告するのは要求内のドメイン名のみであり、フルURLではありません。しかしながら、いくつかのウェブリクエストのURLが報告される場合でも、生成されるトラフィックは依然として適度に低いままで、特定のURLパスに基づくサービスを定義するか、URL条件を取り入れた調査を行う際にこの追加情報を利用できます。

この章では、エンドユーザーのデバイスからアドレスされるHTTPリクエストのURLを報告すべきドメイン名のリストを指定する方法を考察します。

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

コレクターを構成するために選択されたメソッドに関係なく、ドメインを指定するための構文は同一です。書き込みに使用できるドメイン名の文字は、ASCII文字セットのサブセットになります。

アルファベットは、aからzおよびAからZの範囲です。
数字は、0から9までの範囲です。
シンボルは .（ドット）と -（ハイフン）です。
シンボルは :（コロン）と**/**（スラッシュ）です。
シンボル *（アスタリスク）で、0個以上の文字を置き換えできます。

以下の表には、ドメイン名の例とそれに対するコレクターによる解釈が含まれています。

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

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

エラー: 単独ですべて一致するためのアスタリスクパターンは許可されていません

コレクターにおけるドメインリストの構成

コレクターが報告するウェブリクエストのURLに対し、ドメインのリストをデプロイ前にも後にも指定することができます。

コレクターをデプロイする前に:
- MSIにパラメータを渡す。
- Nexthink Collector Installerを使用。
コレクターをデプロイした後に:
- Nexthink Collector Configuration Toolを使用。
- レジストリキーの値を変更する。

アップデーターを使用してコレクターをデプロイする場合、特にMSIの多くのパラメータやドメインのリストはインストール時に設定できず、アップデート間で保持されません。コレクターのすべての自動更新ごとに、デプロイ後に設定を再適用する必要があります。

MSIにパラメータを渡す

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

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

Nexthink Collector Installerを使用

Nexthink Collector Installerを使用してコレクターをデプロイする場合、設定ボタンをクリックすると表示されるWeb And Cloud Settingsダイアログボックスで、フルURLを取得したいドメインのリストを指定します。

コレクターを更新する場合、新しい設定は以前に構成されていたドメインのリストを置き換えます。

Nexthink Collector Configuration Toolを使用

すでにコレクターをデプロイしている場合、特定のデバイスからアクセスされるフルURLを報告するためのドメインリストを変更するには、Nexthink Collector Configuration Toolを使用してください。これは、デバイスにNexthink Collector Configuration Toolが存在することを必要としますが、デフォルトではコレクターとともにインストールされますが、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 下に保存されます。

この変数の値を変更した場合、コレクターはその変更を検出し、変更を適用します。ドメインの構文にエラーが検出された場合、そのエラーが記録されますが、サービスはリストの次のドメインに進むだけです。高負荷状態では、コレクターが環境変数の変更を見逃す可能性があり、変更を強制するためには再起動が必要です。このため、この方法は試験的な前生産環境でのみ推奨されます。

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

技術的および安全性の制限

説明された方法のいずれかを使用して、最大20個のドメインを指定できます。コレクターは、URLの長さを最大1024文字に制限します。 1024文字を超えるURL を処理するまれなケースでは、コレクターは最初の1024文字に切り詰めます。

この機能はHTTPSウェブリクエスト向けではなく、HTTPのみに使用可能です。 TLS暗号化のため、HTTPSリクエストのURLを取得することはできません。また、HTTPSリクエストの正確なURLを報告すると、セキュリティやプライバシーの侵害につながる可能性があります。

同様の理由から、コレクターはURLのクエリストリング部分（つまり、Web アプリケーションが後に続けるパラメーターリスト）を報告しません。クエリストリングは、ログイン名やパスワードなどの機密情報を運ぶことが多いです。