← Cloudflare Firewall Rules / firewall / api / cf-firewall-rules

Objekt JSON

Ukázková odpověď JSON pro pravidlo firewallu

Odpověď JSON pro Firewall Rules API má tuto strukturu:

{
	"id": "772bf1026a72c400ea576db1ffa16407",
	"filter": {
		"id": "6f58318e7fa2477a23112e8118c66f61",
		"expression": "http.request.uri.path ~ \"^.*/wp-login.php$\" or http.request.uri.path ~ \"^.*/xmlrpc.php$\"",
		"paused": false,
		"description": "WordPress login paths",
		"ref": ""
	},
	"action": "challenge",
	"priority": 1000,
	"paused": false,
	"description": "Protect blog login page",
	"ref": ""
}

Tato tabulka shrnuje vlastnosti objektu:

Název	Popis	Omezení
`id` `String`	Identifikátor UUIDv4 vygenerovaný Cloudflare.	Jedinečné, pouze pro čtení Délka: 32 znaků
`filter` `Object`	A Objekt Cloudflare Filter obsahující výraz pro vyhodnocení tohoto pravidla.
`action` `String`	Akce, která se provede, pokud požadavek splňuje výraz filtru tohoto pravidla.	Viz Akce pravidel firewallu seznam podporovaných hodnot.
`priority` `Number`	Určuje pořadí vyhodnocení pravidla vzhledem k ostatním. Nižší hodnoty znamenají vyšší prioritu. Pravidla bez zadané hodnoty se vyhodnocují jako poslední. Pokyny najdete v Předcházení konfliktům priorit.	Pouze čtení Maximální délka: 32
`paused` `Boolean`	Vrátí `true` pokud pravidlo není aktivní. Použijte `ref` k povolení nebo zakázání pravidla.	Výchozí: `false`
`description` `String`	Informativní shrnutí pravidla.	Maximální délka: 500 znaků
`ref` `String`	Krátký řetězec pro označování pravidel.	Maximální délka: 50 znaků

Předcházení konfliktům priorit

Priorita hraje při konfiguraci pravidel brány firewall klíčovou roli. S filtry Cloudflare je totiž možné vytvořit protichůdná pravidla, například:

Povolte požadavky z rozsahu adres IP kanceláře a
Blokujte požadavky s konkrétním user agentem.

Požadavky z rozsahu IP adres kanceláře s blokovaným user agentem by spustily obě pravidla, ale požadavek nelze zároveň povolit i zablokovat. Aby se tento problém vyřešil, řídí se pravidla brány firewall přísným pořadím podle akce a priority.

Cloudflare řadí pravidla sestupně, takže priorita 1 je první a pravidla bez priority jsou poslední. U pravidel se stejnou prioritou je Cloudflare řadí podle akce, a to podle jejich pořadí priority. V uvedeném příkladu, pokud není nastavena žádná priorita, pravidlo allow request from the office IP range by se použilo, protože Allow akce má vyšší prioritu než Block.

Aby se snížilo riziko nežádoucího chování, je nejlepší u potenciálně kolidujících pravidel výslovně určit požadovanou prioritu.