← Документация WAF / detections / malicious-uploads

Типичные вызовы API

Следующие примеры решают типичные сценарии использования API Cloudflare для управления и настройки сканирования содержимого WAF.

Если вы используете Terraform, см. Примеры конфигурации Terraform.

Общие операции

Следующие примеры API рассматривают базовые операции, такие как включение и отключение сканирования содержимого WAF.

Включение сканирования содержимого WAF

Чтобы включить сканирование содержимого, используйте POST запрос, подобный следующему:

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

Zone WAF Write
Account WAF Write

Включите Content Scanning для зоны.

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

Отключение сканирования содержимого WAF

Чтобы отключить сканирование содержимого, используйте POST запрос, подобный следующему:

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

Zone WAF Write
Account WAF Write

Отключите сканирование содержимого для зоны.

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

Получить статус сканирования содержимого WAF

Чтобы узнать текущий статус функции сканирования содержимого, используйте GET запрос, подобный следующему:

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

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

Получить статус сканирования содержимого для зоны.

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

Операции с пользовательскими выражениями

Следующие примеры API рассматривают операции с пользовательскими выражениями сканирования содержимого.

Получить существующие пользовательские выражения сканирования

Чтобы получить список существующих пользовательских выражений сканирования, используйте GET запрос, подобный следующему:

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

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

Выведите список пользовательских выражений Content Scanning для зоны.

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": []
}

Добавьте пользовательское выражение сканирования

Используйте POST запрос, подобный следующему:

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

Zone WAF Write
Account WAF Write

Создание пользовательских выражений Content Scanning для зоны.

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\")"
		}
	]'

Удаление пользовательского выражения сканирования

Используйте DELETE запрос, подобный следующему:

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

Zone WAF Write
Account WAF Write

Удаление пользовательского выражения Content Scanning из зоны.

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