← Документация WAF / detections / application-profiles
Schema Profiles
Schema Profile моделирует ожидаемые поля запроса и их ограничения. Его можно сформировать на основе трафика или предоставить загруженную схему.
После того как профиль становится доступен, Cloudflare запускает постоянное обнаружение. Обнаружение само по себе не противодействует запросам.
Изучение на основе трафика
Термином «операция» Cloudflare обозначает конечную точку. Её идентичность складывается из HTTP-метода, шаблона имени хоста и шаблона пути.
Web Assets непрерывно обнаруживает операции в Web Assets > Операции. Операцию также можно добавить вручную.
Оба метода только добавляют операции в инвентарь. Чтобы начать профилирование, выберите Изучение профиля из меню дополнительных действий для операции.
Удовлетворяйте требованиям к трафику
Обучение выполняется еженедельно на основе подходящего трафика за предыдущие семь дней. Учитываются только запросы, которые получили 2xx ответ учитывается.
Для порога обучения полям требуется 1 000 подходящих запросов. Для порога обучения границам требуется 10 000 подходящих запросов.
Порог обучения полям позволяет Cloudflare изучать поля запросов. Порог обучения границам позволяет Cloudflare изучать такие ограничения, как числовые диапазоны и длины строк.
Первый профиль появляется после следующего еженедельного цикла обучения. Это может занять до семи дней после достижения нужного порогового значения.
Просмотр изученного содержимого
В меню дополнительных действий операции выберите Просмотр сведений. Изученная схема отображается в разделе Обзор безопасности.
Профили могут обучаться на следующих компонентах запроса, если это поддерживается:
- Переменные пути
- Параметры запроса
- Заголовки и файлы cookie
- JSON request bodies
- Тела запросов в формате form-encoded
Профили умеют проверять целые числа, строки, универсальные уникальные идентификаторы (UUID) и массивы. Среди поддерживаемых ограничений: числовые диапазоны, длина строк, классы символов и перечисления, содержащие до трёх значений.
Успешный трафик может включать ботов, сканеры или вредоносные запросы. Прежде чем применять обнаружение по изученному профилю, проверьте этот профиль.
Каждый еженедельный запуск может обновлять профиль по мере изменения квалифицируемого трафика. Для фиксированной схемы экспортировать изученную схему как OpenAPI и загрузить его для проверки.
Учитывайте ограничения
У изученных Schema Profiles есть следующие ограничения:
- Формы multipart, GraphQL и XML не поддерживаются.
- Для повторяющихся параметров проверяется каждое значение, но уникальность не требуется.
- Наличие обязательного параметра не проверяется принудительно.
- Сами по себе новые параметры не вызывают нарушений.
- Ограничения применяются к изученным полям, а не к полному списку разрешений.
Использование загруженной схемы
Загруженная схема OpenAPI задаёт ожидаемую структуру вместо наблюдаемого трафика. Она формирует обнаружения через cf.schema_validation.uploaded.violated.
API Shield предоставляет подробную Справочник по Schema validation. В нём рассматриваются поддерживаемые версии, процедуры импорта, поля OpenAPI, ограничения на размер тела запроса и устранение неполадок.
