{"canonical_url":"https://engineer.company/uk/glossary/csp/","content_markdown":"# Content Security Policy\n\n## Що це таке\n\nContent Security Policy — це набір правил, які вебсайт передає браузеру: що його\nсторінкам дозволено виконувати, завантажувати й надсилати. Далі браузер сам\nстежить за цими правилами від імені сайту. Назву майже завжди скорочують до CSP.\nСайт надсилає правила в заголовку відповіді `Content-Security-Policy` або вписує\nїх просто в сторінку через елемент `meta`, і відтоді кожен скрипт, таблицю\nстилів, зображення, шрифт, фрейм чи з'єднання, яких правила не дозволяють,\nбраузер відхиляє ще до завантаження.\n\nПолітика — це короткий рядок директив, розділених крапкою з комою. Кожна\nдиректива називає один тип ресурсу чи поведінки та джерела, які вона приймає.\nТут для зручності кожна директива стоїть в окремому рядку, хоча мережею вона йде\nяк одне значення заголовка:\n\n```text\ndefault-src 'self';\nscript-src 'nonce-q8Zt3VwR1mKx7NpL2cYfJA==' 'strict-dynamic';\nobject-src 'none';\nbase-uri 'none';\nform-action 'self';\nframe-ancestors 'none'\n```\n\nСловник невеликий. `'self'` означає власне походження сторінки. Хост на кшталт\n`https://static.example.com` або схема на кшталт `https:` додають інші джерела.\n`'none'` не дозволяє нічого. Nonce — це випадкове значення, яке сервер генерує\nдля однієї конкретної відповіді й записує і в політику, і на кожен елемент\n`script`, за який ручається. Хеш — це дайджест точного тексту вбудованого\nскрипту, тож виконатися може саме цей скрипт, а інший уже ні. Два ключові слова,\n`'unsafe-inline'` та `'unsafe-eval'`, знову вимикають захист, і їхні назви —\nчесне попередження.\n\n`default-src` — запасний варіант для директив завантаження, які політика\nпропустила: `script-src`, `style-src`, `img-src`, `connect-src` та інших. Тільки\nдля них. Директиви, що керують поведінкою, а не завантаженням, серед них\n`base-uri`, `form-action` і `frame-ancestors`, лишаються без обмежень, доки їх\nне прописати явно.\n\nПолітика може працювати й у режимі спостереження. Надіслана як\n`Content-Security-Policy-Report-Only`, вона нічого не блокує, а повідомляє про\nкожне порушення на кінцеву точку, вказану через `report-to`, яка спирається на\nReporting API браузера. Старіша директива `report-uri` застаріла на її користь.\nЧинний текст стандарту — Content Security Policy Level 3, робочий проєкт W3C від\nробочої групи Web Application Security.\n\n## Чому це важливо\n\nCSP створювали проти міжсайтового скриптингу, який зазвичай називають XSS.\nЗловмисник вставляє на сторінку довільний текст через поле коментаря, пошуковий\nзапит, який сторінка повторює у своєму HTML, або скомпрометовану залежність, і\nбраузер виконує цей текст як скрипт з усіма повноваженнями власного коду сайту.\nТакий скрипт може читати сторінку, діяти від імені користувача, що увійшов, і\nнадсилати знайдене куди завгодно. Перший захист — правильне екранування виводу,\nі воно мусить бути правильним у кожному шаблоні, в кожному рядку, щоразу. CSP —\nдругий захист. Коли помилка екранування все ж проскакує, підкинутому скрипту ще\nтреба пройти крізь політику, а політика, яка виконує лише скрипти з nonce саме\nцієї відповіді, його не пропустить.\n\nВона також обмежує, куди може дотягнутися скрипт, який таки виконався.\n`connect-src` визначає, з якими хостами скрипт може спілкуватися, і цим звужує,\nкуди скімер може відправити зібране. `frame-ancestors` визначає, які сайти\nможуть показувати сторінку у фреймі. Це стандартний захист від клікджекінгу,\nколи одну сторінку накладають на іншу, щоб клік потрапив туди, куди користувач і\nне збирався натискати. `form-action` визначає, куди можуть надсилатися форми, а\n`base-uri` не дає підкинутому елементу `base` непомітно перенаправити кожну\nвідносну адресу на сторінці.\n\nВарто точно розуміти, кого саме захищає CSP. Вона працює в браузері, отже,\nоберігає читача сторінки від вмісту, який туди підклав зловмисник. Серверу від\nцього ж читача вона нічим не допомагає, бо той може змінити або прибрати\nзаголовок у власному браузері за лічені секунди. Політика — привід довіряти\nсторінці менше, але ніколи не привід більше довіряти запиту.\n\nГоловна ціна — інвентаризація. Політика змушує команду знати кожне походження, з\nякого вантажаться її сторінки, кожен вбудований скрипт і кожен обробник подій,\nзаписаний як атрибут. Новий сайт можна з першого коміту будувати під сувору\nполітику майже задарма. Старіший сайт із вбудованими обробниками, менеджером\nтегів і кількома віджетами спершу платить за прибирання, і саме це прибирання\nзазвичай і є справжнім проєктом.\n\n## Як це виглядає на практиці\n\nЦей сайт і сам живе за такою політикою. [Сторінка безпеки](/uk/security/)\nназиває сувору Content Security Policy, оголошену в самій сторінці, з\n`form-action 'none'`, бо сайт нікуди не надсилає форм. Кожна HTML-сторінка\nвказує `script-src 'none'`: ні JavaScript, ні service worker не виконуються.\nСайт не робить запитів до третіх сторін; усе, що потрібно сторінці, надходить\nіз власного хоста сайту, тож дозволяти майже нічого.\n\nЗастосунку, де користувачі входять в обліковий запис, короткого переліку\nдозволених джерел замало. На платформі з професійними та організаційними даними\n[проксі-мідлвар Next.js встановлює Content-Security-Policy з nonce для кожного запиту та `strict-dynamic`](/uk/portfolio/hardened-the-application-with-nonce-based-csp/),\nа також HSTS і SameSite cookies. Свіжий nonce у кожній відповіді означає, що\nвиконаються лише ті елементи `script`, які сервер позначив саме в цій відповіді.\nІз `strict-dynamic` у політиці скрипт, якому довіряє nonce, може сам\nпідвантажувати інші скрипти, тож політиці не треба перелічувати кожен хост, з\nякого бандл тягне свої частини. Та сама сторінка прямо каже, де закінчується\nроль браузера. Її робоче припущення таке: клієнт вороже налаштований, тому права\nдоступу сервер перевіряє повторно на кожен запит, а фронтендні обмеження\nрозглядаються лише як UX. CSP там — один із кількох рівнів. Вона захищає\nкористувачів від підкинутого коду, а те, кому що дозволено, вирішується деінде.\n\n## Де виникають проблеми\n\n**Політику вмикають, і пів сайту перестає працювати.** Сувора політика, одразу\nвідправлена в режим примусу, блокує вбудований скрипт, про який усі забули, і\nтег відстеження, який хтось додав два роки тому. Спершу надсилайте її як\n`Content-Security-Policy-Report-Only`, читайте звіти, доки вони не вщухнуть,\nдозвольте або приберіть кожне джерело, яке вони називають, і лише тоді вмикайте\nпримус. Заголовок report-only має бути справжнім заголовком, бо специфікація не\nпідтримує його в елементі `meta`.\n\n**Перелік довіряє цілому хосту.** `script-src https://cdn.example.com` дозволяє\nкожен файл на цьому хості, зокрема старі версії бібліотек і кінцеві точки, які\nповертають введене користувачем як скрипт. Специфікація сама визнає, що\nрозгорнути політику, яка справді працює проти міжсайтового скриптингу, складно,\nі радить те, що називає Strict CSP: `script-src` з nonce або хешів разом із\n`'strict-dynamic'`, плюс `base-uri` зі значенням `'self'` або `'none'`.\n\n**Вважають, що `'unsafe-inline'` дозволяє будь-який вбудований скрипт.** Щойно в\nтому самому переліку джерел з'являється nonce чи хеш, браузери, які їх\nрозуміють, ігнорують `'unsafe-inline'`. Це правило дає політиці змогу лишити\n`'unsafe-inline'` як запасний варіант для браузерів, надто старих для nonce,\nтоді як сучасні застосовують суворий перелік. І воно ж дивує команду, яка додала\nnonce одному скрипту й побачила, що решта вбудованих скриптів тепер заблокована.\n\n**Nonce перестає бути секретом.** Специфікація вимагає нового значення щоразу,\nколи надсилається політика, і просить щонайменше 128 біт від криптографічно\nстійкого генератора. Nonce, жорстко вписаний у шаблон, або ціла сторінка, яка\nразом зі своїм nonce лежить у спільному кеші й віддається всім, дає зловмиснику\nсаме те значення, яке потрібне, щоб позначити власний скрипт.\n\n**Політика в елементі `meta` робить менше, ніж та сама політика в заголовку.**\nБраузер ігнорує `frame-ancestors`, `report-uri` і `sandbox`, коли вони приходять\nтаким шляхом, а політика діє лише на те, що стоїть після елемента в документі,\nтож усе вище нього в head завантажується без перевірки. Сайт, який не має впливу\nна заголовки відповіді, все одно отримує реальний захист від політики в `meta`,\nрозміщеної в head якомога раніше, але захист від показу сторінки в чужих фреймах\nпотребує заголовка.\n\n**Друга політика затягує, а не послаблює.** Відповідь може нести кілька політик,\nвід фреймворку, проксі та CDN, і ресурс мусить пройти кожну з них. Додана\nполітика здатна лише обмежувати, тож поблажливий заголовок, доданий далі в\nланцюжку, щоб розблокувати запит, нічого не змінить. Виправлення треба вносити в\nту політику, яка заблокувала.\n\n## Що почитати далі\n\n- [Content Security Policy Level 3](https://www.w3.org/TR/CSP3/) — сам стандарт,\n  із рекомендацією Strict CSP і розділами про те, як nonce перехоплюють і\n  викрадають.\n- [HTML Standard: елемент meta](https://html.spec.whatwg.org/multipage/semantics.html)\n  — прагма, що застосовує політику, оголошену в сторінці, директиви, які вона\n  відкидає, і чому ресурси, завантажені до неї, можуть проскочити.\n- [Reporting API](https://www.w3.org/TR/reporting-1/) — механізм кінцевих точок,\n  на який спирається `report-to`, щоб читати порушення ще до ввімкнення примусу.\n- [Trusted Types](https://www.w3.org/TR/trusted-types/) — супутній стандарт,\n  який вмикає директива `require-trusted-types-for`, спрямований проти скриптів,\n  підкинутих через DOM.\n\n\u003chttps://engineer.company/uk/glossary/csp/\u003e\n","date_modified":"2026-10-30T12:43:03Z","description":"Як Content Security Policy не дає виконатися підкинутому скрипту, як запровадити її, нічого не зламавши, і які помилки тихо залишають її відкритою.","formats":{"gemtext":"https://engineer.company/uk/glossary/csp/index.gmi","gopher":"https://engineer.company/uk/glossary/csp/gophermap","html":"https://engineer.company/uk/glossary/csp/","json":"https://engineer.company/uk/glossary/csp/index.json","markdown":"https://engineer.company/uk/glossary/csp/index.md","pdf":"https://engineer.company/uk/glossary/csp/index.pdf"},"kind":"page","language":"uk","title":"Що таке Content Security Policy?","url":"https://engineer.company/uk/glossary/csp/","version":1}