コンテンツにスキップ

カスタムリスト

カスタムリストには、同じタイプの1つ以上のアイテム(例えば、IPアドレス、ホスト名、またはASN)を含めることができ、ルール式で名前を使ってまとめて参照できます。

Cloudflareは以下のカスタムリストタイプをサポートしています:

各タイプには独自のプロパティとCSVファイル形式があります。詳細については、以下のセクションを参照してください。

Cloudflareによって管理されるリスト(管理されたIPリストなど)についての詳細は、管理リストを参照してください。

カスタムリストの作成

ダッシュボードでリストを作成するか、リストAPIページを参照してください。

カスタムリストの使用

カスタムリストをルールのin演算子とカスタムリストでサポートされているフィールドと共に使用します:

<FIELD> in $<LIST_NAME>

使用できるフィールドはリストアイテムのタイプによって異なります:

リストアイテムタイプ利用可能なフィールド
IPアドレスフィールドにリストされているIPアドレスタイプのフィールド
ホスト名http.host
ASNip.src.asnum

詳細や例については、式でリストを使用するを参照してください。


カスタムリストタイプ

IPアドレスのリスト(IPリスト)

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.com
  • api.example.com
  • *.example.com

しかし、example.com/path/subfolderは有効なエントリではありません。

ホスト名のカスタムリストには、任意の有効なホスト名(有効なFQDN)を追加できます。ホスト名は現在のCloudflareアカウントに属する必要はありません。

CSVファイル形式

ホスト名のカスタムリストにアイテムをCSVファイル経由でアップロードする際は、以下のファイル形式を使用します:

<HOSTNAME_1>,<DESCRIPTION>
<HOSTNAME_2>

<DESCRIPTION>フィールドはオプションです。

ASNのリスト

自律システム番号(ASN)のカスタムリストのリストアイテムは整数値でなければなりません。

例えば、以下のエントリはASNのリストに対して有効です:

  • 1
  • 13335
  • 64512

CSVファイル形式

ASNのカスタムリストにアイテムをCSVファイル経由でアップロードする際は、以下のファイル形式を使用します:

<ASN_1>,<DESCRIPTION>
<ASN_2>

<DESCRIPTION>フィールドはオプションです。