← Dokumentace WAF / custom-rules / skip

Příklady API

Použijte Rulesets API ke konfiguraci vlastních pravidel prostřednictvím API.

skip akce podporuje různé možnosti Skip, podle bezpečnostních funkcí nebo produktů, které chcete přeskočit.

Tato stránka obsahuje příklady různých scénářů pravidel přeskočení pro vlastní pravidla. Vezměte v úvahu následující:

• $ZONE_ID hodnota je ID zóny, kam chcete přidat pravidlo.

• $RULESET_ID hodnota je ID vstupní sada pravidel http_request_firewall_custom fáze. Podrobnosti o získání ID této sady pravidel najdete v Výpis a zobrazení sad pravidel. Příklady API na této stránce přidávají přeskakovací pravidlo do existující sady pravidel pomocí Vytvoření pravidla sady pravidel zóny operace.

  Vstupní sada pravidel však ještě nemusí existovat. V takovém případě zavolejte Vytvoření rulesetu zóny operaci k vytvoření vstupní sady pravidel s pravidlem pro přeskočení. Více informací najdete v Vytvoření sady pravidel pro příklad.

• I když každý příklad obsahuje jen jeden parametr akce, ve stejném pravidle můžete použít několik možností skip zadáním ruleset, phases, a products parametry akce současně.

Tento příklad volá Vytvoření pravidla sady pravidel zóny operaci pro přidání pravidla pro přeskočení do stávající http_request_firewall_custom fáze vstupní sady pravidel s ID $RULESET_ID. Pravidlo přeskočí všechna zbývající pravidla v aktuální sadě pravidel u požadavků, které odpovídají výrazu pravidla.

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

Tento příklad volá Vytvoření pravidla sady pravidel zóny operaci pro přidání pravidla do stávající http_request_firewall_custom fáze vstupní sady pravidel s ID $RULESET_ID. Pravidlo přeskočí http_ratelimit fáze u požadavků odpovídajících výrazu pravidla.

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

Viz Dostupné možnosti přeskočení se seznamem fází, které můžete přeskočit.

Tento příklad volá Vytvoření pravidla sady pravidel zóny operaci pro přidání pravidla, které:

• Přeskočí http_ratelimit fáze
• Vypne logování událostí pro aktuální pravidlo

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

Viz Dostupné možnosti přeskočení s dalšími informacemi o vypnutí protokolování požadavků odpovídajících pravidlu skip.

Tento příklad používá Vytvoření pravidla sady pravidel zóny operaci pro přidání pravidla, které přeskočí Zone Lockdown a Blokování User Agent produkty pro požadavky odpovídající výrazu pravidla.

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

Viz Dostupné možnosti přeskočení se seznamem produktů, které můžete přeskočit.

Tento příklad volá Vytvoření pravidla sady pravidel zóny operaci pro přidání pravidla pro přeskočení do stávající http_request_firewall_custom fáze vstupní sady pravidel s ID $RULESET_ID. Pravidlo přeskočí všechna zbývající pravidla v http_request_firewall_custom fáze u požadavků odpovídajících výrazu pravidla.

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

Tato možnost přeskočení je v současné době dostupná pouze na úrovni zóny. Podívejte se na Dostupné možnosti přeskočení pro další podrobnosti.