コンテンツにスキップ

Cloudflare フィルター API

Cloudflare フィルターは、受信する HTTP トラフィックを調査し、一致を探すためにブール演算子やその他のロジックに依存する複雑な基準を設計するためのファイアウォールルールの API 専用コンポーネントです。

例えば、次の条件に一致するフィルター:

  • HTTP ユーザーエージェント、および
  • HTTP パス、および
  • ソース IP アドレス

フィルターをファイアウォールルールに関連付けて、そのルールの範囲を定義します。

フィルター内で IP リストを使用して、IP アドレスのグループをまとめて参照します。詳細については、リスト APIを参照してください。

Cloudflare フィルター API を始める前に、ルールのに慣れておいてください。完全なリファレンスについては、ルール言語を参照してください。

他の Cloudflare API との違い

ファイアウォールルール API は、次の2つの点でほとんどの Cloudflare API とは異なります:

  • API 呼び出しは複数のアイテムを受け入れ、返し、複数のアイテムにデータ変更を適用することを許可します。
  • API 呼び出しは標準レスポンスを返しますが、エラーオブジェクトはJSON API 標準に従い、エラー条件においてどのアイテムがエラーを引き起こしたのか、そしてその理由が明確になります。

始めるには、フィルターとは何か?を確認し、その後に Cloudflare フィルターのJSON オブジェクトエンドポイントを確認してください。