API でカスタムルールを作成する

ゾーンレベルでカスタムルールを作成するには、Rulesets API を使います。

カスタムルールは、http_request_firewall_custom フェーズのエントリポイントルールセットにデプロイする必要があります。

Terraform を使う場合は、Terraform による WAF カスタムルールの設定を参照してください。

カスタムルールを作成する

ゾーンに custom rule を作成するには、http_request_firewall_custom フェーズのエントリポイントルールセットにルールを追加します。

ゾーンのエントリポイントルールセットを取得する操作を呼び出し、http_request_firewall_custom フェーズのエントリポイントルールセットの定義を取得します。この作業にはゾーン ID が必要です。
エントリポイントルールセットがすでに存在する場合（つまり 200 OK ステータスコードとルールセット定義が返された場合）は、レスポンス内のルールセット ID を控えます。次に、ゾーンルールセットにルールを作成する操作を呼び出し、既存のルールセットに custom rule を追加します。詳細は以降の例を参照してください。
エントリポイントルールセットが存在しない場合（つまり手順 1 で 404 Not Found ステータスコードが返された場合）は、ゾーンルールセットを作成する操作で作成します。rules 配列に custom rule を含めます。例はルールセットの作成を参照してください。

例 A

この例のリクエストは、ID が $ZONE_ID のゾーンの http_request_firewall_custom フェーズのエントリポイントルールセットにルールを追加します。エントリポイントルールセットはすでに存在し、ID は $RULESET_ID です。

新しいルールはルールセットの最後のルールになり、イギリスまたはフランスからのリクエストのうち、攻撃スコア (attack score) が 20 未満のものを Challenge します。

Create a zone ruleset rulebash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/$RULESET_ID/rules" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"description": "My custom rule",
		"expression": "(ip.src.country eq \"GB\" or ip.src.country eq \"FR\") and cf.waf.score lt 20",
		"action": "challenge"
	}'

新しいルールの位置を指定するには、ルールセット内のルールの順序を変更するのガイドラインに従い、リクエストボディに position オブジェクトを含めます。

エントリポイントルールセットを作成し、1 回の API 呼び出しでルールを定義する手順については、フェーズのエントリポイントルールセットにルールを追加するを参照してください。

例 B

新しいルールはルールセットの最後のルールになり、ブロックしたリクエスト向けのカスタムレスポンスを定義します。

Create a zone ruleset rulebash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/$RULESET_ID/rules" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"description": "My custom rule with plain text response",
		"expression": "(ip.src.country eq \"GB\" or ip.src.country eq \"FR\") and cf.waf.score lt 20",
		"action": "block",
		"action_parameters": {
				"response": {
						"status_code": 403,
						"content": "Your request was blocked.",
						"content_type": "text/plain"
				}
		}
	}'

次のステップ

作成したルールを扱うには、Rulesets API の各種操作を使います。よくある作業は次の表を参照してください。

作業手順

ルールセット内のすべてのルールを一覧表示する

作業	手順
ルールセット内のすべてのルールを一覧表示する	`http_request_firewall_custom` フェーズ名を指定して Get a zone entry point ruleset オペレーションを使い、設定済みの custom rules とその ID の一覧を取得します。詳細は特定のルールセットを表示するを参照してください。
ルールを更新する	Update a zone ruleset rule オペレーションを使います。ルールセット ID とルール ID が必要です。これらの ID を取得するには、`http_request_firewall_custom` フェーズ名を指定して Get a zone entry point ruleset オペレーションを使います。詳細はルールセット内のルールを更新するを参照してください。
ルールを削除する	Delete a zone ruleset rule オペレーションを使います。ルールセット ID とルール ID が必要です。これらの ID を取得するには、`http_request_firewall_custom` フェーズ名を指定して Get a zone entry point ruleset オペレーションを使います。詳細はルールセット内のルールを削除するを参照してください。

http_request_firewall_custom フェーズ名を指定して Get a zone entry point ruleset オペレーションを使い、設定済みの custom rules とその ID の一覧を取得します。

詳細は特定のルールセットを表示するを参照してください。

ルールを更新する

Update a zone ruleset rule オペレーションを使います。

ルールセット ID とルール ID が必要です。これらの ID を取得するには、http_request_firewall_custom フェーズ名を指定して Get a zone entry point ruleset オペレーションを使います。

詳細はルールセット内のルールを更新するを参照してください。

ルールを削除する

Delete a zone ruleset rule オペレーションを使います。

詳細はルールセット内のルールを削除するを参照してください。

これらのオペレーションは Ruleset Engine のドキュメントで説明しています。Ruleset Engine は custom rules を含む、さまざまな Cloudflare 製品の基盤です。

API でカスタムルールを作成する

カスタムルールを作成する

例 A

例 B

次のステップ

関連リソース