Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

API の例

最終更新 Markdown で表示Agent セットアップ

Rulesets API を使って、API からカスタムルールを設定します。

skip アクションは、スキップしたいセキュリティ機能やプロダクトに応じて、複数の スキップオプション をサポートします。

始める前に

このページでは、カスタムルールのスキップルールをシナリオ別に示します。次の点に注意してください。

現在のルールセットの残りのルールをスキップする

この例は、ゾーンルールセットにルールを作成する 操作を呼び出し、既存の http_request_firewall_custom フェーズのエントリポイントルールセット（ID は $RULESET_ID）にスキップルールを追加します。ルール式に一致するリクエストでは、現在のルールセットの残りのルールをすべてスキップします。

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 '{
		"action": "skip",
		"action_parameters": {
				"ruleset": "current"
		},
		"expression": "http.request.uri.path contains \"/skip-current-ruleset/\"",
		"description": ""
	}'

フェーズをスキップする

この例は、ゾーンルールセットにルールを作成する 操作を呼び出し、既存の http_request_firewall_custom フェーズのエントリポイントルールセット（ID は $RULESET_ID）にルールを追加します。ルール式に一致するリクエストでは、http_ratelimit フェーズをスキップします。

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 '{
		"action": "skip",
		"action_parameters": {
				"phases": [
						"http_ratelimit"
				]
		},
		"expression": "http.request.uri.path contains \"/skip-phase/\"",
		"description": ""
	}'

スキップできるフェーズの一覧は、利用できるスキップオプション を参照してください。

フェーズをスキップし、一致したリクエストをログに記録しない

この例は、ゾーンルールセットにルールを作成する 操作を呼び出し、次のルールを追加します。

  • http_ratelimit フェーズをスキップする
  • 現在のルールのイベントログを無効にする
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 '{
		"action": "skip",
		"action_parameters": {
				"phases": [
						"http_ratelimit"
				]
		},
		"logging": {
				"enabled": false
		},
		"expression": "http.request.uri.path contains \"/disable-logging/\"",
		"description": ""
	}'

スキップルールに一致したリクエストのログを無効にする方法は、利用できるスキップオプション を参照してください。

セキュリティ製品をスキップする

この例は、ゾーンルールセットにルールを作成する 操作を使い、ルール式に一致するリクエストに対して Zone Lockdown と User Agent Blocking をスキップするルールを追加します。

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 '{
		"action": "skip",
		"action_parameters": {
				"products": [
						"zoneLockdown",
						"uaBlock"
				]
		},
		"expression": "http.request.uri.path contains \"/skip-products/\"",
		"description": ""
	}'

スキップできるプロダクトの一覧は、利用できるスキップオプション を参照してください。

現在のフェーズの残りのルールをスキップする

この例は、ゾーンルールセットにルールを作成する 操作を呼び出し、既存の http_request_firewall_custom フェーズのエントリポイントルールセット（ID は $RULESET_ID）にスキップルールを追加します。ルール式に一致するリクエストでは、http_request_firewall_custom フェーズの残りのルールをすべてスキップします。

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 '{
		"action": "skip",
		"action_parameters": {
				"phase": "current"
		},
		"expression": "http.request.uri.path contains \"/skip-current-ruleset/\"",
		"description": ""
	}'

現在、このスキップオプションはゾーンレベルでのみ利用できます。詳細は 利用できるスキップオプション を参照してください。

役に立ちましたか？