Гайды

Как добавить заголовки безопасности на сайт — за один вечер и без поломок

Иллюстрация: несколько бирок навешиваются на посылку перед отправкой

Заголовки безопасности — редкий случай, когда защита стоит пятнадцати строк конфига и нуля правок в коде. Ты не переписываешь приложение: ты просто дописываешь несколько строк к каждому ответу сервера, и браузер начинает вести себя строже.

Порядок ниже специально такой, чтобы ничего не сломать: сначала заголовки, которые почти невозможно испортить, и только в конце — CSP, и то в безопасном режиме.

Шаг 1. Посмотри, что у тебя сейчас

Одна команда покажет, с чем ты стартуешь:

curl -sI https://твой-сайт.ру | grep -iE 'strict-transport|content-security|x-content-type|referrer-policy|permissions-policy|x-powered-by'

Пусто — нормально, у большинства свежих проектов так и есть. Заодно обрати внимание, если вылезла строка x-powered-by: она бесплатно рассказывает, на чём написан твой сайт. Уберём в конце.

Шаг 2. Добавь три заголовка, которые ничего не ломают

Начни с этих трёх — риск нулевой, польза сразу:

  • X-Content-Type-Options: nosniff — запрещает браузеру угадывать тип файла по содержимому. Без него загруженная пользователем «картинка», внутри которой лежит JavaScript, может выполниться как скрипт.
  • Referrer-Policy: strict-origin-when-cross-origin — при переходе на чужой сайт уходит только твой домен, без пути и параметров. Современные браузеры и так ставят это по умолчанию, но фреймворки и прокси иногда переопределяют — лучше задать явно.
  • Strict-Transport-Security: max-age=15768000 — браузер запомнит, что к тебе можно только по HTTPS, и больше не будет пробовать открытый http. Полгода — минимум, дальше можно поднять до двух лет.

⚠ Одно предостережение по HSTS: включай его, только когда HTTPS у тебя точно работает на всех поддоменах. Браузер запомнит правило на весь max-age, и «откатить» его быстро не выйдет. Если не уверен в поддоменах — не добавляй includeSubDomains, а preload не трогай вообще: попадание в предзагруженный список браузеров — дорога почти в один конец.

Шаг 3. Запрети встраивать твой сайт в чужой iframe

Чтобы поверх твоих кнопок не рисовали чужую страницу, добавь:

Content-Security-Policy: frame-ancestors 'self'

Раньше для этого использовали X-Frame-Options, и он до сих пор работает — но его вариант ALLOW-FROM уже объявлен устаревшим, современные браузеры его игнорируют. frame-ancestors умеет то же самое и больше, поэтому новые проекты пишут сразу его. Хочешь и то и другое ради очень старых браузеров — держи X-Frame-Options: DENY рядом, они не конфликтуют.

Шаг 4. Отключи доступы, которыми ты не пользуешься

Permissions-Policy управляет тем, что странице разрешено просить у устройства. Если сайту не нужны камера, микрофон и геолокация — скажи об этом прямо:

Permissions-Policy: camera=(), microphone=(), geolocation=()

Пустые скобки означают «никому, включая меня». Смысл не в защите от себя, а в чужом коде на странице: сторонний виджет больше не сможет вызвать окно «сайт запрашивает доступ к микрофону» от твоего имени.

Шаг 5. Включи CSP — но в режиме отчётов

Самый мощный заголовок и единственный, которым реально можно уронить страницу. Поэтому первый заход — только наблюдение:

Content-Security-Policy-Report-Only: default-src 'self'

Он ничего не блокирует: браузер лишь пишет в консоль, что бы он запретил. Открой сайт, покликай всё, собери список нарушений — обычно там пара CDN, шрифты и твои же inline-скрипты. Дальше добавляешь источники по одному и только потом меняешь заголовок на боевой Content-Security-Policy. Как читаются директивы и почему nonce не работает на статике — в разборе что такое CSP.

Шаг 6. Пропиши всё это в конфиге хостинга

Место зависит от того, где живёт сайт. Три самых частых варианта.

Vercel — файл vercel.json в корне:

{
  "headers": [
    {
      "source": "/(.*)",
      "headers": [
        { "key": "X-Content-Type-Options", "value": "nosniff" },
        { "key": "Referrer-Policy", "value": "strict-origin-when-cross-origin" },
        { "key": "Strict-Transport-Security", "value": "max-age=15768000" }
      ]
    }
  ]
}

Netlify — блок в netlify.toml:

[[headers]]
  for = "/*"
  [headers.values]
    X-Content-Type-Options = "nosniff"
    Referrer-Policy = "strict-origin-when-cross-origin"

Свой nginx — внутри нужного server:

add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header Strict-Transport-Security "max-age=15768000" always;

Слово always в nginx важно: без него заголовки не попадут в ответы с ошибками — а именно на страницах ошибок защита нужна не меньше.

Что получится

Повтори команду из шага 1 — теперь она выведет четыре-пять строк вместо пустоты. Что изменилось на деле: браузер не выполнит подсунутый файл как скрипт, не отдаст чужому сайту полный адрес страницы, откажется открывать тебя по http, не даст встроить тебя в чужой iframe и не пустит чужой виджет к камере. Всё это — правки в конфиге, ноль изменений в коде приложения.

Дальше стоит пройтись по остальному списку перед публикацией: чеклист безопасности перед запуском. А если после включения CSP страница перестала работать — это ожидаемо, и разбирается по симптомам: почему CSP блокирует мои собственные скрипты.

Заголовки замедлят сайт?

Нет. Это несколько сотен байт в каждом ответе. На фоне одной картинки — незаметно.

Хватит ли заголовков вместо нормального кода?

Не хватит. Они закрывают целый класс браузерных атак, но не проверяют данные и не чинят логику. Считай их ремнём безопасности: полезен всегда, ездить аккуратно не отменяет.

Где смотреть, что получилось?

В инструментах разработчика: вкладка Network, первый запрос документа, раздел Response Headers. Там видно всё, что реально дошло до браузера, — включая заголовки, которые дописал хостинг или CDN поверх твоих.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →