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

Управление операциями

Состояния операций

Каждая операция находится в одном из следующих состояний:

Состояние Значение
full Операция, которую вы выбрали, добавили вручную или создали из схемы. Полные операции используются для сопоставления, логирования, обнаружений и правил.
candidate Операция, обнаруженная Cloudflare в трафике. Операции кандидаты используются для сопоставления, логирования, обнаружений и правил, пока вы не проверите их вручную.
shadow Операция, которая существует в Web Assets, но не используется для сопоставления, логирования, обнаружений или правил.

Вам не обязательно перемещать каждую обнаруженную операцию в full Операции кандидаты автоматически предоставляют контекст операции. Обучение профиля начинается только после выбора Изучение профиля.

Требования к обнаружению

Если операция не отображается в Web Assets, возможно, Cloudflare не зафиксировал достаточно допустимых запросов за непрерывный период. Обнаружение обрабатывает только запросы, которые соответствуют всем следующим требованиям:

Обнаруженные операции

Discovery непрерывно выявляет операции в проксируемом HTTP трафике. Discovery группирует похожие пути запросов с помощью нормализации путей.

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

GET https://api.example.com/profile/238
GET https://api.example.com/profile/392

Discovery может объединить их в одну операцию:

GET api.example.com/profile/{var1}

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

Сопоставление на основе Discovery зависит от доступности тарифного плана и системных ограничений. В настоящее время Cloudflare передаёт на периферийные серверы для сопоставления до 3 000 операций на зону. Операции в full имеют более высокий приоритет, за ними следуют операции в состоянии candidate состояние.

Start profile learning

Выберите Изучение профиля чтобы намеренно запустить обучение профиля. Обнаружение, ручное создание и редактирование не запускают профилирование.

Клиенты с API Security уже имеют доступ к Schema Profiles через Schema Learning и Schema Validation. Cloudflare открывает закрытый бета-тест для приглашённых клиентов с тарифным планом Enterprise без API Security. Заинтересованные клиенты могут обратиться в свой account team, чтобы заявить об интересе. Доступ к закрытой бете не гарантирует доступность в будущих тарифных планах и не определяет их стоимость.

Для операции кандидата или теневой операции это действие также перемещает операцию в full Операция, уже находящаяся в состоянии full остается в этом состоянии. Затем Cloudflare изучает ожидаемую структуру запросов на основе подходящего трафика.

Для конечных точек API API Shield также собирает данные о другом контексте:

У каждой функции свои требования к данным и срокам. Для Schema Profiles см. Schema learning.

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

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

    Перейдите в Web assets ↗
  2. Откройте меню действий для операции в этой строке.

  3. Выберите Изучение профиля.

После того как профиль станет доступен, выберите Просмотр сведений. Просмотрите изученную схему в разделе Обзор безопасности.

Поведение при сопоставлении трафика

Cloudflare сопоставляет каждый запрос с одной операцией на периферийном сервере. Если запросу соответствует несколько шаблонов операций, приоритет получает более специфичная операция.

Например, обе эти операции могут соответствовать GET https://example.com/checkout/pay:

GET example.com/checkout/pay
GET example.com/checkout/{var1}

Cloudflare использует GET example.com/checkout/pay поскольку оно более специфично.

Для одного и того же метода, шаблона имени хоста и шаблона пути Cloudflare генерирует один и тот же UUID операции. Это обеспечивает стабильность идентификатора операции при повторном обнаружении той же операции.

Добавление операций вручную

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

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

    Перейдите в Web assets ↗
  2. Выберите Добавьте операцию.

  3. Выберите Добавить вручную.

  4. Выберите HTTP-метод, укажите шаблон имени хоста и шаблон пути.

  5. Подтвердите с помощью Добавьте операцию.

Ручное создание только добавляет операцию в реестр. Выберите Изучение профиля отдельно, чтобы начать профилирование.

Используйте переменные в шаблонах операций

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

Для переменных пути заключите переменную в фигурные скобки:

/api/users/{var1}/details

Для переменных имени хоста переменная должна занимать полную метку имени хоста. Cloudflare поддерживает такие шаблоны, как:

{hostVar1}.example.com
foo.{hostVar1}.example.com
{hostVar2}.{hostVar1}.example.com

Не сочетайте переменную hostname с другими символами в одной метке. Следующий шаблон не поддерживается:

foo-{hostVar1}.example.com

Добавление операций из схем

Если вы уже используете схемы OpenAPI, вы можете продолжать загружать их для создания операций.

Загрузка схемы также используется в API Shield для проверки по схеме. Дополнительную информацию см. в разделе Schema Validation и обучение схемы.

Уточнение операций

Уточняйте операции, если текущая группировка не соответствует тому, как должен группироваться или защищаться трафик.

Например, вам может понадобиться создать отдельные операции для трафика входа и сброса пароля, даже если оба маршрута частично используют одну и ту же структуру пути. Также вы можете объединить несколько узких операций в одну более широкую, если они описывают одно и то же поведение приложения.

Перед внесением изменений проверьте пересекающиеся операции. Cloudflare сопоставляет каждый запрос только с одной операцией. Широкая операция может изменить группировку похожих запросов, а узкая операция способна выделить один сценарий из общего трафика.

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

    Перейдите в Web assets ↗
  2. Откройте меню действий для операции в этой строке.

  3. Выберите Изменить операцию.

  4. Измените HTTP-метод, шаблон имени хоста или шаблон пути.

  5. Выберите Save.

Редактирование обновляет запись операции в реестре. Оно не запускает обучение профиля.

Удалить операции

Вы можете удалять операции по одной или массово.

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

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

  3. Подтвердите с помощью Удалить операции.

Используйте Cloudflare API

Вы можете взаимодействовать с операциями через Cloudflare API. Подробнее см. документация по API операций.