Політика безпеки контенту (CSP): Як перевірити, виправити та налаштувати її на вашому веб‑сайті
Дізнайтеся, як перевірити, додати та виправити заголовки Політики безпеки контенту на Apache, Nginx, WordPress і Joomla, використовуючи практичні діагностичні інструменти та рекомендації щодо хостингу.
Content Security Policy (CSP): Як перевірити, виправити та налаштувати його на вашому веб-сайті
HTTPS та оновлення програмного забезпечення є важливими, але вони не заважають кожному шкідливому скрипту виконуватися в браузері відвідувача. Політика безпеки вмісту (CSP) додає обмеження, що примусово застосовуються браузером, до ресурсів, які сторінка може завантажувати та виконувати. Вона допомагає зменшити певні атаки міжсайтового скриптингу (XSS), але не замінює контекстне екранування виводу, перевірку вхідних даних чи оновлення залежностей.
Цей практичний посібник показує, як перевірити вашу поточну політику, знайти її джерело, безпечно внести зміни та виправити проблеми на Apache, Nginx, WordPress та Joomla.
1. Перевірте свою існуючу CSP
Chrome або Firefox: Відкрийте сторінку, натисніть F12, оберіть Network, перезавантажте, натисніть на HTML-документ і перегляньте Response Headers. Шукайте 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">: meta-політики мають обмеження, включаючи відсутність підтримки 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>
Перезавантажте і перевірте заголовок у Network → Headers. Перевірте Консоль на наявність порушень. Report-Only повідомляє про можливі обмеження, але не блокує ресурси. Цей приклад є діагностичним, а не повною політикою розгортання.
Якщо повідомлено про довірений скрипт CDN, спочатку підтвердьте його призначення та власність. Ви можете адаптувати директиву до script-src 'self' https://cdn.example.com; не додавайте кожен заблокований хост сліпо. Списки дозволених хостів менш стійкі проти XSS, ніж добре розроблені політики на основі nonce/hash.
Після тестування входу, форм, оформлення замовлення, редакторів та інших робочих процесів ви можете замінити 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 та правилами в більш специфічних location. На керованому хостингу без доступу до конфігурації 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 Headers
В адмініструванні Joomla відкрийте Система → Плагіни, знайдіть HTTP Headers і відкрийте 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 |
Зовнішнє зображення або data 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 може надавати .htaccess; керований Nginx може вимагати панель провайдера; адміністратори VPS можуть змінювати конфігурацію сервера; а CDN можуть додавати заголовки після того, як програма згенерує відповідь.
Перед вибором хостингової послуги запитайте: Чи можу я встановлювати та видаляти заголовки CSP без root-доступу? Чи можу я використовувати Report-Only? Чи можу я переглядати кінцеву відповідь? Чи доступні власні заголовки на моєму плані? Чи може підтримка пояснити конфлікти з правилами CDN або програми?
Cloudways: хостинговий контроль HTTP-заголовків
Cloudways документує Web Rules → Header Rules для керування HTTP-заголовками відповіді, включаючи CSP. Це пропонує хостинговий альтернативний спосіб редагування файлів програми, залежно від функцій, доступних для вашої програми та плану. Це не автоматично створює безпечну CSP; ви все ще повинні тестувати та підтримувати свої директиви.
9. Більш надійний захист із nonce-базовою CSP
Строга 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 та meta-політики.
- Створіть резервну копію конфігурації сервера та CMS.
- Складіть інвентаризацію скриптів, стилів, фреймів, API, зображень та зовнішніх сервісів.
- Спочатку розгорніть політику Report-Only.
- Розслідуйте кожне порушення і авторизуйте лише довірену, необхідну поведінку.
- Протестуйте фронтенд, адміністрування, вхід, оформлення замовлення, форми та інтеграції.
- Перевірте кешування, nonce, поведінку CDN та повторювані заголовки.
- Поступово увімкніть примусове застосування і моніторте після оновлень програмного забезпечення.
Висновок
Корисна CSP — це не просто заголовок, скопійований з чек-листу. Перевірте свою поточну конфігурацію, знайдіть, де вона визначена, протестуйте в режимі Report-Only, виправте точні проблеми сумісності і тільки тоді примусово застосуйте політику, що відповідає вашому веб-сайту. Адміністратори WordPress та Joomla можуть почати з інструментів CMS; розробники можуть використовувати Apache, Nginx або PHP; а хостингові платформи можуть пропонувати прямий контроль заголовків.
CSP зменшує можливості для атак, але залишається лише одним шаром поруч із безпечним кодом, оновленнями, автентифікацією та моніторингом.