☰
WEB SECURITY / PRACTICE

Безопасные шорткоды и HTML в WordPress: защита от XSS

Безопасные шорткоды и HTML в WordPress: защита от XSS

Шорткоды и HTML-блоки позволяют быстро добавлять на страницы кнопки, формы, таблицы и динамический контент. Но любой механизм, который принимает или выводит HTML, может стать точкой для XSS-атаки — особенно если данные поступают от авторов, редакторов, посетителей или сторонних интеграций.

Основное правило безопасной работы с WordPress таково: санитизация нужна при получении или сохранении данных, а экранирование — непосредственно перед выводом. Это разные этапы, и один не заменяет другой. Ниже приведена практическая схема проверки шорткодов, HTML в Elementor и прав пользователей.

Почему шорткод может стать уязвимостью XSS

Сам по себе шорткод не является опасным. Риск возникает в его callback-функции — коде, который обрабатывает атрибуты и формирует HTML для страницы. Если callback выводит значения атрибутов без проверки, злоумышленник может передать JavaScript или небезопасные HTML-атрибуты.

Проблема особенно серьезна, когда записи могут редактировать не только администраторы. Если пользователь с расширенными правами вставит вредоносный код в запись, он может выполняться в браузерах других администраторов или посетителей. Это называется stored XSS — сохраненная межсайтовая скриптовая атака.

Не следует считать админ-панель автоматически безопасной зоной. Данные из полей настроек, метаполей, импортов, API, форм и шорткодов могут попасть на фронтенд, в письма или в JavaScript-контекст.

  • Не выводите атрибуты шорткода без esc_attr().
  • Не выводите обычный текст без esc_html().
  • Не разрешайте произвольный HTML, если для этого нет четкой необходимости.
  • Проверяйте не только страницы, но и виджеты, архивы, шаблоны и AJAX-ответы.

Разделяйте санитизацию и экранирование

Санитизация очищает или нормализует данные при их получении или сохранении. Например, для короткого текстового поля можно использовать sanitize_text_field(), для URL — esc_url_raw(), а для числа — absint(). Санитизация снижает риск сохранения некорректных данных, но не отменяет необходимость экранирования.

Экранирование выполняется в момент вывода и зависит от контекста. Для текста, HTML-атрибута, URL и JavaScript-контекста нужны разные функции. Универсальной функции, которую можно безопасно применять везде, не существует.

Если поле должно содержать ограниченный HTML, используйте wp_kses() или wp_kses_post() непосредственно перед выводом. Набор разрешенных тегов должен соответствовать реальной задаче, а не быть максимально широким.

  • Обычный текст: esc_html().
  • Значение HTML-атрибута: esc_attr().
  • URL в HTML: esc_url() при выводе и esc_url_raw() при сохранении.
  • Ограниченный HTML в содержимом записи: wp_kses_post() или wp_kses() с собственным списком тегов.
  • Числовые значения: проверяйте тип, например с помощью absint(), а не просто экранируйте строку.

Пример безопасного callback для шорткода

В приведенном ниже примере заголовок выводится как текст, URL — как атрибут ссылки, а описание — как разрешенный HTML. Также важно не доверять атрибутам шорткода: их нужно нормализовать и ограничить допустимыми значениями.

function webhva_button_shortcode( $atts, $content = null ) {
    $atts = shortcode_atts(
        array(
            'url'   => '',
            'title' => 'Перейти',
        ),
        $atts,
        'webhva_button'
    );

    $url   = esc_url( $atts['url'] );
    $title = esc_html( $atts['title'] );
    $text  = wp_kses_post( $content ?? '' );

    if ( empty( $url ) ) {
        return '';
    }

    return sprintf(
        '<a class="button" href="%1$s" aria-label="%2$s">%3$s</a>',
        $url,
        $title,
        $text
    );
}

Безопасная работа с атрибутами шорткодов

Атрибуты шорткода — это пользовательский ввод, даже если поле выглядит как часть шаблона. Не вставляйте их в HTML с помощью необработанной конкатенации. Также не следует разрешать атрибутам задавать произвольные CSS-классы, имена файлов, URL или параметры запросов без белого списка.

Для значений с ограниченным набором вариантов используйте allowlist. Например, размер кнопки может быть только small, medium или large. Для URL проверяйте схему и не разрешайте опасные протоколы, такие как javascript:.

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

  • Задавайте значения по умолчанию с помощью shortcode_atts().
  • Проверяйте тип и допустимый диапазон каждого параметра.
  • Для режимов, стилей и статусов используйте список разрешенных значений.
  • Не выводите необработанные атрибуты в style, onmouseover, onclick или другие event-атрибуты.
  • Не формируйте SQL-запросы, shell-команды или имена файлов без отдельной валидации.

Почему опасно напрямую передавать ввод в do_shortcode()

do_shortcode() предназначена для обработки строки, которая уже содержит контролируемый контент с шорткодами. Если передать туда произвольный пользовательский текст, этот текст может быть интерпретирован как шорткод. В результате пользователь получит доступ к функциональности, которую разработчик не планировал открывать в данном месте.

Риск зависит от зарегистрированных шорткодов. Один из них может выполнять внешний запрос, показывать приватные данные, создавать форму или изменять состояние системы. Даже если это не приводит непосредственно к XSS, возникает проблема несанкционированной функциональности.

Если обработка шорткодов действительно необходима, сначала ограничьте источник данных и контекст. Для обычного текста лучше использовать esc_html(), а не do_shortcode(). Для контролируемого редакторского контента применяйте wp_kses_post() и разрешайте шорткоды только пользователям с соответствующими правами.

  • Не передавайте в do_shortcode() значения из публичных форм без четкой проверки.
  • Не позволяйте пользователю выбирать произвольное имя шорткода.
  • Не используйте do_shortcode() как способ «отрендерить любой текст».
  • Проверьте сторонние шорткоды, которые могут вызываться через редакторский контент.

Роли WordPress и HTML в Elementor

HTML- и JavaScript-контент должен быть доступен только тем пользователям, которым вы действительно доверяете. В WordPress возможность вставлять неограниченный HTML связана с capability unfiltered_html. Не предоставляйте ее авторам и редакторам без необходимости: при компрометации такой учетной записи злоумышленник сможет сохранить опасный код.

В Elementor HTML-виджет и другие элементы, позволяющие вставлять произвольный код, следует ограничить администраторами или специально определенной группой доверенных пользователей. Точный способ управления зависит от конфигурации WordPress, Elementor и дополнительных средств управления ролями, поэтому проверяйте не только настройки редактора, но и фактические права тестового пользователя.

Важно учитывать, что ограничение роли не очищает уже сохраненный контент. После изменения прав необходимо проверить старые страницы, шаблоны, глобальные виджеты, попапы и другие места, где мог остаться HTML или JavaScript.

  • Принцип наименьших привилегий: пользователь получает только те права, которые нужны ему для работы.
  • Проверьте роли авторов, редакторов, менеджеров магазина и пользователей с пользовательскими capabilities.
  • После изменения ролей протестируйте создание, редактирование и публикацию HTML-контента.
  • Периодически проверяйте активные учетные записи и удаляйте ненужные права.
  • Не вставляйте сторонние скрипты в HTML-виджеты без проверки источника и назначения.

Как проверить шорткоды и HTML на практике

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

Для каждого параметра протестируйте обычное значение, кавычки, HTML-теги, события JavaScript, URL с опасными протоколами и очень длинные строки. Не используйте вредоносные payloads на рабочем сайте: проводите проверку на копии или в staging-среде.

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

  • Найдите все регистрации шорткодов и изучите их callback-функции.
  • Проверьте, выполняется ли экранирование в том же месте, где формируется HTML.
  • Просмотрите поля настроек, метаполя, импорты и AJAX-обработчики.
  • Проверьте контент Elementor, включая шаблоны и глобальные элементы.
  • Убедитесь, что ошибки входных данных не показывают необработанный пользовательский текст.
  • После тестирования удалите демонстрационные записи и отзовите временные права.

Типичные ошибки разработчиков

Самая частая ошибка — санитизировать значение один раз при сохранении и считать его безопасным навсегда. Данные могут быть изменены другим кодом, импортированы из базы или выведены в другом контексте. Поэтому экранирование должно оставаться непосредственно перед выводом.

Другая ошибка — использование esc_html() для HTML, который необходимо сохранить. Эта функция преобразует теги в текст. И наоборот, wp_kses_post() не заменяет esc_attr(), если значение вставляется в атрибут.

  • Одна функция экранирования для всех контекстов.
  • Доверие к данным только потому, что они поступили из админ-панели.
  • Предоставление unfiltered_html всем редакторам «для удобства».
  • Динамическое формирование шорткодов из пользовательского ввода.
  • Проверка только нового контента без аудита старых страниц.

Частые вопросы

Достаточно ли использовать wp_kses_post() для защиты всех шорткодов?

Нет. wp_kses_post() подходит для разрешенного HTML в текстовом контенте, но не заменяет esc_attr() для атрибутов, esc_url() для URL, проверку прав доступа и валидацию типов данных.

Можно ли разрешить редакторам вставлять HTML в WordPress?

Только если это оправдано рабочим процессом и пользователям можно доверять. Лучше предоставить ограниченные возможности и запретить unfiltered_html тем ролям, которым не нужен произвольный HTML или JavaScript.

Опасен ли сам текст с синтаксисом shortcode?

Текст не обязательно опасен, но его передача в do_shortcode() может активировать зарегистрированные шорткоды. Если нужно показать текст как текст, выводите его через esc_html(), а не обрабатывайте как шорткод.

Где ограничить HTML-виджет Elementor?

Ограничение нужно установить на уровне ролей и доступных возможностей редактора, оставив произвольный HTML только администраторам или отдельной доверенной группе. После этого проверьте доступ тестовым пользователем и просмотрите уже сохраненные шаблоны.

Нужно ли экранировать данные, если поле доступно только в админ-панели?

Да. Данные из админ-панели могут попасть на фронтенд, в письма, REST-ответы или другие контексты. Санитизация при сохранении и экранирование при выводе должны выполняться независимо от того, кто заполняет поле.

Вывод

Безопасные шорткоды строятся не вокруг одной функции, а вокруг правильной модели доступа и обработки данных. Ограничивайте роли, не разрешайте неограниченный HTML без необходимости, проверяйте атрибуты и используйте экранирование в соответствии с контекстом.

Для WordPress и Elementor особенно важны регулярный аудит старого контента, контроль HTML-виджетов и отказ от передачи произвольного ввода в do_shortcode(). Санитизируйте данные при сохранении, экранируйте их при выводе и тестируйте сайт с точки зрения пользователя с минимальными правами.

← Все материалы веб-безопасности