INTEGRITY Dokumentace

← Dokumentace WAF / tools

User Agent Blocking

User Agent Blocking umožňuje blokovat konkrétní User-Agent hlavičky požadavku ↗. Pravidla user agentů platí pro celou doménu, nikoli pro jednotlivé subdomény.

Pravidla user agenta se uplatňují po pravidla zone lockdown. Pokud IP adresu povolíte pomocí Zone Lockdown, přeskočí se pro ni všechna pravidla založená na user agentovi.

Dostupnost

Cloudflare User Agent Blocking je k dispozici ve všech plánech. Pravidla user agenta možnost se zobrazí, pouze pokud máte nakonfigurováno alespoň jedno pravidlo user agenta.

Počet dostupných pravidel user agentů závisí na vašem plánu Cloudflare.

Free Pro Business Enterprise
Dostupnost Ano Ano Ano Ano
Počet pravidel 10 50 250 1,000

Vytvoření pravidla User Agent Blocking

  1. V Cloudflare dashboardu přejděte na Bezpečnostní pravidla stránku.

    Přejděte na Bezpečnostní pravidla ↗

  2. Vyberte Create rule > Pravidla user agenta.

  3. Zadejte popisný název pravidla do Název/Popis.

  4. V Akce, vyberte akci, která se má provést: Block, Non-Interactive Challenge, Managed Challenge, nebo Interactive Challenge.

  5. Zadejte hodnotu user agenta do User Agent (zástupné znaky jako * nejsou podporovány). Například pro zablokování web spideru Bad Bot zadejte BadBot/1.0.2 (+http://bad.bot).

  6. Vyberte Save and Deploy blokovacího pravidla.

Odešlete POST požadavek na Vytvoření pravidla User Agent Blocking operaci podobnou následující:

Požadovaná oprávnění API tokenu

Alespoň jedno z následujících oprávnění tokenu je vyžadováno:
  • Firewall Services Write
Vytvoření pravidla User Agent Blocking
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/firewall/ua_rules" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"description": "Block Bad Bot web spider",
		"mode": "block",
		"configuration": {
				"target": "ua",
				"value": "BadBot/1.0.2 (+http://bad.bot)"
		}
	}'

Akce typu challenge

Když pravidlo User Agent Blocking používá akci typu challenge, jako je Managed Challenge, návštěvník musí projít challenge stránkou. Po úspěšném projití challenge se cf_clearance cookie je nastavena. Dobu platnosti této cookie určuje nastavení Challenge Passage (nastavení).