Content Security Policy (CSP): Как проверить, исправить и настроить на вашем сайте
Узнайте, как проверить, добавить и исправить заголовки Content Security Policy на Apache, Nginx, WordPress и Joomla, с практическими инструментами диагностики и рекомендациями по хостингу.
Политика безопасности контента (CSP): как проверить, исправить и настроить её на вашем сайте
HTTPS и обновления ПО крайне важны, но они не предотвращают выполнение всех вредоносных скриптов в браузере посетителя. Политика безопасности контента (CSP) добавляет ограничения, которые браузер принудительно применяет к ресурсам, которые страница может загрузить и выполнить. Она помогает смягчить некоторые атаки типа cross-site scripting (XSS), но не заменяет экранирование выходных данных в контексте, проверку ввода или обновление зависимостей.
Этот практический учебник показывает, как проверить вашу текущую политику, найти её источник, безопасно внести изменения и исправить проблемы в Apache, Nginx, WordPress и Joomla.
1. Проверьте существующую CSP
Chrome или Firefox: Откройте страницу, нажмите F12, выберите «Сеть», перезагрузите страницу, кликните на HTML-документ и проверьте «Заголовки ответа». Ищите Content-Security-Policy (принудительно) или Content-Security-Policy-Report-Only (только для диагностики). Проверьте консоль на наличие нарушений.
Командная строка: Запустите curl -I https://example.com/. На macOS/Linux фильтруйте ответ с помощью curl -sSI https://example.com/ | grep -i content-security-policy. HEAD-ответы могут отличаться от GET-ответов, поэтому используйте DevTools браузера для подтверждения.
Онлайн-инструменты: SecurityHeaders.com проверяет заголовки безопасности; Google CSP Evaluator выявляет слабые места в политике. Ни один из них не доказывает, что весь веб-сайт безопасен.
Отсутствие заголовка CSP в одном ответе не означает, что на всех страницах нет CSP. Также проверьте любой тег <meta http-equiv="Content-Security-Policy">: мета-политики имеют ограничения, включая отсутствие поддержки frame-ancestors или режима Report-Only.
2. Найдите, где определена политика
| Окружение | Вероятное местоположение |
|---|---|
| Apache / совместимый LiteSpeed | .htaccess, конфигурация виртуального хоста или сервера |
| Nginx | server / location конфигурация |
| PHP | Код приложения, использующий header() |
| WordPress | Плагин, пользовательский код, обратный прокси или хост |
| Joomla | Плагин System – HTTP Headers, сервер или прокси |
| Cloudflare | Правила преобразования заголовков ответа |
| Управляемый хостинг | Панель хостинга или управляемая поставщиком конфигурация |
Проверьте существующие заголовки ответа перед добавлением нового. Браузеры принудительно применяют несколько политик CSP кумулятивно; новый разрешающий заголовок не отменяет существующий ограничительный. Проверьте также правила CDN и хостинга.
3. Добавьте CSP в Apache с помощью .htaccess
С помощью файлового менеджера вашего хоста или SFTP (FileZilla/WinSCP) найдите публичную директорию, содержащую index.php, часто public_html или httpdocs. Включите отображение скрытых файлов, чтобы увидеть .htaccess. Скачайте резервную копию и избегайте размещения пользовательских правил внутри управляемого CMS блока переписывания.
Если mod_headers Apache включен и хост позволяет эти директивы, добавьте:
<IfModule mod_headers.c>
Header always set Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'"
</IfModule>
Перезагрузите и проверьте заголовок в разделе «Сеть» → «Заголовки». Проверьте консоль на наличие нарушений. Report-Only сообщает о возможных ограничениях, но не блокирует ресурсы. Этот пример диагностический, а не полная политическая мера.
Если сообщается о доверенном CDN-скрипте, сначала подтвердите его цель и владельца. Вы можете адаптировать директиву к script-src 'self' https://cdn.example.com; не добавляйте каждый заблокированный хост вслепую. Списки разрешенных хостов менее устойчивы против XSS, чем хорошо разработанные политики с использованием nonce/хэша.
После тестирования входа, форм, оформления заказа, редакторов и других рабочих процессов вы можете заменить Content-Security-Policy-Report-Only на Content-Security-Policy, чтобы применить вашу протестированную политику. Если сайт сломается, восстановите резервную копию файла, очистите кэш сервера/CDN и повторно протестируйте. HTTP 500 после редактирования указывает на проблему с синтаксисом или разрешениями сервера.

4. Настройте CSP в Nginx
Nginx игнорирует .htaccess. Если вы администрируете сервер, проверьте его активную конфигурацию (часто /etc/nginx/sites-available/ или /etc/nginx/conf.d/). В соответствующем блоке server используйте:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
Тестируйте с помощью sudo nginx -t, затем перезагрузите с помощью sudo systemctl reload nginx. Следите за наследованием add_header и правилами в более специфичных местах. На управляемом хостинге без доступа к конфигурации Nginx используйте панель управления провайдера или поддержку.
5. WordPress: плагин или небольшая пользовательская интеграция
Безкодовый путь: Сначала проверьте, отправляет ли ваш хост или существующий плагин заголовков безопасности CSP. Выберите поддерживаемый плагин, который явно поддерживает CSP и предпочтительно Report-Only; не предполагайте, что общий плагин безопасности поддерживает что-либо. В его настройках включите Report-Only, начните с консервативной диагностической политики, сохраните и протестируйте как публичные страницы, так и wp-admin перед применением.
Разработчикский путь: Создайте wp-content/plugins/ceikay-csp/ceikay-csp.php:
<?php
/**
* Plugin Name: CeiKay CSP Example
* Description: CSP diagnostics on the WordPress frontend.
*/
add_action('send_headers', function () {
if (is_admin()) {
return;
}
header(
"Content-Security-Policy-Report-Only: "
. "default-src 'self'; "
. "script-src 'self'; "
. "object-src 'none'; "
. "base-uri 'self'"
);
});
Активируйте его в Плагины → Установленные плагины, затем подтвердите заголовок ответа. Это не переопределяет существующую CSP от веб-сервера, CDN или другого плагина. Оно намеренно исключает wp-admin и не предоставляет полную принудительную политику.
Устранение неполадок: Если CAPTCHA не проходит, проверьте заблокированные script-src, frame-src и connect-src запросы и обратитесь к руководству по интеграции провайдера CAPTCHA. Если конструктор страниц сообщает о заблокированных встроенных скриптах, проверьте поддержку CSP nonce или хэша. Не добавляйте автоматически 'unsafe-inline'. Для nonce на каждый ответ убедитесь, что полное кэширование страниц не повторно использует один и тот же nonce и HTML для разных посетителей.
6. Joomla: используйте родной плагин HTTP-заголовков
В админпанели Joomla откройте Система → Плагины, найдите HTTP-заголовки и откройте System – HTTP Headers. Точное меню варьируется в зависимости от версии Joomla и языка.
Включите его опции CSP и начните с Report-Only на публичном сайте. Начните с диагностики директивы, такой как script-src 'self'; сохраните и проверьте консоль. Тестируйте шаблоны, конструкторы страниц, редакторы, контактные формы, CAPTCHA, интеграции платежей и медиа-функции.
Если вы видите Refused to execute inline script, определите, какой шаблон или расширение его генерирует. Предпочитайте совместимый подход с nonce или хэшем, где это поддерживается; подтвердите, что скрипт легитимен, перед его авторизацией. Тестируйте администратора отдельно от фронтенда. Если сервер уже устанавливает CSP, согласовывайте конфигурации, а не накапливайте конфликтующие политики.
Обратитесь к документации Joomla HTTP Headers для получения информации о вариантах, поддерживаемых вашей установленной версией.
7. Исправьте фактическое нарушение, а не всю политику
| Нарушение | Что исследовать | Типичное исправление |
|---|---|---|
script-src |
Внешний или встроенный JavaScript | Проверьте источник; используйте соответствующий nonce/хэш или узкоспециализированный источник |
style-src |
Таблица стилей или встроенный CSS | Проверьте сгенерированные стили; используйте одобренный источник или совместимый хэш/nonce |
img-src |
Внешнее изображение или URL данных | Разрешите проверенный хост изображений только в случае необходимости |
connect-src |
fetch/XHR/WebSocket | Проверьте источник API и добавьте узкоспециализированное разрешение |
frame-src |
Встроенное видео/CAPTCHA/платежный фрейм | Следуйте документированным доменам провайдера |
form-action |
Цель отправки формы | Разрешите легитимный источник отправки |
frame-ancestors |
Встраивание вашей страницы на другой сайт | Явно разрешите предполагаемые родительские источники или используйте 'none' |
Например, если легитимное изображение по адресу https://images.example.com/photo.webp блокируется img-src 'self', измените соответствующую директиву на img-src 'self' https://images.example.com после подтверждения, что хост доверен. Не ослабляйте default-src только для исправления одного изображения.

Некоторые директивы, включая frame-ancestors и form-action, не имеют запасного варианта default-src. Включайте их явно, когда это необходимо.
8. Влияет ли хостинг на настройку CSP?
Да—стандарт CSP браузера остается тем же, но ваш контроль над заголовками ответа меняется. Apache shared hosting может открывать .htaccess; управляемый Nginx может требовать панели управления провайдера; администраторы VPS могут модифицировать конфигурацию сервера; а CDN могут добавлять заголовки после того, как приложение сгенерировало ответ.
Перед выбором хостинговой услуги задайте вопрос: Могу ли я устанавливать и удалять заголовки CSP без root-доступа? Могу ли я использовать Report-Only? Могу ли я проверить финальный ответ? Доступны ли пользовательские заголовки в моем плане? Может ли поддержка объяснить конфликты с CDN или правилами приложения?
Cloudways: управление HTTP-заголовками на уровне хостинга
Cloudways документирует Web Rules → Header Rules для управления HTTP-заголовками ответа, включая CSP. Это предлагает хостинговую альтернативу редактированию файлов приложения, в зависимости от функций, доступных для вашего приложения и плана. Это не автоматически создает безопасную CSP; вам все равно нужно тестировать и поддерживать свои директивы.
9. Более сильная защита с использованием CSP на основе nonce
Строгая CSP использует непредсказуемые nonce или хэши, а не полагается только на списки разрешенных доменов. Упрощенный пример на PHP:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
В HTML-шаблоне:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
Генерируйте новый непредсказуемый nonce для каждого ответа. Держите заголовок и HTML nonce согласованными и планируйте вокруг обратных прокси и полного кэширования страниц. С 'strict-dynamic' доверенный скрипт может загружать другие скрипты, поэтому тщательно проверяйте доверенные загрузчики. Это иллюстрация, а не готовая к использованию полная политика для всех приложений.
10. Конечный чек-лист развертывания
- Определите все существующие заголовки CSP и мета-политики.
- Сделайте резервную копию конфигурации сервера и CMS.
- Составьте инвентарь скриптов, стилей, фреймов, API, изображений и внешних сервисов.
- Разверните политику Report-Only сначала.
- Исследуйте каждое нарушение и разрешите только доверенное, необходимое поведение.
- Тестируйте фронтенд, администрирование, вход, оформление заказа, формы и интеграции.
- Проверьте кэширование, nonce, поведение CDN и дублирующие заголовки.
- Включайте принудочное применение постепенно и следите после обновлений программного обеспечения.
Заключение
Полезная CSP — это не просто заголовок, скопированный из чек-листа. Проверьте вашу текущую конфигурацию, найдите, где она определена, протестируйте в режиме Report-Only, исправьте точные проблемы совместимости и только затем примените политику, подходящую для вашего веб-сайта. Администраторы WordPress и Joomla могут начать с инструментов CMS; разработчики могут использовать Apache, Nginx или PHP; а хостинговые платформы могут предлагать прямой контроль над заголовками.
CSP уменьшает возможности для атак, но остается одним слоем наряду с безопасным кодированием, обновлениями, аутентификацией и мониторингом.