← Dokumentace WAF / custom-rules / skip

Příklady API

Použijte Rulesets API ke konfiguraci vlastních pravidel přes API.

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

Tato stránka obsahuje příklady různých scénářů skip pravidel pro vlastní pravidla. Berte v úvahu následující:

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

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

  Entry point ruleset však ještě nemusí existovat. V takovém případě vyvolejte Vytvoření sady pravidel zóny operaci k vytvoření entry point rulesetu se skip pravidlem. Viz Create ruleset pro příklad.

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

Tento příklad volá Vytvoření pravidla v sadě pravidel zóny operaci k přidání skip pravidla do existující http_request_firewall_custom (entry point ruleset fáze) s ID $RULESET_ID. Pravidlo přeskočí všechna zbývající pravidla v aktuální sadě 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": {
				"ruleset": "current"
		},
		"expression": "http.request.uri.path contains \"/skip-current-ruleset/\"",
		"description": ""
	}'

Tento příklad volá Vytvoření pravidla v sadě pravidel zóny operaci k přidání pravidla do existující http_request_firewall_custom (entry point ruleset fáze) s ID $RULESET_ID. Pravidlo přeskočí http_ratelimit fázi 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": {
				"phases": [
						"http_ratelimit"
				]
		},
		"expression": "http.request.uri.path contains \"/skip-phase/\"",
		"description": ""
	}'

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

Tento příklad volá Vytvoření pravidla v sadě pravidel zóny operaci k přidání pravidla, které:

• Přeskočí http_ratelimit fáze
• Zakáže 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í pro více informací o vypnutí logování požadavků, které odpovídají skip pravidlu.

Tento příklad používá Vytvoření pravidla v sadě pravidel zóny operaci k přidání pravidla, které přeskočí Zone Lockdown a User Agent Blocking 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í pro seznam produktů, které můžete přeskočit.

Tento příklad volá Vytvoření pravidla v sadě pravidel zóny operaci k přidání skip pravidla do existující http_request_firewall_custom (entry point ruleset fáze) s ID $RULESET_ID. Pravidlo přeskočí všechna zbývající pravidla ve fázi http_request_firewall_custom fázi 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": {
				"phase": "current"
		},
		"expression": "http.request.uri.path contains \"/skip-current-ruleset/\"",
		"description": ""
	}'

Tato možnost přeskočení je v současnosti dostupná pouze na úrovni zóny. Viz Dostupné možnosti přeskočení s dalšími podrobnostmi.