{"canonical_url":"https://engineer.company/uk/glossary/sri/","content_markdown":"# Subresource Integrity\n\n## Що це таке\n\nSubresource Integrity дає сторінці змогу заздалегідь указати, які саме байти має\nмістити скрипт чи таблиця стилів, і змушує браузер відкинути файл, якщо надійшло\nщось інше. Назву зазвичай скорочують до SRI. Сторінка записує криптографічний\nдайджест файлу в атрибут `integrity` на елементі `script` або `link`, який цей\nфайл завантажує. Коли приходить відповідь, браузер проганяє отримані байти через\nту саму хеш-функцію й порівнює результат зі значенням на елементі. Якщо вони\nзбігаються, скрипт виконується або стилі застосовуються як завжди. Якщо\nрізняться, браузер вважає відповідь мережевою помилкою: скрипт так і не\nвиконується, а таблиця стилів так і не застосовується.\n\nЗначення складається з назви хеш-функції, дефіса й самого дайджесту в base64.\nЙого дає одна команда над готовим файлом, а два її запуски показують, як мало\nтреба, щоб відповідь змінилася:\n\n```text\n$ printf \"alert('Hello, world.');\" \u003e hello.js\n$ openssl dgst -sha384 -binary hello.js | openssl base64 -A\nH8BRh8j48O9oYatfu5AZzq6A9RINhZO5H16dQZngK7T62em8MUt1FLm52t+eX6xO\n$ echo \u003e\u003e hello.js\n$ openssl dgst -sha384 -binary hello.js | openssl base64 -A\nqu8P7hCLFcBpas8BOnGmaANCkfXJIpFttDEaxOj0Pq9H6Q8NYjsMb+PVqwuJygVe\n```\n\nІз `sha384-` попереду перший результат і є значенням атрибута для цього\nоднорядкового скрипту. Один доданий у кінці символ нового рядка дає дайджест,\nякий нічим не схожий на перший, і браузер, що тримає перше значення, відкине\nдругий файл.\n\nСпецифікація знає три хеш-функції, SHA-256, SHA-384 і SHA-512, усі з родини\nSHA-2, і на момент написання називає SHA-384 добрим базовим вибором. Атрибут\nможе містити кілька дайджестів через пробіл. Браузер обирає серед них\nнайсильнішу функцію й приймає файл, якщо він збігається з будь-яким дайджестом,\nобчисленим цією функцією. Так сторінка може перейти на сильніший алгоритм або\nпід час переходу приймати дві версії бібліотеки, і жодної миті не нестиме самі\nлише хибні значення.\n\nАтрибут є в `script` і `link`, а те саме значення може їхати в заголовку\nвідповіді `Link`, який попередньо завантажує файл. Чинний текст специфікації —\nїї друге видання, робочий проєкт W3C від робочої групи Web Application Security.\nПерше видання стало рекомендацією W3C у 2016 році.\n\n## Чому це важливо\n\nСторінка, яка вантажить бібліотеку з мережі доставки контенту чи з будь-якого\nхоста, яким її власники не керують, віддає цьому хосту владу виконувати код на\nсторінці. HTTPS захищає файл дорогою через мережу, але нічого не каже про те, що\nхост вирішив надіслати з самого початку. Якщо зламають сховище CDN, захоплять\nобліковий запис, з якого туди публікують, або тихо підмінять файл за звичною\nадресою, кожна сторінка, що його підключає, виконає новий код з усіма\nповноваженнями самої сторінки. Власний код сторінки ніяк не відрізнить одне від\nіншого.\n\nSRI повертає це рішення сторінці. Дайджест обчислює власник сайту над файлом,\nякий він прочитав або зібрав, і цей дайджест подорожує всередині сторінки, з\nвласного сервера сайту. Хост, що віддає щось інше, отримує відмову замість\nвиконання. Сторінка втрачає якусь функцію, доки хтось не погляне, і це помітна\nнесправність з очевидною причиною, а не чужий код, що тихо працює.\n\nДайджест також фіксує версію. Адреса на кшталт `/lib/latest.js` будь-якої миті\nможе почати віддавати нову версію під сторінкою, а дайджест за нею не піде.\nОновлення, якого власник не обирав, перетворюється на відмову для одного\nконкретного елемента, про яку повідомляє подія error.\n\nВарто точно розуміти, чого SRI не робить. Вона перевіряє файл щодо дайджесту,\nале не судить, чи безпечний цей файл. Дайджест бібліотеки, у якій уже є ворожий\nрядок, сумлінно захищає цей ворожий рядок. Вбудованих скриптів вона не\nторкається, це робота Content Security Policy. І вона довіряє сторінці, яка несе\nдайджест, тож сама сторінка все одно має дійти без змін.\n\n## Як це виглядає на практиці\n\nЦей сайт застосовує її до власної таблиці стилів.\n[Сторінка безпеки](/uk/security/) називає Subresource Integrity для таблиці\nстилів: під час збірки бандлу присвоюється відбиток і обчислюється хеш, тож\nбраузер читача може перевірити, що він надійшов без змін. Виконуваний\nJavaScript не публікується, запитів до третіх сторін немає. Читач, який порахує\nхости на вкладці мережі в браузері, знайде один, власний хост сайту.\n\n[Сторінка подяк](/uk/credits/) описує той самий файл з боку збірки: один\nCSS-бандл, який під час збірки склеюється з окремих файлів, отримує хеш вмісту в\nназві й віддається разом із хешем SRI. Відбиток вкладає хеш вмісту файлу в його\nназву, тож змінена таблиця стилів отримує нову адресу, і браузер ніколи не\nсплутає стару копію з кешу з чинною. Значення integrity водночас дає браузеру\nперевірити байти за цією адресою. Збірка створює і те, і те з тих самих байтів\nна одному кроці, тож кожен реліз відправляє таблицю стилів разом із її\nдайджестом, і найпоширеніша помилка з описаних нижче, файл, змінений після\nхешування, майже не має де статися.\n\n## Де виникають проблеми\n\n**Щось між збіркою та браузером переписує файл.** CDN, що мініфікує скрипти,\nпроксі, що вставляє щось у вміст відповіді, або крок розгортання, що переписує\nфайл після обчислення дайджесту, змінює байти вмісту, і браузер відкидає\nрезультат, хоча ніхто нічого не атакував. Повторне стискання gzip або Brotli зі\nзбереженням вмісту не спричиняє такої невідповідності: перевірка використовує\nдекодоване тіло відповіді, а не стиснені байти, передані мережею. Специфікація\nпокладає обов'язок на посередників, які змінюють вміст: вони мають узгоджувати\nдайджест із тим, що віддають, або доставляти оригінал недоторканим, а серверу,\nщо віддає файл, варто надсилати `Cache-Control: no-transform`, щоб попросити їх\nне чіпати його. Надійний порядок — брати дайджест останнім, саме з тих байтів\nдекодованого вмісту, які перевірятиме браузер.\n\n**Файл з іншого походження приходить без CORS.** Специфікація вимагає, щоб\nперевірка цілісності файлу з іншого походження йшла через CORS, і називає спробу\nбез нього логічною помилкою. Наприклад, елемент може використовувати\n`crossorigin=\"anonymous\"`, а хост має відповісти заголовком, який дозволяє\nподілитися файлом. `crossorigin=\"use-credentials\"` також використовує CORS, із\nзаголовками сервера, які явно дозволяють походження запиту й передавання\nоблікових даних. Без CORS-запиту та узгодженої політики сервера браузер блокує\nфайл, а не завантажує його без перевірки. Це правило захищає інші сайти: без\nнього зловмисник міг би завантажити приватну відповідь із вгаданим дайджестом і\nз результату дізнатися, наприклад, чи читач там увійшов в обліковий запис.\n\n**Дайджест приходить звичайним HTTP.** SRI захищає сторінку від\nскомпрометованого хоста з файлами, але ніколи від когось на мережевому шляху. На\nсторінці без HTTPS той, хто може переписати файл дорогою, так само може\nпереписати або видалити дайджест у сторінці, тому специфікація радить віддавати\nметадані цілісності лише в безпечний контекст.\n\n**Хеш-функція виявляється такою, яку браузер пропускає.** Специфікація знає лише\nSHA-256, SHA-384 і SHA-512 і радить браузерам відкидати відомо слабкі функції,\nяк-от MD5 і SHA-1. Несподіванка в тому, що стається зі значенням поза цим\nпереліком: браузер його ігнорує, а атрибут, що складається лише з проігнорованих\nзначень, вважається таким, що метаданих не має зовсім, тож файл завантажується\nбез перевірки. Інструмент збірки, який уміє робити відбиток через MD5, як-от у\nHugo, полегшує випадкову публікацію такого значення.\n\n**Відкинутий файл тягне за собою всю сторінку.** Коли перевірка не проходить,\nбраузер запускає на елементі подію error, і скрипта чи таблиці стилів просто\nнемає. Для бібліотеки, без якої сторінка не працює, специфікація пропонує\nперехопити подію й завантажити запасну копію з довіреного, хоч і повільнішого\nджерела, наприклад із власного сервера сайту. Без такого запасу захист\nспрацьовує як задумано, а читач однаково отримує зламану сторінку.\n\n**Перевіряються лише елементи з дайджестом.** Атрибут `integrity` на одному\nскрипті нічого не каже про наступний, який хтось додасть без нього, і перегляд\nскриптів, що мають дайджест, ніколи не виявить того, у якого його бракує. Проєкт специфікації\nдодає заголовок відповіді, що закриває це з боку сервера. `Integrity-Policy` з\n`blocked-destinations=(script)` блокує кожен зовнішній скрипт, що приходить без\nметаданих цілісності, а `Integrity-Policy-Report-Only` спершу лише перелічує\nтакі скрипти, щоб їх виправили до того, як щось заблокують.\n\n## Що почитати далі\n\n- [Subresource Integrity](https://www.w3.org/TR/SRI/) — чинний проєкт з\n  алгоритмом перевірки, заголовками `Integrity-Policy` і примітками про проксі,\n  звичайний HTTP та витоки між походженнями.\n- [Subresource Integrity, рекомендація W3C 2016 року](https://www.w3.org/TR/2016/REC-SRI-20160623/)\n  — перше видання, стабільна рекомендація, з якої виріс проєкт.\n- [Fetch Standard](https://fetch.spec.whatwg.org/) — де метадані цілісності\n  запиту звіряються з тілом відповіді, і протокол CORS, від якого залежить\n  перевірка між походженнями.\n- [Hugo: resources.Fingerprint](https://gohugo.io/functions/resources/fingerprint/)\n  — як генератор статичних сайтів робить відбиток файлу під час збірки й\n  повертає відповідне значення integrity.\n- [FIPS 180-4, Secure Hash Standard](https://csrc.nist.gov/pubs/fips/180-4/upd1/final)\n  — федеральний стандарт США, що визначає SHA-256, SHA-384 і SHA-512.\n\n\u003chttps://engineer.company/uk/glossary/sri/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як Subresource Integrity дає браузеру відкинути скрипт чи таблицю стилів, змінені після хешування, і що ламається, коли файл і його дайджест розходяться.","formats":{"gemtext":"https://engineer.company/uk/glossary/sri/index.gmi","gopher":"https://engineer.company/uk/glossary/sri/gophermap","html":"https://engineer.company/uk/glossary/sri/","json":"https://engineer.company/uk/glossary/sri/index.json","markdown":"https://engineer.company/uk/glossary/sri/index.md","pdf":"https://engineer.company/uk/glossary/sri/index.pdf"},"kind":"page","language":"uk","title":"Що таке Subresource Integrity?","url":"https://engineer.company/uk/glossary/sri/","version":1}