← Dokumentace WAF / detections / ai-security-for-apps

Režim protokolování oproti produkčnímu režimu

AI Security for Apps může fungovat ve dvou odlišných režimech. Pochopení kompromisů mezi nimi vám pomůže zvolit přístup vhodný pro fázi nasazení, ve které se právě nacházíte.

Produkční režim je standardní provozní režim. Povolíte AI Security for Apps a vytvoříte vlastní pravidla pomocí detekční pole naplňuje. Díky tomu máte plnou kontrolu nad:

• Které detekce spouštějí akci. Můžete například blokovat pouze v případě, že cf.llm.prompt.injection_score je nižší než 30, místo blokování jakékoli detekce.
• Které kategorie PII jsou důležité. Můžete například blokovat CREDIT_CARD ale pouze zaznamenávat EMAIL_ADDRESS.
• Kombinování signálů. Můžete například blokovat, pokud je zároveň detekováno PII a skóre bota je nízké.
• Vlastní odpovědi. Vrátí vaší aplikaci chybovou zprávu ve formátu JSON místo výchozí blokovací stránky WAF.

Příklad výrazu produkčního pravidla:
(cf.llm.prompt.injection_score lt 30 and cf.bot_management.score lt 20)

Režim protokolování využívá sadu pravidel AI Security Log Mode Ruleset, což je předpřipravená sada pravidel, která spolu s výsledky detekce zaznamenává celé tělo požadavku. Tento režim je určen pro vyhodnocování a ladění, nikoli pro produkční vynucování.

V režimu Log:

• Spravovaná sada pravidel se spouští při třech obecných podmínkách: zjištění PII, zjištění nebezpečného tématu a zjištění prompt injection.
• Celé tělo požadavku se zaznamenává pomocí protokolování payloadu (šifrováno, pro dešifrování payloadů musíte nakonfigurovat pár klíčů).
• Konkrétní prompty můžete propojit s jejich skóre detekce a zjistit tak, jak model klasifikuje váš provoz.

Kdy použít log mode:

• Během počáteční instalace, abyste zjistili, co AI Security for Apps na vašem provozu detekuje, než začnete vynucovat akce.
• Při ladění prahových hodnot skóre projděte zaznamenané prompty společně s jejich skóre a určete vhodné prahové hodnoty.
• Při ověřování, že vlastní téma definice fungují podle očekávání.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/phases/http_request_firewall_managed/entrypoint" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"rules": [
				{
						"action": "execute",
						"action_parameters": {
								"id": "b7cd52df92f74c848cec0c2ed385e336"
						},
						"expression": "true"
				}
		]
	}'