Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

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": ""
	}'

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

役に立ちましたか?