カスタムリスト
カスタムリストには、同じタイプの1つ以上のアイテム(例えば、IPアドレス、ホスト名、またはASN)を含めることができ、ルール式で名前を使ってまとめて参照できます。
Cloudflareは以下のカスタムリストタイプをサポートしています:
- IPアドレスのリスト(IPリストとも呼ばれます)
- ホスト名のリスト
- ASNのリスト(自律システム ↗番号)
各タイプには独自のプロパティとCSVファイル形式があります。詳細については、以下のセクションを参照してください。
Cloudflareによって管理されるリスト(管理されたIPリストなど)についての詳細は、管理リストを参照してください。
ダッシュボードでリストを作成するか、リストAPIページを参照してください。
カスタムリストをルールの式でin演算子とカスタムリストでサポートされているフィールドと共に使用します:
<FIELD> in $<LIST_NAME>使用できるフィールドはリストアイテムのタイプによって異なります:
| リストアイテムタイプ | 利用可能なフィールド |
|---|---|
| IPアドレス | フィールドにリストされているIPアドレスタイプのフィールド |
| ホスト名 | http.host |
| ASN | ip.src.asnum |
詳細や例については、式でリストを使用するを参照してください。
IPアドレスのカスタムリストのリストアイテムは、以下のいずれかの形式でなければなりません:
- 個別のIPv4アドレス
- プレフィックスが
/8から/32のIPv4 CIDR範囲 - プレフィックスが
/4から/64のIPv6 CIDR範囲
個別のアドレスとCIDR範囲を同じリストに組み合わせることができます。
リスト内のIPv6アドレスには大文字または小文字の文字を使用できます。ただし、リストを保存するときに大文字は小文字に変換されます。
CSVファイル形式
IPアドレスのカスタムリストにアイテムをCSVファイル経由でアップロードする際は、以下のファイル形式を使用します(1行に1アイテムを入力):
<IP_ADDRESS_1>,<DESCRIPTION><IP_ADDRESS_2><DESCRIPTION>フィールドはオプションです。
ホスト名のカスタムリストのリストアイテムは、完全修飾ドメイン名(FQDN)でなければなりません。アイテムには*プレフィックス/サブドメインワイルドカードを含めることができ、これは.(ピリオド)に続かなければなりません。アイテムにはスキーム(例えば、https://)やURLパスを含めることはできません。
例えば、以下のエントリはホスト名のカスタムリストに対して有効です:
example.comapi.example.com*.example.com
しかし、example.com/path/subfolderは有効なエントリではありません。
ホスト名のカスタムリストには、任意の有効なホスト名(有効なFQDN)を追加できます。ホスト名は現在のCloudflareアカウントに属する必要はありません。
CSVファイル形式
ホスト名のカスタムリストにアイテムをCSVファイル経由でアップロードする際は、以下のファイル形式を使用します:
<HOSTNAME_1>,<DESCRIPTION><HOSTNAME_2><DESCRIPTION>フィールドはオプションです。
自律システム番号(ASN)のカスタムリストのリストアイテムは整数値でなければなりません。
例えば、以下のエントリはASNのリストに対して有効です:
11333564512
CSVファイル形式
ASNのカスタムリストにアイテムをCSVファイル経由でアップロードする際は、以下のファイル形式を使用します:
<ASN_1>,<DESCRIPTION><ASN_2><DESCRIPTION>フィールドはオプションです。