← Dokumentace WAF / detections / malicious-uploads

Běžná volání API

Následující příklady řeší běžné scénáře použití API Cloudflare pro správu a konfiguraci kontroly obsahu WAF.

Pokud používáte Terraform, přečtěte si Příklady konfigurace Terraformu.

Obecné operace

Následující ukázky API pokrývají základní operace, jako je zapnutí a vypnutí kontroly obsahu WAF.

Zapnutí kontroly obsahu WAF

Chcete-li povolit skenování obsahu, použijte POST požadavek podobný tomuto:

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

Alespoň jeden z následujících oprávnění tokenu je povinné:

Zone WAF Write
Account WAF Write

Zapněte funkci Content Scanning pro zónu.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/enable" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Vypnutí WAF Content Scanning

Chcete-li zakázat skenování obsahu, použijte POST požadavek podobný tomuto:

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

Alespoň jeden z následujících oprávnění tokenu je povinné:

Zone WAF Write
Account WAF Write

Vypněte Content Scanning pro zónu.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/disable" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Získání stavu content scanning pro WAF

Chcete-li zjistit aktuální stav funkce skenování obsahu, použijte GET požadavek podobný tomuto:

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

Alespoň jeden z následujících oprávnění tokenu je povinné:

Zone WAF Write
Zone WAF Read
Account WAF Write
Account WAF Read

Získání stavu Content Scanning pro zónu.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/settings" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Operace s vlastními výrazy

Následující ukázky API pokrývají operace s vlastními výrazy pro kontrolu obsahu.

Získání existujících vlastních výrazů pro skenování

Chcete-li získat seznam existujících vlastních výrazů skenování, použijte GET požadavek podobný tomuto:

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

Alespoň jeden z následujících oprávnění tokenu je povinné:

Zone WAF Write
Zone WAF Read
Account WAF Write
Account WAF Read

Vypište vlastní výrazy Content Scanning dané zóny.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/payloads" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
	"result": [
		{
			"id": "<EXPRESSION_ID>",
			"payload": "lookup_json_string(http.request.body.raw, \"file\")"
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}

Přidat vlastní výraz pro kontrolu

Použijte POST požadavek podobný tomuto:

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

Alespoň jeden z následujících oprávnění tokenu je povinné:

Zone WAF Write
Account WAF Write

Vytvoření vlastních výrazů Content Scanning pro zónu.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/payloads" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '[
		{
				"payload": "lookup_json_string(http.request.body.raw, \"file\")"
		}
	]'

Odstranění vlastního výrazu skenování

Použijte DELETE požadavek podobný tomuto:

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

Alespoň jeden z následujících oprávnění tokenu je povinné:

Zone WAF Write
Account WAF Write

Odstranění vlastního výrazu Content Scanning ze zóny.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/payloads/$EXPRESSION_ID" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"