← Документация WAF / detections / ai-security-for-apps

Режим журналирования в сравнении с боевым режимом

AI Security for Apps может работать в двух разных режимах. Чтобы выбрать подходящий вариант для своего этапа внедрения, важно понимать компромиссы между ними.

Сравнение

Возможность	Production mode	Режим журналирования
Как это работает	Вы пишете WAF пользовательские правила с помощью полей обнаружения AI Security for Apps	Вы включаете AI Security Log Mode Ruleset с готовыми правилами
Протоколирование промптов	Нет: регистрируются только метаданные запроса	Да, полное тело запроса записывается в журнал (зашифровано с помощью журналирование полезной нагрузки)
Протоколирование ответов	Нет: используйте AI Gateway если требуется видимость ответа	Нет: то же ограничение
Гибкость политики	Полный: сочетает оценки внедрения, категории PII, оценки ботов, пользовательские темы и другое	Ограниченный: три фиксированных правила (обнаружены PII, обнаружена небезопасная тема, обнаружено внедрение промптов) без логики на основе показателей или подкатегорий
Поведение блокировки	Настраиваемость: возможность отправлять пользовательские ответы, включая пользовательский JSON	Только страница блокировки WAF по умолчанию
Подходит для	Боевой трафик с детальным контролем	Оценка и тестирование: сопоставление промптов с результатами обнаружения для настройки порогов

Production mode

Production mode представляет собой стандартный рабочий режим. Вы включаете AI Security for Apps и создаёте пользовательские правила с помощью поля обнаружения которые она заполняет. Это даёт вам полный контроль над:

Какие обнаружения запускают действие. Например, блокируйте только если cf.llm.prompt.injection_score ниже 30, а не блокировать любое обнаружение.
Какие категории PII важны. Например, блокируйте CREDIT_CARD но только регистрировать EMAIL_ADDRESS.
Объединение сигналов. Например, блокируйте, если одновременно обнаружены PII и низкий показатель бота.
Пользовательские ответы. Возвращайте вашему приложению сообщение об ошибке в формате JSON вместо стандартной страницы блокировки WAF.

Пример выражения боевого правила:
(cf.llm.prompt.injection_score lt 30 and cf.bot_management.score lt 20)

Режим журналирования

Режим журналирования использует AI Security Log Mode Ruleset: готовый набор правил, который логирует полное тело запроса вместе с результатами обнаружения. Этот режим предназначен для оценки и настройки, а не для боевого применения.

В режиме журналирования:

Управляемый набор правил срабатывает при трёх общих условиях: обнаружении PII, обнаружении небезопасной темы и обнаружении попытки внедрения промпта (prompt injection).
Всё тело запроса протоколируется с помощью журналирование полезной нагрузки (зашифровано: чтобы расшифровать полезные данные, необходимо настроить пару ключей).
Чтобы понять, как модель классифицирует ваш трафик, можно сопоставить конкретные промпты с их показателями обнаружения.

Когда использовать режим журналирования:

Во время начального развёртывания, чтобы понять, что AI Security for Apps обнаруживает в вашем трафике, прежде чем начать применять действия.
При настройке пороговых значений оценки проверяйте зарегистрированные промпты вместе с их оценками, чтобы определить подходящие пороги.
При проверке того, что пользовательская тема определения работают так, как ожидается.

Включение режима журналирования

В панели управления Cloudflare перейдите в раздел Security Настройки страницу.
Перейдите в Настройки ↗
В разделе Безопасность ИИ для приложений, найдите Управляемый набор правил раздел.
Включить AI Security Log Mode Ruleset.
Задайте действие Log.
(Рекомендуется) Настройте журналирование полезной нагрузки чтобы вы могли расшифровывать и просматривать полное содержимое запроса вместе с результатами обнаружения.

Разверните управляемый набор правил с помощью PUT запрос:

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

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

Zone WAF Write
Account WAF Write

Обновление набора правил точки входа зоны

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

ID набора правил AI Security Log Mode равен .

Чтобы задать действия для отдельных правил равными log, переопределите правила внутри управляемого набора правил с помощью action_parameters.overrides. Дополнительную информацию см. в Переопределение управляемого набора правил.