注記
URLリストを作成するには、 Netskope Secure Web Gatewayライセンスが必要です。
URLリストはカスタムカテゴリの構成要素であり、特定のURLに対してNetskopeの事前定義されたURLカテゴリマッピングを上書きできる柔軟性を提供します。URLリストを作成するには、フォーマットを選択し、目的のURLを入力してください。URLリストを保存したら、それをカスタムカテゴリに追加して、包含または除外する項目として設定します。詳細については、 「カスタムカテゴリ」を参照してください。
開始する前に、ポリシー スキャンに含める URL のリストを作成し、必要に応じて、ポリシー スキャンから除外する URL のリストも作成してください。UI に URL を個別に入力するか、すべての URL を含む CSV ファイルを作成するか、 REST API V2を使用できます。 この手順を完了したら、ポリシーに適用するURLリスト用のカスタムカテゴリを作成する必要があります。
重要
URLリストの機能強化は、リアルタイム保護ポリシー、SSL復号化ポリシー、ステアリング例外、およびREST API V2に適用されます。コンタクト アカウントでこれらの拡張機能を有効にするためのサポート。
URLリストの設定
URLリストを作成するには：
- Policies > Profiles > URL Listsへ移動してください。
- New URL Listをクリックしてください。
- New URL Listウィンドウに、URL リストの名前を入力してください。
- URL Typeについては、URL リストの形式 ( ExactまたはRegex ) を選択してください。デフォルトの動作は完全一致です。
- URL & IP Addressについては、URL または IP アドレスを手動で入力できます。Regex URL Typeとして選択した場合、URLマッチング用の正規表現を入力できます。
- または、CSVファイルをアップロードすることもできます（最大アップロードサイズは8MBです）。
注記
URLリストの作成に関する詳細については、 「URLリストのベストプラクティス」を参照してください。
URLを追加する際は、完全一致のURLを入力するか、ワイルドカードURLを入力することができます。URLにポート番号を指定することもできます。URLを追加する際は、書式設定ルールに従ってください。
| URL Format | 一致したURL |
|---|---|
| www.example.com/path/to/resource | www.example.com/path/to/resource/a www.example.com/path/to/resource/a/b |
| example.com | example.com/ example.com/path/a |
| www.example.com | www.example.com www.example.com/path/a www.example.com/some/path www.example.com/query?a=b http://www.example.com https://www.example.com http://www.example.com:80 https://www.example.com:443 |
| *.example.com | example.com www.example.com www.us.example.com www.uk.example.com |
| www.example.com:8080 | http://www.example.com:8080 https://www.example.com:8080 |
| www.example.com:80 | http://www.example.com https://www.example.com:80 http://www.example.com:80 |
| www.example.com:443 | https://www.example.com https://www.example.com:443 http://www.example.com:443 |
| www.example.com/path/*/ | サポートされていません |
| www.example.com/* www.example.com/path/* | サポートされていません |
ワイルドカードドメイン（例：*.example.com）ルートドメインとすべてのサブドメインを含めます。URL リストに 2 つ以上のワイルドカードエントリ、サブドメイン、パスが存在する場合、 Netskopeサービスは 分類のために最長のエントリを使用します。
IPアドレスを追加する際は、IPアドレスの範囲とCIDR表記のIPアドレスを追加できます。標準以外のポートを追加する場合は、一致するポート番号を定義する必要があります。
ヒント
宛先IPアドレスのURLリストを作成する際には、以下の点を考慮してください。
- 宛先IPアドレスに対してリアルタイム保護ポリシーを作成する際に、 SSL復号化拒否ポリシーも作成できます。ただし、リアルタイム保護ポリシーのアクションが「ブロック」の場合、SSLインターセプトなしでアクティビティがブロックされます。つまり、ユーザーが宛先IPアドレスにアクセスした際に、ブロックページは表示されなくなります。
- SSL インターセプトを使用してアクティビティをブロックするには、SSL ポリシーを使用せずにリアルタイム保護ポリシーのみを作成する必要があります。
- 宛先IPアドレスのURLリストを作成する場合、 「SNIエラーなし」の設定オプションは利用できません。これは、ユーザーが宛先IPアドレスにアクセスする際にはSNIが存在しないためです。
APIエンドポイント
次の API エンドポイントは、REST API V2 の URL リストで使用できます。
注記
REST API V2 は URL リストの機能強化の一部です。アカウントでこの機能を有効にするためのコンタクト サポートが必要です。
| Endpoint | デスクリプション |
|---|---|
| /api/v2/ポリシー/urllist を取得します | 適用済みおよび保留中のすべてのURLリストを取得します |
| POST /api/v2/ポリシー/urllist | 新しい URL リストを作成します |
| POST /api/v2/ポリシー/urllist/file | JSONファイルを介して複数の設定をアップロードします |
| /api/v2/ポリシー/urllist/{id} を取得します | IDでURLリストを取得します |
| PUT /api/v2/ポリシー/urllist/{id} | URLリストの設定を置き換えます |
| /api/v2/ポリシー/urllist/{id} を削除してください | URLリストを削除します |
| PATCH /api/v2/ポリシー/urllist/{id}/{action} | URLリストをパッチします |
| POST /api/v2/ポリシー/urllist/deploy | 保留中のURL変更リストを適用します |
Example:
特定のURLリストからフィールドを指定して、URLリストをクエリできます。特定のフィールドを照会するには 次のクエリを使用します。
GET http://<tenant-URL>/api/v2/policy/urllist?field=id,name
利用可能なフィールド／クエリパラメータは以下のとおりです。
- Id
- name
- data
- pending
- modify_time
- modify_type
- modify_by
注記
REST APIは使うで既存のURLリストに追加できますが、新しいURLリストを作成することはできません。 詳細については、 「URL リストの更新」を参照してください。