Что такое CSP (Content Security Policy) — и почему она первой ломает твой же скрипт

Ты добавил один заголовок — и страница побелела. В консоли красное: Refused to execute inline script. Скрипт твой, файл твой, хостинг твой. Заблокировал браузер.
Вот в чём соль CSP: она не умеет отличать твой код от чужого. Она умеет отличать только то, откуда код пришёл. Поэтому первым под нож идёт то, что написано прямо в HTML — то есть, скорее всего, твоё.
Что такое CSP простыми словами
Content Security Policy (CSP) — это заголовок ответа, которым сервер говорит браузеру: «на этой странице выполняй скрипты только отсюда, картинки грузи только оттуда, а больше ни с кем не разговаривай».
Самая скромная политика выглядит так:
Content-Security-Policy: default-src 'self'
Читается: всё — скрипты, стили, картинки, запросы — только со своего домена. default-src работает как запасной вариант для остальных директив: не указал img-src — для картинок сработает он.
Зачем это нужно. Если на страницу как-то попал чужой скрипт — через комментарий, через дырявый виджет, через подменённый файл на CDN — браузер по умолчанию выполнит его без вопросов. Он же лежит в твоём HTML. CSP отбирает у чужого кода это право: нет в списке — не выполняется.
Браузер не знает, какой скрипт твой
Это главное, что стоит принять. Для браузера страница — просто текст. Скрипт, который ты написал руками, и скрипт, который влез через форму, выглядят одинаково: и то и другое — тег <script> внутри HTML.
Значит, судить по содержимому CSP не может. Она судит по источнику:
- файл с твоего домена — свой, если в списке есть
'self'; - файл с чужого домена — свой, только если ты назвал этот домен явно;
- код, написанный прямо в HTML, — ничей, у него нет адреса.
Отсюда правило, которое экономит часы отладки: CSP ломает не «плохой» код, а безадресный. Обработчик onclick="..." прямо в теге, стили внутри страницы, eval() в старой библиотеке — всё это код без источника.
Кстати, eval() и его родня выключаются автоматически, как только в политике появился default-src или script-src. Это не отдельная галочка, это часть сделки.
Три способа разрешить свои скрипты
По источнику. script-src 'self' https://cdn.example.com — выполняй файлы со своего домена и вот с этого адреса. Самый дешёвый путь: вынести весь inline-код в отдельные файлы и больше о нём не думать.
По одноразовому числу (nonce). Сервер на каждый ответ генерирует случайную строку, кладёт её и в заголовок, и в атрибут nonce каждого своего скрипта. Браузер сверяет две копии. Чужой код число не угадает. Важная деталь: строка обязана быть новой на каждый ответ — поэтому чистый статический HTML так не умеет, нужен сервер, который подставляет её на лету.
По хэшу. Считаешь SHA-256 от содержимого скрипта и кладёшь хэш в политику. Годится для пары неизменных кусков, мучительно для живого проекта: поменял пробел — обновляй хэш.
И ловушка, на которой спотыкаются все. Если в директиве рядом с 'nonce-...' стоит 'unsafe-inline', браузер игнорирует 'unsafe-inline'. Так задумано: это запасной вариант для старых браузеров, которые про nonce не знают. Новый браузер увидит nonce — и будет требовать его у каждого inline-скрипта, сколько бы ты ни дописывал разрешений.
Report-Only: политика, которая ничего не ломает
Самая полезная кнопка во всей теме. Заголовок Content-Security-Policy-Report-Only работает так же, только не блокирует: браузер честно считает нарушения и шлёт отчёты на указанный адрес, а страница живёт как жила.
Content-Security-Policy-Report-Only: default-src 'self'; report-to csp-endpoint
Порядок, который не роняет сайт: включаешь Report-Only → неделю смотришь, что бы сломалось → добавляешь недостающие источники → только потом переключаешь на боевой заголовок. Оба заголовка можно держать одновременно: боевой блокирует, второй тихо тестирует следующую версию политики.
Две вещи, которые сэкономят вечер. Report-Only нельзя задать через тег meta в HTML — только настоящим заголовком ответа. И если у тебя вайб-кодинг и хостинг на статике, вставлять политику придётся в конфиг хостинга, а не в разметку — как это делается на Vercel, Netlify и nginx, разобрано в гайде по заголовкам безопасности.
Что с этим делать тебе
Забери один мысленный образ: CSP — это список пропусков на двери, а не металлоискатель. Она проверяет, откуда пришли, а не что принесли. Поэтому:
- начинай с
default-src 'self'в Report-Only; - выноси inline-скрипты в файлы — это чинит 80% нарушений;
- добавляй чужие домены по одному, глядя в отчёты, а не «на всякий случай».
Если политика уже включена и что-то не работает, симптомы и три частые причины разобраны отдельно: почему CSP блокирует мои собственные скрипты.
Нужна ли CSP маленькому сайту?
Если сайт статический и на нём нет чужих виджетов — выгода небольшая. Как только появляются форма, комментарии, чат или сторонняя аналитика, CSP становится вторым слоем на случай, если через них просочится чужой код.
CSP защищает от всего?
Нет. Она ограничивает источники кода на странице и не заменяет проверку данных на сервере. Ошибка CORS, например, к CSP отношения не имеет: это другое правило браузера, про чтение чужих ответов.
Где вообще писать этот заголовок?
Там, где формируется ответ: в конфиге хостинга, в nginx, в middleware фреймворка. Тег meta умеет только боевую политику, и то с оговорками — заголовок надёжнее.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





