INTEGRITY Документация

Маркировка операций

Метки добавляют операциям контекст сценария использования. Функции обнаружения могут использовать метки, чтобы точнее фокусироваться на трафике с определённым сценарием использования приложения.

Управляемые метки

Cloudflare определяет управляемые метки. Они обозначают распространённые типы операций, такие как процессы входа, процессы регистрации и операции на основе ИИ.

Некоторые управляемые метки могут обнаруживаться автоматически. В настоящее время автоматическое обнаружение доступно только для отдельных управляемых меток и отдельных тарифных планов.

Доступны следующие управляемые метки:

Метка Описание
cf-api-endpoint Операции, которые предоставляют машиночитаемые данные или обеспечивают программное взаимодействие.
cf-llm Операции, которые принимают запросы к сервисам на основе больших языковых моделей (LLM).
cf-mcp Операции, реализующие Model Context Protocol (MCP) для доступа ИИ-инструментов к данным.
cf-contains-ads Операции, которые отдают веб-страницы с рекламой.
cf-log-in Операции, которые принимают учётные данные пользователей.
cf-sign-up Операции, которые создают учётные записи пользователей.
cf-content Операции, которые предоставляют уникальный контент, например сведения о товаре, отзывы или цены.
cf-purchase Операции, которые завершают покупку.
cf-password-reset Операции, которые участвуют в процессе сброса пароля.
cf-add-cart Операции, которые добавляют товары в корзину или проверяют их наличие.
cf-add-payment Операции, которые принимают данные банковских карт или счетов.
cf-check-value Операции, которые проверяют бонусные баллы, игровую валюту или другие накопленные средства.
cf-add-post Операции, которые публикуют сообщения, отзывы или другой пользовательский контент.
cf-account-update Операции, которые обновляют данные учётной записи или профиля пользователя.
cf-rss-feed Операции, которые рассчитаны на трафик от RSS-клиентов.
cf-web-page Операции, которые отдают страницы HTML.

Доступные обнаружения

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

Метка Связанное обнаружение
cf-llm Безопасность ИИ для приложений
cf-log-in Обнаружение утечек учётных данных и защита от злоупотреблений аккаунтом
cf-sign-up Защита от злоупотреблений аккаунтом

Для некоторых функций обнаружения может по-прежнему требоваться настройка конкретного продукта. Полный рабочий процесс описан в Настройка защитных мер.

Пользовательские метки

Пользовательские метки помогают организовать операции по владельцу, приложению, окружению и бизнес-процессу.

Применить метки

Применяйте метки к операциям из Web Assets.

  1. На панели управления Cloudflare перейдите к разделу Web Assets страницу.

    Перейдите в Web assets ↗
  2. Выберите операцию, которую нужно пометить меткой.

  3. Выберите Изменить метки.

  4. Выберите управляемые или пользовательские метки, которые нужно применить.

  5. Выберите Сохраните метки.

Используйте метки в аналитике и журналах

Вы можете просматривать совпавшие операции и управляемые метки в Security Analytics, а также запрашивать или экспортировать эти данные.

GraphQL Analytics API

Вы можете запрашивать данные о совпавших операциях и управляемых метках с помощью GraphQL Analytics API. webAssetsOperationId и webAssetsLabelsManaged поля доступны в httpRequestsAdaptive и httpRequestsAdaptiveGroups наборов данных.

webAssetsLabelsManaged возвращает не более 10 меток за один запрос.

Следующий запрос возвращает количество запросов по идентификатору операции и набору управляемых меток для трафика, содержащего cf-llm управляемую метку:

query GetAdaptiveGroups($zoneTag: string, $start: DateTime!, $end: DateTime!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			httpRequestsAdaptiveGroups(
				filter: {
					datetime_geq: $start
					datetime_leq: $end
					requestSource: "eyeball"
					webAssetsLabelsManaged_hasany: ["cf-llm"]
				}
				limit: 25
				orderBy: [count_DESC]
			) {
				count
				dimensions {
					webAssetsOperationId
					webAssetsLabelsManaged
				}
			}
		}
	}
}

Замените cf-llm с другой управляемая метка. Также можно использовать webAssetsOperationId как единственное измерение для группировки трафика по совпавшей операции.

Logpush

Вы можете экспортировать данные Web Assets по каждому запросу в свое хранилище или в Система SIEM с помощью Logpush. WebAssetsOperationID и WebAssetsLabelsManaged поля доступны в Набор данных HTTP requests.