Loading...

Справка CDN.com.tr

Режим WAF «только журнал»: проверьте правила, прежде чем они начнут блокировать

Переведите WAF в режим «только журнал» для всего сайта или для выбранных путей на 7, 14 или 30 дней. Правила WAF продолжают проверять каждый запрос и записывают в журнал те, которые они заблокировали бы, с пометкой «был бы заблокирован», но не блокируют ни один. По окончании срока аккаунт сам возвращается к блокировке.

Режим WAF «только журнал»: проверьте правила, прежде чем они начнут блокировать

Переведите WAF в режим «только журнал» для всего сайта или для выбранных путей на 7, 14 или 30 дней. Правила WAF продолжают проверять каждый запрос и записывают в журнал те, которые они заблокировали бы, с пометкой «был бы заблокирован», но не блокируют ни один. По окончании срока аккаунт сам возвращается к блокировке.

Следующие шаги

Подробные руководства по чтению журналов и добавлению исключений.

Чтение журналов WAF

Поиск по Reference ID, повторяющиеся блокировки и форма исключения.

Открыть раздел

Страница «События безопасности»

Переключатель WAF, блокировка IP и стран, ограничение частоты запросов и другие средства защиты.

Открыть раздел

Что такое WAF?

Что ловят правила WAF и как обрабатываются ложные срабатывания.

Читать руководство

Путь в панели

  1. Management Panel
  2. CDN Accounts
  3. События безопасности
  4. Режим «только журнал»

Предварительные требования

  • WAF для всего сайта включён.
  • Вы владелец или редактор аккаунта.

Пошаговое руководство

1

Включите режим

Примените режим «только журнал» ко всему сайту или только к путям, которые хотите проверить.

  • Найдите карточку «Режим «только журнал»» на странице «События безопасности».
  • Выберите «Только журнал (весь сайт)» для всего сайта или «Только журнал (эти пути)» и введите пути, например /api/ и =/login.
  • Выберите срок и нажмите «Сохранить».

Ожидаемый результат: Карточка показывает дату окончания и число оставшихся дней; edge-серверы применяют изменение в течение 1-2 минут.

cdnctl equivalent
# API: GET /api/accounts/$ACCOUNT_UUID/waf/mode
# API: PUT /api/accounts/$ACCOUNT_UUID/waf/mode
# {"mode":"detect","scope":"paths","paths":["/api/","=/login"],"days":14}
2

Просмотрите, что было бы заблокировано

Пока режим включён, запросы, которые WAF заблокировал бы, показываются под отдельным фильтром.

  • Установите фильтр «Показать:» в значение «Только журнал (были бы заблокированы)» и выберите период.
  • Посмотрите URI, тип атаки и ID правила в каждой строке: легитимные запросы, повторяющиеся на одном пути и правиле, — кандидаты на исключение.
  • Если нужен полный список, скачайте отчёт в CSV или XLSX.

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

3

Добавьте исключения и вернитесь к блокировке

Исключения постоянные: они продолжают действовать и после окончания режима.

  • В разделе «Исключения WAF» укажите правило и путь (и поле, если правило сработало на одном поле) и нажмите «Добавить исключение».
  • Когда журнал станет чистым, выберите «Блокировка» на карточке и сохраните либо дождитесь окончания срока.

Ожидаемый результат: В режиме блокировки ваши легитимные запросы проходят, а атакующие запросы блокируются.

cdnctl equivalent
# API: GET /api/accounts/$ACCOUNT_UUID/waf/exclusions
# API: PUT /api/accounts/$ACCOUNT_UUID/waf/mode
# {"mode":"block"}

Сценарии использования

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

Краткий порядок действий

  1. Откройте «События безопасности» в меню аккаунта. WAF для всего сайта должен быть включён: режим «только журнал» применяется к его правилам.
  2. На карточке Режим «только журнал» выберите Только журнал (весь сайт) или Только журнал (эти пути).
  3. Для путей вводите по одному в строке (не более 20). Путь вида /api/ охватывает себя и всё, что под ним; чтобы охватить только этот адрес, начните строку с = (=/login).
  4. Выберите срок: 7, 14 или 30 дней. Нажмите «Сохранить»; изменение доходит до edge-серверов в течение 1-2 минут.
  5. В журнале на той же странице установите фильтр Показать: в значение Только журнал (были бы заблокированы) и просмотрите запросы, которые были бы заблокированы.
  6. Для легитимных запросов добавьте исключение WAF для этого правила и пути (и поля, если нужно). Когда будете готовы, вернитесь к блокировке или дождитесь окончания срока.

Проверки

  • В режим журнала переходят только правила WAF. Списки IP, стран и ASN, ограничение частоты запросов и JS-проверка продолжают блокировать всё это время.
  • Если выбраны пути, на остальной части сайта WAF продолжает блокировать.
  • Режим «только журнал» всегда заканчивается: по истечении срока аккаунт сам возвращается к блокировке. Владелец аккаунта получает письмо за 2 дня до окончания и при окончании.
  • Карточка показывает, до какого числа действует режим и сколько дней осталось. Повторное сохранение режима «только журнал» начинает срок заново.
  • Сохранённый вами список путей остаётся в форме после возврата аккаунта к блокировке и готов к следующей проверке.

Часто задаваемые вопросы

Остаётся ли мой сайт без защиты в режиме «только журнал»?

Нет. В этом режиме перестают блокировать только правила WAF: вместо блокировки они записывают свои срабатывания в журнал. Блокировки по IP, странам и ASN, ограничение частоты запросов и JS-проверка продолжают работать. Если вы примените режим только к путям новой функции, остальной сайт по-прежнему защищён WAF.

Как читать записи «был бы заблокирован»?

На странице «События безопасности» установите фильтр «Показать:» в значение «Только журнал (были бы заблокированы)». Каждая строка помечена значком «Был бы заблокирован (только журнал)» и показывает время, IP клиента, метод, URI, тип атаки и ID правила. С тем же фильтром отчёт можно скачать в CSV или XLSX.

Легитимный запрос отображается как «был бы заблокирован». Что делать?

Запишите ID правила и путь из строки и добавьте исключение для этого правила и пути (с полем, если правило сработало на одном поле) в разделе «Исключения WAF» на той же странице. Исключение продолжает действовать и после возврата к блокировке, поэтому тот же запрос не будет заблокирован, когда режим закончится. Подробные шаги описаны в статье Чтение журналов WAF.

Можно ли вернуться к блокировке до окончания срока?

Да. Выберите «Блокировка» на карточке и сохраните; аккаунт снова блокирует в течение 1-2 минут.

Можно ли управлять этим через API?

Да. GET /api/accounts/{account}/waf/mode возвращает текущий режим, дату окончания и число оставшихся дней; PUT на тот же адрес с параметрами mode (block или detect), scope (site или paths), paths и days (7, 14 или 30) изменяет его.