Добавить шаблон страницы ответа к профилю или правилу
Шаблон страницы ответа можно добавить к профилю безопасности или профилю ARL, а также к отдельным правилам в этих профилях.
Инструкции для CLI и API ниже относятся к профилю безопасности и его правилам. Для профиля ARL и его правил используйте консоль управления.
Добавление шаблона к профилю
При блокировке запроса используется шаблон, назначенный сработавшему правилу. Если у правила нет своего шаблона, используется шаблон профиля. Если шаблон не назначен ни правилу, ни профилю, клиенту возвращается стандартная страница Yandex Cloud.
- В консоли управления
выберите каталог, в котором находится профиль безопасности или ARL. - Перейдите
в сервис Smart Web Security. - На панели слева выберите
Профили безопасности или Профили ARL. - В строке с нужным профилем нажмите
→ Редактировать. - В списке Шаблон страницы ответа выберите существующий шаблон или создайте новый.
- Нажмите Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.
-
Посмотрите описание команды изменения профиля:
yc smartwebsecurity security-profile update --help -
Добавьте шаблон к профилю безопасности:
yc smartwebsecurity security-profile update \ --id <идентификатор_профиля> \ --custom-page-id <идентификатор_шаблона> \ --update-mask custom_page_idГде:
--id— идентификатор профиля безопасности. Обязательный параметр.--custom-page-id— идентификатор шаблона страницы ответа.--update-mask— список полей, которые нужно изменить. Значениеcustom_page_idпозволяет изменить только привязку шаблона к профилю.
Воспользуйтесь методом REST API update для ресурса SecurityProfile или вызовом gRPC API SecurityProfileService/Update.
В запросе укажите:
securityProfileId(в gRPC —security_profile_id) — идентификатор профиля безопасности.customPageId(в gRPC —custom_page_id) — идентификатор шаблона.updateMask— маску обновления со значениемcustomPageId. В gRPC укажите путьcustom_page_idв полеupdate_mask.
Маска обновления позволяет изменить только привязку шаблона и сохранить остальные настройки профиля.
Добавление шаблона к правилу
Правила, которым можно назначить шаблон страницы ответа:
- Правила профиля безопасности:
- Базовое с действием
Запретить. - Smart Protection в режиме
Полная защитаилиЗащита API. - Web Application Firewall в режиме
Полная защитаилиЗащита API.
- Базовое с действием
- Правила профиля ARL с действиями
Блокировать запросы свыше лимитаилиВременно блокировать все запросы на.
Дополнительно можно изменить внешний вид окна с проверкой SmartCaptcha. Для этого создайте новую или измените уже существующую капчу, привязанную к профилю безопасности.
- В консоли управления
выберите каталог, в котором находится профиль безопасности или ARL. - Перейдите
в сервис Smart Web Security. - На панели слева выберите Профили безопасности или Профили ARL.
- Выберите профиль, в котором находится нужное правило.
- В строке с правилом нажмите
и выберите Редактировать. - В списке Шаблон страницы ответа выберите существующий шаблон или создайте новый.
- Нажмите Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.
-
Посмотрите описание команды изменения профиля:
yc smartwebsecurity security-profile update --help -
Сохраните текущую конфигурацию профиля безопасности в файл:
yc smartwebsecurity security-profile get \ --id <идентификатор_профиля> \ --format yaml > profile.yaml -
Скопируйте из
profile.yamlполеsecurity_rulesсо всеми правилами в отдельный файлrequest.yaml. В нужном правиле добавьте или измените полеcustom_page_idна одном уровне сnameиpriority:custom_page_id: <идентификатор_шаблона>Важно
При обновлении заменяется весь список правил. Правила, которых нет в запросе, будут удалены.
-
Примените изменения:
yc smartwebsecurity security-profile update \ --id <идентификатор_профиля> \ --request-file request.yaml \ --update-mask security_rulesПараметр
--request-fileзадает файл с полным списком правил, а--update-mask security_rulesограничивает обновление этим списком.
- Получите текущие правила методом REST API get для ресурса SecurityProfile или вызовом gRPC API SecurityProfileService/Get.
- В массиве
securityRules(в gRPC —security_rules) найдите нужное правило и укажите в его полеcustomPageId(в gRPC —custom_page_id) идентификатор шаблона. - Обновите профиль методом REST API update или вызовом gRPC API SecurityProfileService/Update. Передайте идентификатор профиля и полный массив правил, включая неизмененные. В поле
updateMaskукажитеsecurityRules; для gRPC — путьsecurity_rulesв полеupdate_mask.
Важно
При обновлении заменяется весь список правил. Правила, которых нет в запросе, будут удалены. Маска обновления позволит сохранить остальные настройки профиля.