Целостность подресурсов для сторонних скриптов и таблиц стилей

Что это такое

MDN (указан в источниках) описывает проверку целостности подресурсов как защиту от взломанного стороннего хоста: атрибут integrity содержит один или несколько хешей с префиксами sha256-, sha384- или sha512-, и перед выполнением скрипта или применением таблицы стилей браузер хеширует полученное содержимое и сравнивает. Он использует только самый сильный из указанных алгоритмов, принимает совпадение с любым перечисленным значением для этого алгоритма, а при несовпадении отклоняет ресурс с сетевой ошибкой. Механизм применяется к <script> и к <link> со значением rel, равным stylesheet, preload или modulepreload. Спецификация W3C (указана в источниках) устанавливает, что целостность подресурсов требует CORS: ресурс с другого источника необходимо запрашивать с атрибутом crossorigin, а сервер должен отвечать с Access-Control-Allow-Origin, иначе проверку выполнить нельзя.

Почему это важно

Загрузка https://cdn.example/lib.js означает, что страница выполняет всё, что отдаёт этот хост, как сейчас, так и после его взлома, продажи или перехвата через DNS. Хеш превращает «доверять хосту» в «доверять именно этому файлу» — это та же дисциплина, что фиксация зависимости по хешу.

Как применять

• Вычисляйте хеш точных байтов, которые проверили: cat lib.js | openssl dgst -sha384 -binary | openssl base64 -A (из MDN), либо берите значение, выданное сборщиком.
• Фиксируйте только версионированные URL (/lib@1.2.3/lib.min.js); URL «latest» перестанет проходить проверку, как только поставщик обновит его, что и означает правильную работу функции.
• Добавляйте crossorigin="anonymous" к каждому элементу с другого источника с integrity; без этого браузер вообще не загрузит ресурс.
• Рассматривайте обновление хеша как обновление зависимости: получите новый файл, проверьте diff или журнал изменений, пересчитайте хеш, сделайте коммит.
• Следите в системе ошибок за отказами загрузки зафиксированного ресурса (скрипт так и не определяет свою глобальную переменную); внезапная волна означает, что поставщик изменил файл или кто-то его подменил.
• Сочетайте с Content Security Policy, ограничивающей источники скриптов; SRI проверяет содержимое, CSP — источник.

Подводные камни

Ресурсы, обоснованно меняющиеся от запроса к запросу (менеджеры тегов, A/B-скрипты, персонализированные сборки), нельзя зафиксировать; либо размещайте неизменную копию у себя, либо принимайте это доверие. Хеширование минифицированного файла после конвейера, который минифицирует его повторно. Забытый факт, что скрипт, загруженный зафиксированным скриптом во время выполнения, не охвачен проверкой. CDN без заголовков CORS, из-за которого каждая зафиксированная загрузка завершается неудачей.