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 шагов».