Главная » Блог » Content-Security-Policy для WordPress: как внедрить и не сломать сайт

Content-Security-Policy для WordPress: как внедрить и не сломать сайт

Content-Security-Policy — самый мощный и самый сложный HTTP-заголовок безопасности. Он говорит браузеру, из каких источников можно загружать скрипты, стили, картинки и фреймы. Без него браузер доверяет любому скрипту, который попал на страницу, — и это упрощает XSS.

Но CSP — не «включил и забыл». Слишком строгая политика ломает Gutenberg, плагины и аналитику. Слишком мягкая — бесполезна. В этой статье разберём, как внедрять политику поэтапно, чтобы не сломать сайт, и почему 'unsafe-inline' в WordPress — это осознанный компромисс, а не ошибка.

Это статья про процесс внедрения. Подробный разбор каждой директивы (object-src, base-uri, blob:, worker-src) — в отдельной справочной статье «Директивы CSP: разбор с примерами для WordPress».

Почему CSP сложен в WordPress

Типовая страница WordPress содержит около девяти inline-скриптов (настройки Gutenberg, wp-emoji, локализованные данные плагинов) и около тринадцати inline-стилей. Если убрать 'unsafe-inline' из script-src и style-src, сайт сломается: Gutenberg не загрузится, стили «поедут», плагины перестанут работать.

Чтобы убрать 'unsafe-inline', каждому inline-скрипту нужен nonce — уникальный для каждого запроса. А это конфликтует с полностраничным кэшем: закэшированная страница отдаётся всем одинаковой, а nonce должен быть разным. Плюс часть кода WordPress выводит <script> и <style> напрямую, а не через wp_enqueue_script(), поэтому автоматически добавить nonce ко всем тегам не получается.

Поэтому «хорошая» CSP для WordPress — это не «строгая CSP без 'unsafe-inline'», а честный компромисс: строгие директивы, которые не ломают сайт, и осознанное принятие того, что 'unsafe-inline' остаётся, но вы знаете, что именно он не защищает.

Рабочая CSP для WordPress

Вот политика, которая не ломает типовой сайт и закрывает то, что можно закрыть без героизма:

default-src 'self';
script-src 'self' https://api.example.ru 'unsafe-inline' 'unsafe-eval' blob: *.google-analytics.com *.googletagmanager.com mc.yandex.ru mc.yandex.com;
style-src 'self' https://api.example.ru 'unsafe-inline';
img-src 'self' data: *.gravatar.com *.wp.com mc.yandex.ru *.googleapis.com;
font-src 'self' data:;
connect-src 'self' https://api.example.ru *.google-analytics.com mc.yandex.ru mc.yandex.com wss://mc.yandex.ru;
frame-src 'self' *.youtube.com *.vimeo.com rutube.ru *.rutube.ru mc.yandex.ru;
object-src 'none';
base-uri 'self';
form-action 'self';
frame-ancestors 'self';
worker-src 'self' blob:;

Коротко, что делает каждая директива:

ДирективаЧто делает
default-srcБаза: по умолчанию только свой домен
script-srcОткуда можно грузить JS; 'unsafe-inline' и 'unsafe-eval' — компромисс для Gutenberg
style-srcОткуда можно грузить CSS; 'unsafe-inline' — для inline-стилей темы и плагинов
img-src, font-src, connect-src, frame-srcКартинки, шрифты, fetch/XHR/WebSocket, iframe
object-src 'none'Запрет <object>, <embed>, <applet> — «дешёвая» защита от старых плагинов
base-uri 'self'Запрет подмены <base> — иначе относительные ссылки уведут на чужой сайт
form-action 'self'Запрет отправки форм на чужие домены
frame-ancestors 'self'Современная замена X-Frame-Options, защита от кликджекинга
worker-src 'self' blob:Web Workers для Gutenberg

Подробный разбор каждой директивы —  «Директивы CSP: разбор с примерами для WordPress».

Что можно улучшить сегодня

1. Добавить frame-ancestors 'self', если её ещё нет. Одна директива, которая заменяет X-Frame-Options и поддерживается всеми современными браузерами. После её добавления X-Frame-Options можно оставить для старых браузеров или убрать.

2. Проверить сторонние домены в connect-src. Если там есть тестовый или временный домен (например, demo.example.ru), в продакшене он не нужен.

3. Добавить upgrade-insecure-requests. Полезная директива, которая автоматически апгрейдит все http:// ресурсы до https://. Если где-то остались старые ссылки на картинки по HTTP, эта директива их «починит».

💡 upgrade-insecure-requests не заменяет HSTS. HSTS гарантирует, что все визиты на домен идут по HTTPS. upgrade-insecure-requests «поднимает» только ресурсы на текущей странице, которые грузятся по http://. Это комплементарные меры: HSTS — фундамент, upgrade-insecure-requests — удобная «санация» смешанного контента. Подробнее о HSTS — в статье «HSTS».

Поэтапное внедрение: Report-Only

Не включайте CSP сразу в боевом режиме. Сначала — Content-Security-Policy-Report-Only. Это тот же CSP, но браузер не блокирует нарушения, а только отправляет отчёты о них.

Шаг 1. Определиться с endpoint для отчётов. Нужен URL, который принимает POST с JSON. Внешние сервисы вроде Report URI могут быть недоступны из России, поэтому надёжнее всего — свой скрипт-приёмник на сайте. Это небольшая отдельная работа: скрипт, который принимает отчёты и пишет их в лог. Если не хотите писать его самостоятельно — [обратитесь, помогу](ссылка на контакты).

Шаг 2. Добавить заголовок Content-Security-Policy-Report-Only. На уровне сервера или в MU-плагине. В политике — текущая разрешающая политика плюс report-uri.

Шаг 3. Собрать нарушения за 1–2 недели. Пройти по основным страницам: главная, статьи, формы, страницы с виджетами, админка, мобильная версия. В отчётах вы увидите blocked-uri, violated-directive, document-uri.

Шаг 4. Разобрать нарушения по категориям. Обычно три кучи: свои inline-скрипты (Gutenberg, тема, плагины), сторонние скрипты, которые вы сами подключили (аналитика, виджеты), и неизвестные (расширения браузера или что-то, что вы не контролируете).

Шаг 5. Принять решение. Если нарушений от inline слишком много и они критичны — вы оставите 'unsafe-inline' в итоговой политике. Если нарушений мало и они от конкретных сторонних доменов — добавьте эти домены и переходите к боевому режиму.

Шаг 6. Переключить на боевой режим. Когда лог отчётов станет «тихим» на всех ключевых страницах, поменяйте имя заголовка с Content-Security-Policy-Report-Only на Content-Security-Policy. Директиву report-uri лучше оставить: если после включения что-то сломается (например, новый плагин), вы узнаете о проблеме из отчётов.

Если что-то пошло не так — верните -Report-Only и снова посмотрите логи. Это безопасный откат.

Что не надо добавлять

X-XSS-Protection — устарел. Современные браузеры его игнорируют, а в некоторых случаях он создаёт уязвимости. Не добавляйте.

Cross-Origin-Embedder-Policy (COEP) и Cross-Origin-Resource-Policy (CORP) — нужны только для cross-origin isolation (SharedArrayBuffer, высокоточные таймеры). Для обычного сайта это не «базовая гигиена».

'unsafe-inline' без понимания — не «добавьте на всякий случай», а осознанный компромисс. Если вы добавляете его, знайте, что CSP в этой части не защищает от XSS.

Итог

«Хорошая» CSP для WordPress — это не «строгая CSP без 'unsafe-inline'», а политика, которая закрывает то, что можно закрыть без поломки сайта, и честно признаёт, что inline-XSS остаётся дырой. Начните с Report-Only, соберите отчёты за 1–2 недели, разберите нарушения и переключитесь на боевой режим только тогда, когда поймёте, что именно разрешаете.

Если хочется большего — путь через nonce, но это уже проект: нужен код, генерация nonce, интеграция с кэшем. Для сайта-визитки или блога это часто избыточно. Для WooCommerce или сайта с авторизацией — оправдано.

О том, где вообще ставить заголовки — на сервере, в .htaccess или в MU-плагине — в статье «Где устанавливать HTTP-заголовки безопасности». О простых заголовках, которые можно добавить сегодня, — в статье «Простые HTTP-заголовки безопасности». О HSTS и его необратимости — в статье «HSTS». А как это вписывается в общую защиту сайта — в статье «Базовая гигиена WordPress: чек-лист из 14 шагов».

Наверх