{"canonical_url":"https://engineer.company/uk/glossary/validation/","content_markdown":"# Валідація\n\n## Що це таке\n\nВалідація — це крок, на якому програма порівнює вхідні дані з правилами, яких ці\nдані мають дотримуватися, і відхиляє їх, якщо порушено правила, ще до того, як\nщось буде збережено, виконано чи передано далі. Залежно від рівня її називають\nпо-різному: валідація введення для полів форм і запитів до API, валідація за\nсхемою, коли правила записано як JSON Schema або опис OpenAPI, і валідація\nрозмітки, коли вебсторінку перевіряють за граматикою HTML. Дані, що пройшли\nперевірку, називають валідними.\n\nНастанови OWASP ділять цю роботу на два питання. Синтаксис визначає, чи має\nзначення очікуваний тип і форму: чи це дата, чи це ціле число, чи розбирається\nтіло запиту як JSON. Семантика визначає, чи має значення сенс для конкретної\nоперації: бронювання готелю потребує двох коректних дат, а ще й того, щоб дата\nвиїзду була пізнішою за дату заїзду. Перетворення рядка «500» на ціле число\nвідповідає на перше питання і нічого не каже про те, чи прийнятне проживання на\n500 ночей.\n\nВалідація розмітки — найстаріша публічна форма цієї ідеї у вебі. Сервіс W3C\nMarkup Validation Service описує валідацію як перевірку документа за граматикою,\nяку той сам декларує, і порівнює свій валідатор із lint для C. Документація\nсервісу обережно пояснює, що саме це доводить: валідна сторінка не обов'язково\nдобра, це лише сторінка, яку інструмент визнав відповідною певному набору\nправил. Та сама обережність стосується всіх інших різновидів. Валідація показує,\nщо дані відповідають написаним правилам, і нічого не каже про те, чи були ці\nправила слушними.\n\nІз валідацією часто плутають два сусідні поняття. Санітизація змінює вхідні\nдані, щоб зробити їх прийнятними, вирізаючи чи переписуючи частини, тоді як\nвалідація приймає або відхиляє дані такими, як вони є. Екранування й\nпараметризація роблять дані безпечними для місця, куди вони потрапляють, —\nсторінки HTML чи запиту SQL, — і вони потрібні й після того, як валідацію\nпройдено.\n\n## Чому це важливо\n\nРішення, що стоїть за валідацією, — де система проводить межу довіри і що на цій\nмежі перевіряє. Кожен запит із браузера, кожне повідомлення з черги, кожен файл\nвід партнера і кожна зміна конфігурації від колеги приходять зі своїми\nприпущеннями. Якщо перевірити їх на вході, решта коду може на них покладатися;\nякщо перевірку пропустити, кожна функція глибше в системі мусить захищатися\nсама, а на практиці більшість цього не робить.\n\nДруге рішення — як записувати правила. Перевірки, написані вручну для кожного\nендпоінта окремо, спершу дешеві, але з ростом системи розходяться між собою, бо\nкожна з них — окремий шматок коду. Правила, оголошені один раз як типи чи як\nсхема, може застосовувати бібліотека, а документацію можна публікувати з того\nсамого джерела, що зменшує ризик розходження між описом і поведінкою. Ціна — фреймворк, який треба\nвивчити, і типові налаштування, які треба розуміти, бо схема застосовує рівно\nте, що в ній сказано, і жодного правила понад це.\n\nОстанній вибір — суворість. Список дозволеного (allowlist) описує прийнятне і\nвідхиляє все інше; OWASP радить саме цей підхід замість спроб розпізнати кожен\nзловмисний рядок. Відхилення полів, яких схема не знає, рано виявляє одруківки й\nзастарілих клієнтів. Відхилити весь запит на першій же проблемі, з чіткою\nпомилкою, безпечніше, ніж продовжувати з даними, перевіреними лише частково.\n\n## Як це виглядає на практиці\n\nОдин API починався з валідації запитів, написаної вручну для кожного ендпоінта. На задокументованому етапі реалізації\n[перехід на Huma v2 перетворив ці перевірки на типи для 649 шляхів і 760 операцій](/uk/portfolio/migrated-the-api-to-huma-v2-at-100-parity/).\nКожен ендпоінт мав вхідні та вихідні структури, Huma генерувала з них валідацію запитів, а опис OpenAPI виходив із тих самих типів. Два ендпоінти WebSocket лишилися на чистому Fiber, бо модель запиту й відповіді там не підходила. Перевірка в CI порівнювала маршрути, які реєстрував сервер, із тими, що їх декларував опис. Зафіксований паритет маршрутів становив 100%; перевірки, оголошені у вхідних типах, замінили відповідну валідацію, написану вручну.\n\nКонфігурація потребує того самого, і\n[посилення захисту SSH на хості компанії тепер проходить три етапи перевірки під час кожного застосування конфігурації](/uk/portfolio/hardened-ssh-to-24-validated-directives/).\nФайл-кандидат перевіряють на синтаксис перед встановленням, зібрану конфігурацію\nперевіряють після встановлення, а потім зчитують фактичні параметри, які\nзастосовує демон, і звіряють із ними 24 директиви. Третій етап з'явився тому, що звіт про\nдоступ у вересні 2026 року показав два параметри, які автоматизація записувала\nпід час кожного застосування конфігурації, а демон перекривав: власні усталені значення операційної\nсистеми читалися першими, а для цих двох параметрів перемагає перше входження.\nЯк сказано на сторінці, пошук директиви доводить лише те, що її було записано.\n\nВалідація розмітки входила до задокументованого етапу реалізації в серпні 2026 року:\n[перевірка HTML входила до набору з 22 лінтерів, що виконувалися перед комітом](/uk/portfolio/built-a-22-linter-commit-gate/)\nбез рівня попереджень, де кожна діагностика була помилкою, а локальні вимкнення перевірок у коді були заборонені, тож невалідну сторінку не можна було закомітити, просто позначивши помилку як прийнятну.\n\n## Де виникають проблеми\n\n**Сервер довіряє тому, що вже перевірив браузер.** Форма, яка відхиляє\nнеправильну адресу електронної пошти в браузері, створює враження валідації, але\nзапит можна надіслати й оминаючи форму. OWASP називає перевірки лише на боці\nклієнта поширеною пасткою: валідувати слід на сервері, а перевірку в браузері\nвважати швидкою підказкою для людини, що заповнює форму.\n\n**JSON-схема приймає все, про що в ній не сказано.** У JSON Schema перелічена\nвластивість ще не стає обов'язковою і не забороняє інших полів, а за типовим\nсловником 2020-12 ключове слово `format` збирається як анотація, і перевірку\nформату типово вимкнено. Ця схема виглядає суворою:\n\n```json\n{\n    \"type\": \"object\",\n    \"properties\": {\n        \"email\": { \"type\": \"string\", \"format\": \"email\" }\n    }\n}\n```\n\nВона приймає `{}`, `{\"email\": \"nope\"}` і `{\"emial\": \"a@example.com\"}`. Варто\nдодати `required` і `\"additionalProperties\": false` та ввімкнути перевірку\nформату у валідаторі або перевіряти формат у коді. Huma зі свого боку типово\nвідхиляє невідомі поля в тілі запиту, документує `readOnly` і `writeOnly`, але\nїх не застосовує, і пропускає невідомі параметри рядка запиту, доки це окремо не\nналаштовано.\n\n**Перевірка проходить на одній версії даних, а програма використовує іншу.**\nВалідатор, що читає сирий запит, тоді як обробник читає декодовану копію, або\nтест, що дивиться на файл на диску, тоді як демон застосовує інший параметр,\nперевірили те, чим система не користується. OWASP радить валідувати те подання,\nяке справді буде використано. Робота із SSH вище — той самий урок для\nконфігурації: лише зчитування з демона показало, що діє насправді.\n\n**Список заборон зустрічає наступний варіант.** Блокування відомих небезпечних\nсимволів відкидає цілком законні дані, скажімо апостроф у прізвищі, і водночас\nзалишає запит до бази даних небезпечним. Слід визначити, що приймає кожне поле,\nі відхиляти решту.\n\n**Валідні дані вважають безпечними.** Рядок, що пройшов кожне правило, однаково\nможе зламати інструкцію SQL чи сторінку, коли його туди вставлять. Валідація\nзвужує те, що надходить; параметризовані запити й екранування виводу захищають\nмісце, куди дані потрапляють, і потрібні обидва заходи.\n\n## Що почитати далі\n\n- [OWASP Input Validation Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Input_Validation_Cheat_Sheet.html)\n  — синтаксис і семантика, списки дозволеного, межі розбору й типові пастки.\n- [W3C Markup Validator documentation](https://validator.w3.org/docs/) —\n  власний опис валідації розмітки від валідатора, зі сторінками довідки про те,\n  що валідність доводить і де її межі.\n- [JSON Schema Validation, draft 2020-12](https://json-schema.org/draft/2020-12/json-schema-validation)\n  — ключові слова валідації, зокрема типова поведінка `format`.\n- [Huma: Request Validation](https://huma.rocks/features/request-validation/) —\n  валідація з тегів структур Go, із суворим і м'яким режимами полів.\n- [OpenAPI Specification](https://spec.openapis.org/oas/latest.html) — формат\n  опису, схеми якого застосовує багато валідаторів API.\n\n\u003chttps://engineer.company/uk/glossary/validation/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що таке валідація, де система має перевіряти вхідні дані й за якими правилами, і які типові налаштування схем та перевірки в браузері пропускають погані дані.","formats":{"gemtext":"https://engineer.company/uk/glossary/validation/index.gmi","gopher":"https://engineer.company/uk/glossary/validation/gophermap","html":"https://engineer.company/uk/glossary/validation/","json":"https://engineer.company/uk/glossary/validation/index.json","markdown":"https://engineer.company/uk/glossary/validation/index.md","pdf":"https://engineer.company/uk/glossary/validation/index.pdf"},"kind":"page","language":"uk","title":"Що таке валідація?","url":"https://engineer.company/uk/glossary/validation/","version":1}