Cloudflare Filters は、ファイアウォールルールの API 専用コンポーネントです。ブール演算子などのロジックで複雑な条件を設計し、受信 HTTP トラフィックを調べて一致を探します。
たとえば、次に一致するフィルターです。
- HTTP ユーザーエージェント、かつ
- HTTP パス、かつ
- 送信元 IP アドレス
フィルターをファイアウォールルールに関連付けると、そのルールの適用範囲を定義できます。
フィルター内で IP リストを使い、複数の IP アドレスをまとめて参照できます。詳細は Lists API を参照してください。
Cloudflare Filters API を使い始める前に、ルールの 式 を確認してください。完全なリファレンスは ルール言語 を参照してください。
Firewall Rules API は、ほとんどの Cloudflare API と次の 2 点で異なります。
- API 呼び出しは複数の項目を受け取り、返し、複数項目へのデータ変更を適用できます。
- API 呼び出しは 標準レスポンス を返しますが、エラーオブジェクトは JSON API の標準 ↗ に従います。エラー時に、どの項目がなぜ失敗したかが分かるようになっています。
はじめに フィルターとは を確認し、続けて Cloudflare Filters の JSON オブジェクト と エンドポイント を参照してください。