Yandex Cloud
Документация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Yandex Smart Web Security
RU
  • Начало работы
    • Все инструкции
    • Списки адресов
      • Создать шаблон
      • Добавить шаблон к профилю или правилу
      • Управлять шаблоном
    • Посмотреть операции
    • Настроить мониторинг
    • Настроить алерты
    • Настроить логи через 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
Консоль управления
CLI
API
  1. В консоли управления выберите каталог, в котором вы хотите создать шаблон.

  2. Перейдите в сервис Smart Web Security.

  3. На панели слева выберите Шаблоны ответов и нажмите Создать шаблон.

  4. Введите Имя страницы — имя шаблона.

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

  5. (Опционально) Введите описание шаблона.

  6. Выберите Код ответа — HTTP-код, который будет возвращаться клиенту при использовании шаблона.

  7. Выберите Формат ответа: HTML, JSON, XML или Custom.

    Форматам HTML, JSON и XML соответствуют значения HTTP-заголовка Content-Type: text/html, application/json и application/xml. Чтобы указать другое значение, выберите Custom.

  8. Для формата Custom введите Content-Type. Например, text/plain.

  9. (Опционально) Чтобы добавить к ответу HTTP-заголовок, нажмите Добавить заголовок ответа и укажите параметры:

    • Ключ — название HTTP-заголовка, например Cache-Control.
    • Значение — значение заголовка, например no-store, чтобы запретить кеширование ответа.

    Можно добавить не более десяти заголовков. Не добавляйте заголовки Content-Type и Content-Length: значение Content-Type задается при выборе формата ответа.

  10. Введите Тело ответа — содержимое страницы, которое будет возвращено клиенту. Размер тела ответа не должен превышать 2 КБ.

    Содержимое ответа должно соответствовать выбранному формату ответа, например:

    • HTML

      <!doctype html>
      <html lang="ru">
      <head><meta charset="utf-8"><title>403 Forbidden</title></head>
      <body><h1>403 Forbidden</h1><p>Доступ ограничен.</p></body>
      </html>
      
    • JSON

      {
      "error": {
          "code": 403,
          "message": "Доступ ограничен.",
          "details": "Недостаточно прав для выполнения операции."
      }
      }
      
    • XML

      <?xml version="1.0" encoding="UTF-8"?>
      <error>
      <code>403</code>
      <message>Доступ ограничен.</message>
      <details>Недостаточно прав для выполнения операции.</details>
      </error>
      
  11. (Опционально) Добавьте в тело ответа дополнительные параметры, выбрав нужный пресет: ID запроса, IP-адрес, Время запроса.

    Эти данные могут быть полезны, например, при обращении клиента в поддержку.

    Пример страницы с дополнительными параметрами:

    <!doctype html>
    <html lang="ru">
    <head><meta charset="utf-8"><title>403 Forbidden</title></head>
    <body>
    <h1>403 Forbidden</h1>
    <p>Доступ ограничен. Если вы считаете блокировку ошибочной, передайте в поддержку следующие данные:</p>
    <p>Идентификатор запроса: %unique_key%</p>
    <p>IP-адрес: %client_ip%</p>
    <p>Время запроса: %request_time%</p>
    <p>Контакты: security@example.com</p>
    </body>
    </html>
    
  12. Нажмите Создать.

Чтобы посмотреть предварительный вид страницы ответа, на странице шаблона нажмите Просмотр.

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

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

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

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

    yc smartwebsecurity custom-page custom-page create --help
    
  2. Создайте шаблон. Например, чтобы возвращать HTML-страницу с кодом 403 Forbidden, выполните команду:

    yc smartwebsecurity custom-page custom-page create \
      --folder-id <идентификатор_каталога> \
      --name error.html \
      --content '<!doctype html>
    <html lang="ru">
    <head><meta charset="utf-8"><title>403 Forbidden</title></head>
    <body><h1>Доступ ограничен.</h1></body>
    </html>' \
      --content-type text/html \
      --status-code forbidden
    

    Где:

    • --folder-id — идентификатор каталога, в котором будет создан шаблон. Можно не указывать, если каталог задан в профиле CLI.
    • --name — имя шаблона.
    • --content — тело ответа размером не более 2 КБ. Содержимое должно соответствовать формату, указанному в --content-type.
    • --content-type — значение HTTP-заголовка Content-Type, например text/html, application/json или text/plain.
    • --status-code — один из стандартных HTTP-кодов ответов. Укажите его имя в формате CLI: например, forbidden для 403 или too-many-requests для 429. Полный список допустимых значений приведен в описании параметра --status-code в справочнике команды.

    Дополнительно можно указать описание в --description, метки ресурса в --labels и не более десяти HTTP-заголовков ответа в --headers. Например, --headers Cache-Control=no-store запрещает кеширование ответа. Заголовок Content-Type задавайте через --content-type, а Content-Length не добавляйте.

    В теле ответа можно использовать динамические параметры: идентификатор запроса, IP-адрес клиента и время запроса.

Воспользуйтесь методом REST API create для ресурса CustomPage или вызовом gRPC API CustomPageService/Create.

В запросе передайте параметры шаблона:

  • folderId (в gRPC — folder_id) — идентификатор каталога. Обязательное поле.
  • name — имя шаблона.
  • content — тело ответа размером не более 2 КБ.
  • contentType (в gRPC — content_type) — значение HTTP-заголовка Content-Type, соответствующее формату тела ответа.
  • statusCode (в gRPC — status_code) — HTTP-код ответа. Используйте значение перечисления, например FORBIDDEN для 403 или TOO_MANY_REQUESTS для 429.

При необходимости добавьте описание в поле description, метки ресурса в labels и не более десяти HTTP-заголовков ответа в headers. Например, "headers": {"Cache-Control": "no-store"} запрещает кеширование ответа. Не добавляйте в headers заголовки Content-Type и Content-Length.

В теле ответа можно использовать динамические параметры: идентификатор запроса, IP-адрес клиента и время запроса.

Чтобы использовать созданный шаблон, добавьте его к профилю или правилу.

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

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

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

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