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

Напишите политику

Почему это важно Слишком свободная политика пропускает атаку; слишком строгая ломает вашу же страницу, и тогда кто-нибудь выключает CSP "на время". Навык - написать самую строгую политику, при которой страница всё ещё работает. Вы сделаете это в коде, чтобы это работало для любой страницы, а проверка оценит обе половины.

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

Атака, которую нужно остановить

В модуле 10 текст злоумышленника на учебной странице нёс скрипт: блок <script> в гостевой книге (урок 58), <img onerror>, который проскочил мимо игрушечного фильтра (урок 61), и условный код, отправлявший cookie на prize.example (урок 62). Экранирование их исправило. Здесь вы добавляете вторую линию на случай, если какое-то место когда-нибудь пропустят. Внедрённый код обычно приходит в одной из трёх форм, и учебные страницы здесь содержат все три:

  • встроенный блок <script>...</script>;
  • встроенный обработчик события, атрибут вроде onerror="..." у тега изображения;
  • <script src="https://prize.example/x.js">, указывающий на сервер злоумышленника.

Хорошая политика блокирует все три и всё же позволяет странице загрузить свой скрипт приложения, таблицу стилей, изображения, платёжную библиотеку, рамку с видео и свой единственный встроенный скрипт.

Встроенный обработчик события: скрипт, записанный прямо в атрибут HTML, имя которого начинается с on, например onerror или onclick. Браузер выполняет его, когда происходит это событие. CSP считает его встроенным скриптом.

Учебная страница и проверка

practice_site(seed) из watched.leg3a_csp возвращает страницу в виде словаря: её origin и список resources. У каждого ресурса есть kind (script, style, img, font, connect, frame), либо url, либо inline: True, и injected, который равен True для трёх ресурсов злоумышленника. Собственный встроенный скрипт страницы несёт nonce: случайное значение, которое знает только настоящий сервер (урок 66 объясняет это полностью).

{"kind": "script", "url": "https://pay.example/lib.js", "injected": False}
{"kind": "script", "inline": True, "nonce": "y334r23xgecgnryn", "injected": False}
{"kind": "script", "inline": True, "handler": True, "injected": True}

evaluate(policy, page) играет роль браузера. Она возвращает broken (нужные ресурсы, которые блокирует ваша политика) и attacks_run (внедрённые, которые она пропускает). Вы хотите, чтобы оба были пустыми. print_report(policy, page) из watched.leg3d_csp_more выводит то же в читаемом виде.

План

  1. Начните каждую директиву с 'self', чтобы загружались ваши собственные файлы.
  2. Для каждого нужного внешнего URL добавьте его схему и хост, например https://pay.example, в директиву для его вида. Не https: и не *: они впустят и prize.example.
  3. Для собственного встроенного скрипта страницы добавьте 'nonce-VALUE' в script-src. Никогда не 'unsafe-inline'.
  4. Закончите default-src 'self' для всего остального плюс object-src 'none', base-uri 'none' и frame-ancestors 'none', которые ничего не стоят на странице, которой ничего из этого не нужно.

Обратите внимание, что это делает с обработчиком события: никакой источник, который вы можете добавить, не разрешает атрибуты onerror=, кроме 'unsafe-inline', поэтому без этого ключевого слова они все заблокированы. Заметьте также, что у каждого вида свой список. Если ваша страница получает данные с api.example, этот хост должен быть в connect-src, а не в script-src; иначе злоумышленник, способный загрузить туда файл, мог бы выполнить его как скрипт.

Распространённое заблуждение: "script-src https: строг, потому что требует HTTPS". Он требует лишь схему. Любой злоумышленник может разместить скрипт на адресе HTTPS.

На других языках

Когда заголовок готов, каждый сервер ставит его одинаково:

// JavaScript (Express)
app.use((req, res, next) => {
  res.set("Content-Security-Policy", "default-src 'self'; object-src 'none'; base-uri 'none'");
  next();
});
// Go (net/http)
w.Header().Set("Content-Security-Policy", "default-src 'self'; object-src 'none'; base-uri 'none'")
// PHP
header("Content-Security-Policy: default-src 'self'; object-src 'none'; base-uri 'none'");
# nginx
add_header Content-Security-Policy "default-src 'self'; object-src 'none'; base-uri 'none'" always;

В Django пакет django-csp строит заголовок из настроек и добавляет к каждому запросу свежий nonce, так делает и этот сайт.

Итоги

  • Разрешайте ровно те хосты, которые нужны каждому виду ресурсов; никогда * или https: для скриптов.
  • Разрешайте свой встроенный скрипт через nonce; без 'unsafe-inline' внедрённые блоки и обработчики событий блокируются.
  • Добавляйте object-src 'none', base-uri и frame-ancestors, которые не откатываются.
  • Проверяйте обе половины: ничего нужного не сломано, ничего внедрённого не выполнилось.
Твоя очередь

Напишите две функции:

  1. source_for(url): верните схему и хост url, например "https://cdn.example" для "https://cdn.example/v3.js?x=1" (без пути, строки запроса или фрагмента).
  2. write_policy(page): верните строку заголовка CSP для страницы из practice_site. Пропускайте ресурсы с заданным injected. Для каждого другого ресурса найдите его директиву через DIRECTIVE_FOR; каждая директива начинается с 'self' и получает 'nonce-VALUE' для встроенного скрипта или source_for(url) для URL с другого источника (без повторов). Соединяйте через "; ", начиная с default-src 'self' и заканчивая object-src 'none', base-uri 'none' и frame-ancestors 'none'. Не используйте 'unsafe-inline', * или https:.
Оставьте последние строки, которые выводят отчёт для practice_site(seed=0). Тесты пробуют 20 разных учебных страниц и одну сделанную вручную и проверяют и то, что ничего нужного не заблокировано, и то, что ни один внедрённый скрипт не выполняется.

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

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

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