← Cloudflare API Shield / api-shield / management-and-monitoring

Endpoint Management

Доступно на всех тарифах

Содержимое Endpoint Management использует текущую Web Assets панель управления. Перейдите в Web Assets > Операции для управления Конечные точки API.

Термином «операция» Cloudflare обозначает конечную точку, которая определяется методом HTTP, шаблоном имени хоста и шаблоном пути. Web Assets непрерывно обнаруживает операции, но вы также можете добавлять их вручную.

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

Доступ

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

Просмотрите обнаруженные операции

Web Assets непрерывно добавляет обнаруженные операции в реестр. Обнаружение не запускает обучение профиля.

Операции-кандидаты могут предоставлять контекст для сопоставления, обнаружения угроз на периметре и Sequence Analytics. Изменять каждую обнаруженную операцию не обязательно.

Добавление операций из Schema validation

От Web Assets > Операции, выберите Добавьте операцию.
Выберите Загрузить схему.
Загрузите файл схемы.
Выберите Добавление схемы и конечных точек.

API Shield ищет дублирующиеся операции с одинаковым хостом, методом и путём. Такие дублирующиеся операции не добавляются.

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

От Web Assets > Операции, выберите Добавьте операцию.
Выберите Добавить вручную.
Выберите метод и укажите шаблон имени хоста и шаблон пути.
Выберите Добавьте операцию.

При добавлении операции вручную можно указать переменные поля в пути или имени хоста. Заключайте переменные в фигурные скобки, например /api/user/{var1}/details или {hostVar1}.example.com.

Cloudflare поддерживает переменные хоста в следующих форматах:


{hostVar1}.example.com

foo.{hostVar1}.example.com

{hostVar2}.{hostVar1}.example.com

Переменные hostname должны занимать всё поле домена целиком и не могут использоваться вместе с другим текстом в этом поле.

Следующий формат не поддерживается:


foo-{hostVar1}.example.com

Подробнее о том, как Cloudflare использует переменные в API Shield, см. в примерах из API Discovery.

Изменить операции

Вы можете изменить идентификатор операции.

От Web Assets > Операции, откройте действия для строки операции.
Выберите Изменить операцию.
Измените HTTP-метод, шаблон имени хоста или шаблон пути.
Выберите Save.

Start profile learning

Начинайте профилирование только после проверки идентичности операции.

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

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

Удаление операций вручную

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

От Web Assets > Операции, выберите операции, которые нужно удалить.
Выберите Удалить операции.

Анализ операции

Для каждой операции в full состояние можно просмотреть:

Количество запросов: общее количество запросов к операции за период времени.
Рекомендация по ограничению скорости: за 10 минут. Это определяется количеством запросов.
Задержка: среднее время ответа источника в миллисекундах (мс). Этот показатель отражает, сколько времени проходит с момента запроса посетителя до момента получения им ответа от источника.
Частота ошибок по сравнению с общим трафиком: с группировкой по 4xx, 5xx и их сумме.
Размер ответа: средний размер ответа (в байтах), возвращённого на запрос.
Метки: текущий метки присвоенный операции.
Статус аутентификации: идентификаторы сессий, зафиксированные в успешных запросах к этой операции.
Последовательности: количество Sequence Analytics последовательности, содержащие эту операцию.

Использование API Cloudflare

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

Sensitive Data Detection

К чувствительным данным относятся различные виды персональной информации и финансовые данные. Cloudflare разработала этот набор правил для защиты от распространённых угроз утечки данных: WAF может искать такие данные в теле HTTP-ответов вашего источника.

API Shield уведомляет вас о конфиденциальных данных в ответах для полных операций. Для этого в вашей зоне также должен быть включён Управляемый набор правил Sensitive Data Detection.

Sensitive Data Detection доступна клиентам с тарифом Enterprise в рамках плана Advanced application security.

После включения Sensitive Data Detection API Shield запрашивает события WAF за последние семь дней. Web Assets отмечает операции, для которых нашлись совпадения с конфиденциальными ответами.

Откройте сведения об операции, чтобы просмотреть обнаруженные типы конфиденциальных данных. Выберите Просмотр событий чтобы просмотреть совпавшие события в Security Events.

После включения Sensitive Data Detection для вашей зоны вы можете просмотреть набор правил Sensitive Data Detection ↗. Ссылка не будет работать, если Sensitive Data Detection не включён.

Ограничения

Некоторые метрики производительности, например задержка, не поддерживаются, если запрос обрабатывается сервисом Cloudflare так, что он не может быть передан напрямую вашему origin-серверу.

Это ограничение проявляется, в частности, в следующих случаях:

На этом пути URL выполняется Cloudflare Worker.
Другие продукты на основе Workers, например Waiting Room, активны для приложения.

В таких случаях система не может точно измерить время ответа источника, и этот показатель не будет отображаться в панели управления.