Программа курса Урок 66 из 156 · Content Security Policy и рамки
Content Security Policy и рамки

Nonce, хэши и report-only

Почему это важно Почти у каждого настоящего сайта есть несколько собственных встроенных скриптов. Если единственный способ сохранить их работу - 'unsafe-inline', CSP вообще перестаёт защищать от внедрения. Nonce и хэши впускают ваши скрипты и не пускают внедрённые. Режим report-only позволяет включить политику, ничего не сломав для посетителей в первый же день.

Представьте концерт, где браслет каждого вечера другого цвета и его объявляют только персоналу за час до открытия дверей. Поддельный браслет с прошлой недели бесполезен. Nonce - сегодняшний браслет для ваших встроенных скриптов.

Nonce

Nonce: сокращение от "number used once", число на один раз. Свежее случайное значение, которое сервер создаёт для каждого ответа, кладёт в заголовок как 'nonce-VALUE' и также вписывает в каждый свой встроенный тег script как nonce="VALUE".

Content-Security-Policy: script-src 'self' 'nonce-4fT9qLx2Zb8wRk1e'

<script nonce="4fT9qLx2Zb8wRk1e">startShop();</script>      runs
<script>sendCookies();</script>                          blocked: no nonce

Злоумышленник, внедривший тег script, не знает значения этого ответа, поэтому его скрипт отклоняется. Это верно благодаря трём правилам:

  • Непредсказуемость: не меньше 128 бит из безопасного источника случайности, например secrets.token_urlsafe(16) в Python.
  • Свежесть для каждого ответа: никогда не фиксированное значение в файле настроек, и осторожнее с кэшами страниц, которые отдали бы всем один и тот же nonce.
  • Только на ваших тегах: шаблон, который добавляет nonce к любому тегу script, включая построенные из пользовательского ввода, отдаёт браслет злоумышленнику.

Этот сайт делает это через django-csp: каждый встроенный скрипт в шаблонах пишется как <script nonce="{{ request.csp_nonce }}">, а пакет кладёт совпадающее значение в заголовок.

Хэши

Источник-хэш: 'sha256-BASE64', отпечаток SHA-256 точного текста внутри тега script. Если текст совпадает, он выполняется. Полезно для статических страниц, где ничто не может добавлять nonce к каждому ответу.

import base64, hashlib
code = "startShop();"          # exactly what is between the tags
print("'sha256-" + base64.b64encode(hashlib.sha256(code.encode()).digest()).decode() + "'")

Важен каждый байт: лишний пробел или перевод строки дают другой хэш. Хэши и nonce охватывают только встроенные блоки <script>, а не атрибуты onclick= (редко используемое ключевое слово 'unsafe-hashes' может разрешить один захэшированный обработчик, но перенести его чище). Переносите обработчики в свой скрипт через addEventListener.

Почему 'unsafe-inline' иногда оставляют

Когда указан nonce или хэш, браузеры, которые их понимают, игнорируют 'unsafe-inline'. Очень старые браузеры не понимают nonce, поэтому откатываются к 'unsafe-inline', и сайт там всё ещё работает. Поэтому политика floati.life перечисляет оба. Но без nonce или хэша 'unsafe-inline' позволяет выполняться каждому внедрённому скрипту.

Ещё шаг дальше - 'strict-dynamic': скрипт, которому вы доверились через nonce, может загружать другие скрипты, и браузеры, которые это поддерживают, затем игнорируют списки хостов. Это подходит большим приложениям, которые загружают код на лету. (Учебная проверка это не моделирует.)

Безопасное внедрение: report-only

Content-Security-Policy-Report-Only: второй заголовок с тем же синтаксисом. Браузер ничего не блокирует, но сообщает, что он заблокировал бы, в консоли и, если попросите, по адресу на вашем сервере.

Reporting-Endpoints: csp="https://shopd.example/csp-reports"
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self' 'nonce-...'; report-to csp

report-to называет конечную точку из заголовка Reporting-Endpoints. Старые руководства используют report-uri https://...; многие сайты отправляют оба, а браузеры, понимающие report-to, игнорируют report-uri. Разумный порядок внедрения: отправляйте новую политику как report-only неделю-две, исправьте то, о чём она сообщает, затем переключите её на применяющий заголовок. Можно отправлять применяющую политику и более строгую report-only рядом.

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

Распространённое заблуждение: "report-only защищает посетителей, пока я тестирую". Она никого не защищает. Это инструмент измерения. Не оставляйте политику в report-only на месяцы.

На других языках
// JavaScript (Node)
const nonce = require("crypto").randomBytes(16).toString("base64");
// Go
b := make([]byte, 16); rand.Read(b)   // crypto/rand
nonce := base64.StdEncoding.EncodeToString(b)
// PHP
$nonce = base64_encode(random_bytes(16));

Итоги

  • Nonce - свежее, неугадываемое значение для каждого ответа, которое отмечает ваши собственные встроенные скрипты.
  • Хэш разрешает один точный встроенный скрипт; любое изменение его текста требует нового хэша.
  • 'unsafe-inline' игнорируется, когда указан nonce или хэш, и опасен, когда их нет.
  • Внедряйте через Content-Security-Policy-Report-Only, затем применяйте; храните отчёты на своём сервере.

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.