← Cloudflare API Shield / api-shield / management-and-monitoring / endpoint-management
Schema learning
Schema Learning отслеживает подходящий трафик для выбранных операций. Она определяет ожидаемые поля запроса и ограничения для Schema Profile.
Start profile learning
-
В панели управления Cloudflare перейдите в Web Assets > Операции.
Перейдите в Web assets ↗ -
Откройте меню дополнительных действий операции и выберите Изучение профиля.
-
После того как профиль станет доступен, выберите Просмотр сведений.
-
Просмотрите изученную схему в разделе Обзор безопасности.
Cloudflare выполняет постоянное обнаружение после того как обученный профиль становится доступен. Само обнаружение не блокирует запросы.
Чтобы изучить результаты, ознакомьтесь с Анализ обнаружений профиля. Чтобы устранить нарушения, см. Применение профилей с помощью Custom Rules.
Соответствовать требованиям обучения
Обучение выполняется еженедельно на основе подходящего трафика за предыдущие семь дней. Учитываются только запросы, которые получили 2xx ответ учитывается.
Для порога обучения полям требуется 1 000 подходящих запросов. Для порога обучения границам требуется 10 000 подходящих запросов.
Первый профиль появляется после следующего еженедельного цикла обучения. Это может занять до семи дней после достижения нужного порогового значения.
Поддерживаемые компоненты запроса, ограничения и лимиты см. в Schema Profiles.
Экспорт схемы
При экспорте создаётся отдельный файл OpenAPI на основе текущего изученного профиля. Это не изменяет сам профиль и его обнаружение.
-
На панели управления Cloudflare перейдите к разделу Web Assets страницу.
Перейдите в Web assets ↗ -
Перейдите в Операции на вкладке.
-
Выберите Экспорт схемы и выберите хост для экспорта.
-
Укажите, нужно ли включать изученные параметры и рекомендации по ограничению скорости запросов.
-
Выберите Экспорт схемы и выберите место для сохранения файла.
Содержимое изученной схемы
Экспортированные схемы содержат указанный хост в разделе servers, а также операции по хосту, методу и пути.
Для операций с достаточным объёмом трафика экспортированные схемы также включают:
- Обнаруженные переменные пути и их форматы
- Обнаруженные параметры запроса и их форматы
- Обнаружено
POST,PUT, а такжеPATCHимена и форматы переменных тела запроса дляapplication/jsonтипов содержимого
Экспортированные схемы могут дополнительно включать рекомендации API Shield по ограничению скорости запросов.
Для фиксированного Schema Profile загрузите экспортированный файл через Schema validation.