{"canonical_url":"https://engineer.company/uk/glossary/sql-injection/","content_markdown":"# SQL-ін'єкція\n\n## Що це таке\n\nSQL-ін'єкція, англійською SQL injection, часто скорочено SQLi, — це атака, за\nякої застосунок складає SQL-команду з тексту, що надійшов від когось іншого, і\nбаза даних зрештою читає частину цього тексту як SQL, а не як значення.\nУкраїнською її ще називають впровадженням SQL-коду. Common Weakness Enumeration\nведе цю ваду як CWE-89 і описує її як команду, повністю або частково зібрану з\nвхідних даних ззовні, без попередньої нейтралізації символів, що мають у SQL\nособливе значення. Шпаргалка OWASP із запобігання формулює те саме простіше:\nатака спрацьовує, коли дані, яким не можна довіряти, стають частиною синтаксису\nзапиту.\n\nКорінь проблеми в тому, що SQL не проводить чіткої межі між інструкціями команди\nй даними всередині неї. Одна одинарна лапка завершує рядковий літерал, і все, що\nзловмисник напише після неї, розбирається як продовження SQL. Два дефіси\nпочинають коментар, і так можна відкинути решту команди, яку написав розробник.\nКрапка з комою, там, де це дозволяють база даних і драйвер, завершує одну\nкоманду й починає наступну. Жоден із цих знаків не екзотичний: ті самі символи\nтрапляються в прізвищах і довільному тексті.\n\nПосібник OWASP Web Security Testing Guide поділяє атаки на три класи за тим, як\nрезультати потрапляють до зловмисника. Внутрішньоканальні (in-band) атаки\nотримують відповідь тим самим каналом, яким її викликали, зазвичай просто на\nсторінці застосунку. Позаканальні (out-of-band) змушують базу даних доставити\nрезультати в інше місце, наприклад окремим HTTP-з'єднанням. Інференційні, або\nсліпі, атаки не отримують даних узагалі й відновлюють їх по одному питанню за\nраз, спостерігаючи, як поводиться застосунок. Посібник називає п'ять поширених\nтехнік у цих класах: оператор `UNION`, що приєднує до першого `SELECT` ще один,\nбулеві умови, навмисно спровоковані помилки, передавання даних окремим каналом і\nнавмисне сповільнення відповіді.\n\nSQL-ін'єкція належить до ширшої родини. У CWE вона стоїть під загальною вадою\nін'єкції, CWE-74, поруч із міжсайтовим скриптингом, а OWASP Top Ten 2025 року\nвідносить обидві до категорії A05 Injection. Спільне в них одне: дані\nперетинають межу й потрапляють туди, де їх читають як інструкції. Тут\nінтерпретатором є SQL-парсер бази даних, а ліки полягають у тому, щоб тримати\nкожне значення повністю поза текстом SQL.\n\n## Чому це важливо\n\nШкода залежить від того, що дозволено обліковому запису бази даних, під яким\nпрацює застосунок, а дозволено йому часто багато. CWE-89 перелічує читання\nданих, яких зловмисник ніколи не мав бачити, обхід автентифікації без знання\nпароля, зміну даних, що визначають, кому що можна, зміну або видалення записів,\nа за деяких налаштувань і виконання команд операційної системи. OWASP на\nсторінці про атаку додає адміністративні операції: вимкнення бази даних, читання\nвмісту з диска сервера бази даних і захоплення цього сервера з правами\nадміністратора.\n\nОбидва джерела вважають цю ваду серйозною. CWE оцінює ймовірність експлуатації\nяк високу, а сторінка OWASP про атаку описує ваду як таку, яку легко знайти і\nлегко використати. Вона є в кожному випуску CWE Top 25 Most Dangerous Software\nWeaknesses з 2019 по 2025 рік. Запис CWE також згадує хвилю 2008 року, коли один\nі той самий рядок атаки, що спрацьовував проти багатьох різних програм, дав\nзмогу зламати велику кількість вебсерверів і змусити їх роздавати шкідливий код.\n\nЗахист натомість добре відомий і дешевий. Шпаргалка OWASP ставить на перше місце\nпідготовлені запити (prepared statements) з прив'язаними параметрами, і CWE теж\nїх рекомендує: SQL і значення передаються окремо, тож база даних не може\nсплутати одне з іншим. Усе інше, від мінімальних привілеїв до ретельної обробки\nпомилок, — це додатковий шар, що обмежує шкоду, коли помилка все ж проскочить.\n\n## Як це виглядає на практиці\n\nВізьмімо інтернет-магазин, сторінка історії замовлень якого шукає замовлення за\nадресою електронної пошти, введеною у форму. Розробник складає SQL за допомогою\nf-рядка в Python:\n\n```python\ncur.execute(f\"SELECT id, total FROM orders WHERE email = '{email}'\")\n```\n\nВідвідувач вводить у поле `x' OR '1'='1`. Програма вставляє це як є, і база\nданих отримує таке:\n\n```sql\nSELECT id, total FROM orders WHERE email = 'x' OR '1'='1'\n```\n\nЛапка після `x` закриває рядок, який відкрив розробник, а умова `OR` після неї\nзавжди істинна, тож база даних повертає всі замовлення з таблиці. CWE-89 і\nпосібник із тестування використовують той самий трюк із завжди істинною умовою,\nякий може ще й змусити форму входу впустити відвідувача, що не знає ні імені\nкористувача, ні пароля.\n\nГірше введення завершує команду й починає іншу. У прикладі із запису CWE як\nназву товару вводять `name'; DELETE FROM items; --`, тож за першою командою йде\nдруга, а дефіси перетворюють решту на коментар. Чи це виконається, залежить від\nбази даних і драйвера, і чимало сучасних інтерфейсів таке відхиляють.\n`PQexecParams` у PostgreSQL приймає щонайбільше одну SQL-команду в рядку, і\nдокументація вважає це певним додатковим захистом від SQL-ін'єкцій. Модуль\n`sqlite3` у Python видає помилку, щойно `execute()` отримує більше однієї\nкоманди, а psycopg відмовляється виконувати кілька команд в одному виклику, якщо\nпередано параметри. Ніщо з цього не зупиняє завжди істинну умову вище, якій\nвистачає однієї команди.\n\nВиправлення полягає в тому, щоб передавати значення окремо. PEP 249, стандарт\nінтерфейсу баз даних у Python, вимагає, щоб кожен драйвер оголошував свій стиль\nзаповнювачів у константі модуля `paramstyle`, і перелічує п'ять стилів: `qmark`\n(`?`), `numeric` (`:1`), `named` (`:name`), `format` (`%s`) і `pyformat`\n(`%(name)s`). Модуль `sqlite3` закріплений за стилем `qmark` і також приймає\n`named`. Psycopg, драйвер для PostgreSQL, приймає `%s` і `%(name)s`:\n\n```python\ncur.execute(\n    \"SELECT id, total FROM orders WHERE email = %s\",\n    (email,),\n)\n```\n\n`%s` схожий на форматування рядків у Python, але нічого не форматується: SQL і\nкортеж значень доходять до драйвера як два окремі аргументи. Psycopg 3 тримає їх\nокремо всю дорогу й надсилає команду та її параметри на сервер нарізно, а не\nзливає їх на клієнті. Шпаргалка OWASP показує це на власному прикладі введення,\n`tom' or '1'='1`: прив'язане як параметр, воно стає просто дивним іменем\nкористувача, яке шукають буквально, і воно ні з чим не збігається.\n\nPostgreSQL пропонує такий самий поділ і в чистому SQL. `PREPARE` фіксує команду\nз нумерованими параметрами, а `EXECUTE` згодом передає значення:\n\n```sql\nPREPARE order_lookup (text) AS\n    SELECT id, total FROM orders WHERE email = $1;\nEXECUTE order_lookup('x'' OR ''1''=''1');\n```\n\nВороже введення, записане тут як SQL-літерал, надходить у `$1` як одна дивна\nадреса електронної пошти й не знаходить жодного замовлення.\n\nНа платформі з професійними та організаційними даними вхідні дані валідують ще\nдо того, як щось потрапить у базу даних, а потім\n[серверна частина входить до бази під роллю з мінімальними привілеями](/uk/portfolio/hardened-the-application-with-nonce-based-csp/),\nяка може лише виконувати функції застосунку, і все параметризовано.\nПрив'язування не дає даним стати SQL, а вузька роль обмежує, куди може дістатися\nпомилка.\n\n## Де виникають проблеми\n\n**Рядок усе одно склеюють.** F-рядок, оператор `%`, `+` чи `.format()` вливають\nзначення в SQL ще до того, як його побачить драйвер, і так само діє заповнювач,\nузятий у лапки, як-от `'%s'`. OWASP зазначає, що склеювання недовірених значень\nіз SQL до підготовки запиту зводить увесь захист нанівець, а документація\npsycopg каже розробникам ніколи не використовувати `%` чи `+`, щоб вливати\nзначення в запити. Передавайте кожне значення другим аргументом `execute()`, а\nзаповнювач лишайте без лапок.\n\n**Екранування вручну.** Подвоєння лапок чи додавання зворотних скісних рисок\nздається рівноцінним, але правила залежать від діалекту SQL і його налаштувань.\nПриклад OWASP — режим MySQL `NO_BACKSLASH_ESCAPES`, який вимикає екранування\nзворотною скісною рискою, і шпаргалка рішуче не радить покладатися на\nекранування. Замініть рядки, екрановані вручну, прив'язаними параметрами.\n\n**Валідація або WAF як рішення.** Валідація ловить помилки, але довільний текст\nмусить допускати символи, потрібні зловмисникові: у записі CWE прикладом є\nпрізвище O'Reilly, яке, найімовірніше, пройде валідацію і все одно містить\nлапку. Списки заборонених слів мають шпарини, а CWE оцінює ефективність\nбрандмауера застосунків лише як помірну. OWASP каже прямо: валідоване значення\nвід цього не стає безпечним для склеювання з SQL. Валідуйте далі заради\nкоректності, а прив'язуйте заради безпеки.\n\n**Назви таблиць, стовпців або порядок сортування з введення.** Заповнювачі\nпідставляють лише значення, тож розробника, якому треба дати користувачеві\nвибрати стовпець чи напрям `ORDER BY`, тягне вставити текст напряму. OWASP\nрадить зіставляти кожен вибір із невеликим набором назв, якими володіє сам\nзастосунок, і відхиляти все інше, наприклад перетворювати запитаний напрям на\nлітерал `ASC` або `DESC`. Коли назва справді мусить бути динамічною, модуль\n`psycopg.sql` уміє складати ідентифікатори, хоча OWASP зауважує, що навіть\nправильно взята в лапки назва не обмежує, до яких таблиць можна спрямувати\nзастосунок.\n\n**Збережені процедури, які вважають безпечними.** Виклик процедури з\nприв'язаними аргументами захищає сам виклик, а не SQL, який процедура будує\nвсередині. CWE зазначає, що збережені процедури запобігають деяким типам\nSQL-ін'єкцій, але не виключають інших. Усередині бази даних використовуйте\nстатичний SQL або прив'язуйте значення й у динамічному SQL; у PostgreSQL це\n`EXECUTE ... USING` для значень і `format('%I', ...)` для ідентифікаторів.\n\n**ORM, у який вклеюють рядки.** Об'єктно-реляційне відображення (ORM) прив'язує\nзначення, коли ним користуються як задумано, і CWE визнає за шарами збереження\nна кшталт Hibernate значний захист за правильного використання. OWASP додає, що\nзапити Hibernate все одно можна атакувати, коли розробники склеюють введення з\nтекстом запиту. Користуйтеся параметрами ORM, а не складанням рядків.\n\n**Обліковий запис застосунку з правами адміністратора.** Якщо обліковий запис\nможе все, то може й зловмисник. OWASP радить облікові записи лише для читання\nтам, де потрібне тільки читання, окремого користувача бази даних для кожного\nвебзастосунку, представлення (views), що показують лише потрібні стовпці, і\nжодних прав адміністратора для облікових записів застосунків. Коли застосунок\nпрацює лише через збережені процедури, йому слід дозволити виконувати їх і\nнічого більше. Мінімальні привілеї обмежують шкоду, але самої атаки не\nвідвертають.\n\n**Докладні помилки бази даних, показані користувачам.** Повідомлення про\nпомилку, що розкриває структуру команди, допомагає зловмисникові підлаштувати\nнаступну спробу, і техніка на основі помилок із посібника з тестування\nспирається саме на це. CWE радить мінімальні повідомлення про помилки. Показуйте\nкористувачеві загальне повідомлення про збій, а подробиці лишайте на сервері для\nсвоїх розробників.\n\n**Довіра до даних, які вже лежать у базі.** Значення, яке безпечно записали, все\nодно може стати небезпечним, коли пізніший код вставить його в SQL. OWASP каже,\nщо її заходи діють незалежно від того, чи дані надходять із HTTP-запиту, з\nіншого сервісу чи були записані раніше, а CWE попереджає, що подальші процеси\nможуть забути екранувати те, що колись записали. Прив'язуйте значення, прочитані\nз власних таблиць, так само, як прив'язуєте введення з форми.\n\n## Що почитати далі\n\n- [CWE-89 in the Common Weakness Enumeration](https://cwe.mitre.org/data/definitions/89.html)\n  — сам запис про ваду: наслідки, приклади й заходи захисту разом з їхніми\n  обмеженнями.\n- [OWASP SQL Injection Prevention Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/SQL_Injection_Prevention_Cheat_Sheet.html)\n  — параметризовані запити, збережені процедури, динамічні ідентифікатори й\n  мінімальні привілеї.\n- [OWASP Web Security Testing Guide: Testing for SQL Injection](https://wstg.owasp.org/v4.2/4-Web_Application_Security_Testing/07-Input_Validation_Testing/05-Testing_for_SQL_Injection/)\n  — класи атак і техніки такими, якими їх бачить тестувальник.\n- [PEP 249: Python Database API Specification v2.0](https://peps.python.org/pep-0249/)\n  — спільний інтерфейс драйверів Python, разом із п'ятьма стилями заповнювачів.\n- [Psycopg 3: Passing parameters to SQL queries](https://www.psycopg.org/psycopg3/docs/basic/params.html)\n  — правила для заповнювачів і правильний спосіб будувати динамічний SQL.\n- [PostgreSQL: Command Execution Functions](https://www.postgresql.org/docs/current/libpq-exec.html)\n  — як libpq передає параметри окремо від рядка команди.\n\n\u003chttps://engineer.company/uk/glossary/sql-injection/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як SQL-ін'єкція дає введеному тексту переписати команди бази даних, що з цього має зловмисник і чому прив'язані параметри її зупиняють.","formats":{"gemtext":"https://engineer.company/uk/glossary/sql-injection/index.gmi","gopher":"https://engineer.company/uk/glossary/sql-injection/gophermap","html":"https://engineer.company/uk/glossary/sql-injection/","json":"https://engineer.company/uk/glossary/sql-injection/index.json","markdown":"https://engineer.company/uk/glossary/sql-injection/index.md","pdf":"https://engineer.company/uk/glossary/sql-injection/index.pdf"},"kind":"page","language":"uk","title":"Що таке SQL-ін'єкція?","url":"https://engineer.company/uk/glossary/sql-injection/","version":1}