Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Smart Web Security
  • Начало работы
    • Все инструкции
    • Списки адресов
      • Создать шаблон
      • Добавить шаблон к профилю или правилу
      • Управлять шаблоном
    • Посмотреть операции
    • Настроить мониторинг
    • Настроить алерты
    • Настроить логи через Smart Web Security
    • Настроить логи через Application Load Balancer
    • Миграция на новый формат условий в API, CLI и Terraform
    • Обзор
    • Профиль безопасности
    • Профили WAF
    • ARL (лимит на запросы)
    • Правила
    • Условия
    • Списки
    • Управление бот-трафиком
    • Защита доменов
    • Network Protection (защита от DDoS L3–L4)
    • Шаблоны ответов
    • Логирование
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • Метрики
  • Аудитные логи
  • История изменений

В этой статье:

  • Добавление шаблона к профилю
  • Добавление шаблона к правилу
  1. Пошаговые инструкции
  2. Шаблоны ответов
  3. Добавить шаблон к профилю или правилу

Добавить шаблон страницы ответа к профилю или правилу

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 9 ноября 2026 г.
Открыть в Markdown
  • Добавление шаблона к профилю
  • Добавление шаблона к правилу

Шаблон страницы ответа можно добавить к профилю безопасности или профилю ARL, а также к отдельным правилам в этих профилях.

Инструкции для CLI и API ниже относятся к профилю безопасности и его правилам. Для профиля ARL и его правил используйте консоль управления.

Добавление шаблона к профилюДобавление шаблона к профилю

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

Консоль управления
CLI
API
  1. В консоли управления выберите каталог, в котором находится профиль безопасности или ARL.
  2. Перейдите в сервис Smart Web Security.
  3. На панели слева выберите Профили безопасности или Профили ARL.
  4. В строке с нужным профилем нажмите → Редактировать.
  5. В списке Шаблон страницы ответа выберите существующий шаблон или создайте новый.
  6. Нажмите Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды изменения профиля:

    yc smartwebsecurity security-profile update --help
    
  2. Получите идентификатор шаблона.

  3. Добавьте шаблон к профилю безопасности:

    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. Для этого создайте новую или измените уже существующую капчу, привязанную к профилю безопасности.

Консоль управления
CLI
API
  1. В консоли управления выберите каталог, в котором находится профиль безопасности или ARL.
  2. Перейдите в сервис Smart Web Security.
  3. На панели слева выберите Профили безопасности или Профили ARL.
  4. Выберите профиль, в котором находится нужное правило.
  5. В строке с правилом нажмите и выберите Редактировать.
  6. В списке Шаблон страницы ответа выберите существующий шаблон или создайте новый.
  7. Нажмите Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды изменения профиля:

    yc smartwebsecurity security-profile update --help
    
  2. Получите идентификатор шаблона.

  3. Сохраните текущую конфигурацию профиля безопасности в файл:

    yc smartwebsecurity security-profile get \
      --id <идентификатор_профиля> \
      --format yaml > profile.yaml
    
  4. Скопируйте из profile.yaml поле security_rules со всеми правилами в отдельный файл request.yaml. В нужном правиле добавьте или измените поле custom_page_id на одном уровне с name и priority:

    custom_page_id: <идентификатор_шаблона>
    

    Важно

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

  5. Примените изменения:

    yc smartwebsecurity security-profile update \
      --id <идентификатор_профиля> \
      --request-file request.yaml \
      --update-mask security_rules
    

    Параметр --request-file задает файл с полным списком правил, а --update-mask security_rules ограничивает обновление этим списком.

  1. Получите текущие правила методом REST API get для ресурса SecurityProfile или вызовом gRPC API SecurityProfileService/Get.
  2. В массиве securityRules (в gRPC — security_rules) найдите нужное правило и укажите в его поле customPageId (в gRPC — custom_page_id) идентификатор шаблона.
  3. Обновите профиль методом REST API update или вызовом gRPC API SecurityProfileService/Update. Передайте идентификатор профиля и полный массив правил, включая неизмененные. В поле updateMask укажите securityRules; для gRPC — путь security_rules в поле update_mask.

Важно

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

Полезные ссылкиПолезные ссылки

  • Добавить правило в профиль безопасности
  • Изменить правило в профиле безопасности
  • Подключить профиль безопасности к ресурсу
  • Удалить профиль безопасности

Была ли статья полезна?

Предыдущая
Создать шаблон
Следующая
Управлять шаблоном
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»