Политика безопасности контента: назначение и настройка
Content Security Policy (CSP) — механизм браузера, который ограничивает загрузку и выполнение ресурсов страницы. Через специальный HTTP-заголовок администратор разрешает конкретные источники скриптов, стилей, изображений, шрифтов и подключений, блокируя нежелательные. Это снижает риск внедрения кода и защищает пользователя от действий злоумышленника.
Правила действуют только в браузере и не заменяют экранирование пользовательских данных, проверку входных значений и защиту форм от CSRF. При этом CSP особенно полезна сайтам с большим количеством JavaScript, внешними сервисами и рекламными или аналитическими интеграциями.
Зачем нужна политика безопасности контента
Главная защитная функция — ограничение источников исполняемого кода. Если злоумышленник попытается внедрить скрипт через HTML, комментарий или уязвимость шаблона, браузер отклонит загрузку из источника, не указанного в политике. Так CSP уменьшает возможности межсайтового скриптинга, известного как XSS.
Политика также может запретить встраивание страницы в чужой iframe и закрепить допустимые базовые URL. Обычная исходящая ссылка сама по себе разрешения не требует: ограничиваются загружаемые ресурсы, а не тема публикации, даже если пользователь открывает материал о смене региона Netflix.
Из каких директив состоит CSP
Набор правил задают директивы. default-src служит запасным источником, script-src управляет JavaScript, style-src — CSS, img-src — изображениями, font-src — шрифтами, а connect-src — сетевыми запросами. object-src 'none' отключает устаревшие плагины, base-uri 'self' защищает относительные URL, а frame-ancestors 'none' запрещает встраивание сайта.
Для кода, встроенного в HTML, нужен отдельный подход. unsafe-inline ослабляет защиту, поэтому его лучше не использовать, если задачу можно решить nonce или хешем. nonce — случайное значение, добавляемое к разрешённому тегу и меняемое при каждом ответе; strict-dynamic позволяет доверенному скрипту загружать нужные модули. unsafe-eval следует исключать, если приложение не зависит от динамического вычисления кода.
Как собрать безопасные правила
Сначала составьте перечень ресурсов: где размещены скрипты и стили, какие CDN подключаются, какие API принимают запросы и нужны ли сторонние фреймы. Отдельного разрешения требуют инструменты экспериментов и аналитики. Перед подключением изучите обзор сервисов для A/B-тестирования, чтобы зафиксировать точные домены, а не добавлять в правила десятки безымянных источников.
Затем сформируйте минимально необходимый набор. Например, default-src 'self' закрывает неучтённые типы ресурсов, а в connect-src следует перечислить только адреса API и аналитических служб. Полный домен допустим, если ресурсы действительно приходят с него; точные пути работают не у всех типов директив и браузеров. Не используйте *, data: и blob: без проверки реальной необходимости.
Как добавить заголовок на сервере
Готовую политику добавляют в ответ HTTP заголовком Content-Security-Policy. В Nginx его задают в конфигурации сервера, в Apache — через модуль headers, а в облачной платформе — в настройках CDN или балансировщика. Сервер может вернуть, например, такой заголовок:
Content-Security-Policy: default-src 'self'; script-src 'self' 'nonce-{fresh-value}'; style-src 'self'; img-src 'self' data:; object-src 'none'; base-uri 'self'; frame-ancestors 'none'; report-uri /csp-report
Значение {fresh-value} заменяют новой случайной строкой при каждом ответе. Для проверки сначала отправляйте заголовок в режиме Content-Security-Policy-Report-Only: нарушения фиксируются, но не блокируются. Затем переключитесь на принудительный режим. Если платформа не позволяет менять серверные заголовки, допустим метатег http-equiv в <head>, но он не поддерживает frame-ancestors и report-uri; серверный заголовок предпочтительнее.
Как проверять срабатывания и ошибки
Браузер показывает нарушенную директиву, заблокированный URI и номер строки. Эти данные сопоставляют с журналом report-uri или report-to, чтобы понять, какой ресурс запрещён. В отчёте CSP незнакомые сокращения полезно проверять по контексту, а не угадывать: материал о разнице RTP казино наглядно показывает, как похожие обозначения могут скрывать разные параметры.
Типичные срабатывания вызваны встроенными обработчиками, eval, неверным connect-src или веб-воркерами. Переносите код во внешние файлы, добавляйте точные разрешения и при необходимости worker-src. Не исправляйте всё через unsafe-inline: это отменяет важную часть защиты. Сначала устраняйте причины блокировки, затем повторяйте тест в очищенном браузере и на тестовом сервере.
Как поддерживать политику после запуска
После запуска сохраните каталог разрешённых ресурсов, команду, отвечающую за каждое исключение, и срок его пересмотра. Внутренняя инструкция должна объяснять, как добавлять домен без ослабления всей политики; понятные формулировки и последовательная структура помогают, как показывают советы по написанию текста. Новые интеграции проходят проверку до подключения к рабочей среде.
Автоматизируйте формирование и проверку заголовка в CI/CD. Настройте оповещения об отчётах, регулярно просматривайте неожиданные блокировки и обновляйте документацию после изменений. CSP остаётся эффективной, только если разработчики понимают правила и быстро обнаруживают конфликт между новой функцией и политикой безопасности.
Начните с аудита загружаемых ресурсов и подготовьте черновой набор директив. Запустите его в режиме отчётов, проверьте основные пользовательские сценарии, исправьте ложные блокировки и только затем включите принудительное применение на тестовом окружении.
Добавьте отчётность, закрепите команду, отвечающую за политику, и внесите проверку заголовка в процесс релиза. Так вы получите измеримый контроль без слепого запрета функций и сможете безопасно развивать приложение.