{"canonical_url":"https://engineer.company/uk/glossary/configuration/","content_markdown":"# Конфігурація\n\n## Що це таке\n\nКонфігурацією називають усе, що програма зчитує поза власним кодом, щоб знати,\nяк працювати в конкретному місці: на якому порту слухати, до якої бази даних\nпідключатися, кого пускати і які функції вмикати. У розмові інженери здебільшого\nкажуть «конфіг», англійською config, а файли з нею називають конфігураційними\nфайлами або файлами конфігурації. NIST у SP 800-128, посібнику з управління\nконфігурацією з фокусом на безпеку, визначає її як можливі стани, параметри та\nспецифікації, якими можна описати або впорядкувати інформаційну систему чи її\nкомпонент. Ключове слово тут — «описати»: конфігурація є описом, і система, яку\nвона описує, може з ним розходитися.\n\nРідко програма бере конфігурацію з одного місця. Значення за замовчуванням\nвкомпільовано в бінарний файл, на диску лежить головний файл, а поруч із ним —\nкаталог додаткових фрагментів (drop-in), змінні середовища й прапорці командного\nрядка додаються під час запуску. Програма зводить усе це в один набір значень за\nправилом, яке вирішує, що робити, коли два джерела задають той самий ключ, і\nкожна програма має своє правило. Сервер OpenSSH для більшості ключових слів\nзалишає перше прочитане значення, а інші інструменти дають пізнішому файлу\nперекрити раніший. Ті самі файли, прочитані в іншому порядку, дають іншу\nсистему.\n\nФормати бувають різні: рядки в стилі INI, TOML, YAML, JSON і формати, якими\nкористується лише одна програма. TOML 1.0.0 прагне бути мінімальним форматом\nконфігураційних файлів, а YAML 1.2.2 — загальна мова даних, яку конфігураційні\nфайли запозичують. Кожен формат має власні правила, за якими текст стає\nзначеннями.\n\n## Чому це важливо\n\nСаме конфігурація дає змогу одній збірці служити в багатьох місцях. Та сама\nпрограма працює на ноутбуці, на тестовому хості (staging) і в продакшні, а\nрізниця між ними — у її конфігурації.\n[The Twelve-Factor App](https://12factor.net/), методологія для сервісів, які\nрозгортають, проводить межу саме тут: конфігурація — це все, що, імовірно,\nзмінюватиметься між розгортаннями, як-от адреси баз даних і допоміжних сервісів,\nоблікові дані до зовнішніх сервісів і канонічне ім'я хоста кожного розгортання.\nМетодологія вимагає суворо відокремлювати конфігурацію від коду й пропонує\nперевірку, яку варто застосовувати будь-де: чи можна було б будь-якої миті\nвідкрити кодову базу, не скомпрометувавши жодних облікових даних.\n\nТой самий текст позначає й протилежну межу. Внутрішні налаштування, однакові в\nкожному розгортанні, наприклад таблиця маршрутів вебфреймворку, до конфігурації\nв цьому сенсі не належать, і їм краще жити в коді. Значення, однакове скрізь, —\nце код у костюмі налаштування, а файл лише дає йому ще одне місце, де\nпомилитися.\n\nКонфігурація — це також місце, де система заявляє свій рівень захисту: хто може\nвходити, які порти відповідають, що пропускає брандмауер. Хост захищений рівно\nнастільки, наскільки захищені значення, які він фактично використовує, а між\nфайлом і цими значеннями стоять парсер, правила пріоритету, вкомпільовані\nзначення за замовчуванням, версія програми й середовище. Кожен із них може\nзмінити результат, поки файл лишається тим самим, тож надійна звичка — питати\nпрограму, що вона використовує, і вважати конфігурацією саме цю відповідь.\n\n## Як це виглядає на практиці\n\nЦей сайт налаштовано в одному файлі TOML — hugo.toml, який серед іншого задає\nмови сайту, таксономії та монтування (mounts). Одна таблиця в ньому показує,\nскільки можуть вирішити кілька рядків:\n\n```toml\n[frontmatter]\n  date = [\"date\", \":git\", \":fileModTime\"]\n  lastmod = [\"lastmod\", \":git\", \":fileModTime\"]\n```\n\nКожен список — це порядок пошуку: спершу дата, записана в самій сторінці, потім\nдата останнього коміту, який торкався файлу, і нарешті час зміни файлу.\nПрапорець у верхній частині файлу, `enableGitInfo = true`, узагалі дозволяє Hugo\nчитати історію git. Коментар над таблицею пояснює, навіщо перший елемент: якщо\nсаме поле з front matter не назване в списку, Hugo мовчки ігнорує записаний у\nсторінці `lastmod`, а сайт збирається як завжди.\n\nЦя таблиця і є виправленням із\n[випадку, коли карта сайту показувала однаковий час зміни майже для всіх сторінок](/uk/portfolio/fixed-a-sitemap-with-one-shared-timestamp/).\nПошукові системи отримували з неї дату, за якою 172 сторінки зі 176 змінилися в\nодну й ту саму мить: дату брали з часу зміни файлу, а експорт вмісту під час\nкожного запуску наново записує всі файли. Ланцюжок резервних джерел перевів дату\nна історію версій. На тому зафіксованому етапі реалізації повторна\nсинхронізація після місяця правок вмісту зачепила вісім із 186 файлів.\n\nНа сервері той самий урок проходить крізь\n[посилення захисту SSH із триетапною перевіркою](/uk/portfolio/hardened-ssh-to-24-validated-directives/).\nРоль автоматизації вже кілька місяців записувала конфігурацію демона SSH, коли у\nвересні 2026 року звіт про доступ запитав у самого демона, які значення той\nзастосовує, і два з них розійшлися з файлом ролі. Власні значення операційної\nсистеми за замовчуванням стояли активними раніше за drop-in-файл, а для цих двох\nпараметрів діє значення, прочитане першим. Розв'язок — додати до назви\ndrop-in-файлу префікс, щоб у лексичному порядку він ішов перед файлом\nпостачальника. Відтоді роль перевіряє себе в три етапи: синтаксис\nфайлу-кандидата перевіряють до встановлення, зібрану конфігурацію — після, а\nпідсумкові значення демона зчитують назад і звіряють із ними 24 директиви. Дві\nдирективи свідомо пропущено, бо демон їх більше не реалізує.\n\nПротилежний бік тієї самої вади видно в\n[перевірці трьох засобів SSH проти перебору паролів](/uk/portfolio/three-locks-on-the-door-none-of-them-locked/),\nпроведеній у серпні 2026 року. Усі три значилися в конфігурації й у кожному\nзвіті, проте від самого створення хоста жоден із них так і не спрацював. Набір правил\nблокування Fail2ban (jail) був налаштований на порт 22, а демон SSH приймав з'єднання на\nпорту 1986. Обмеження частоти в брандмауері стояло нижче за ширше правило, яке\nперехоплювало трафік першим. Дія блокування залежала від бінарного файлу\nпакетного фільтра, який система пакетів лише рекомендує. Перевірка читала\nсистему в роботі, а не файли, і дала два нові правила: засіб безпеки отримує\nперевірку через assert, а не коментар, а брандмауер перевіряють за тим, де\nстоїть правило, а не за тим, чи воно є.\n\n## Де виникають проблеми\n\nКожна вада нижче — це файл, правильний як текст і хибний як поведінка, і для\nкожної є перевірка, що читає саме поведінку.\n\n1. Перемагає хибне джерело. Посібник OpenSSH до конфігурації сервера каже, що\n   для кожного ключового слова використовується перше отримане значення, якщо не\n   зазначено інше. Тож значення постачальника, прочитане раніше за власний\n   drop-in, перемагає його, а в інструменті, де перемагає останнє значення, усе\n   навпаки. Правило пріоритету варто прочитати в посібнику самої програми, а\n   потім запитати саму програму: `sshd -t` перевіряє, чи конфігурація коректна,\n   а `sshd -T` виводить чинну.\n2. Ключ TOML потрапляє до чужої таблиці. У TOML 1.0.0 пари ключ–значення під\n   заголовком `[table]` належать цій таблиці до наступного заголовка або до\n   кінця файлу, а відступи ігноруються. Ключ, дописаний у кінці файлу,\n   опиняється в останній таблиці, навіть якщо стоїть без жодного відступу.\n   Таблиці варто тримати в кінці, а звичайні ключі — над ними. Визначати ключ\n   або таблицю двічі заборонено, тож дублікат — це помилка, яку треба виправити,\n   а не спосіб щось перевизначити.\n3. Значення YAML без лапок змінює тип. За базовою схемою (core schema), яку YAML\n   1.2.2 рекомендує за замовчуванням, значення без лапок, що відповідає одному з\n   її шаблонів, стає числом, булевим значенням або null: `1.10` — це дробове\n   число 1,1, `0o17` — ціле 15, `0123` повертається як 123, `FALSE` — булеве\n   значення, а `~` — null. Кожне значення, яке має лишитися текстом, слід брати\n   в лапки, насамперед номери версій та ідентифікатори з нулями на початку.\n   Специфікація також відносить повторені ключі у відображенні (mapping) до\n   випадків, коли завантаження лишається неповним, тож ключ, записаний двічі, —\n   це дефект.\n4. Налаштування виглядає чинним і нічого не робить. Правило, перекрите іншим, що\n   стоїть вище, директива, яку новіший випуск прибрав, порт, з якого сервіс\n   давно пішов: кожне лишається у файлі й має вигляд свідомого рішення. Jail на\n   порту 22 й обмеження частоти під ширшим правилом обидва виглядали справними в\n   кожному статусі. Перевірка, яка читає кожен файл окремо, їх пропускає, тож\n   порядок і наявність треба звіряти із системою в роботі.\n5. Секрет мандрує разом із файлом. Пароль у файлі конфігурації потрапляє туди ж,\n   куди й сам файл: у репозиторій, у резервні копії, у звіт про ваду. The\n   Twelve-Factor App тримає конфігурацію у змінних середовища зокрема тому, що\n   їх, на відміну від конфігураційних файлів, малоймовірно випадково закомітити\n   в репозиторій коду.\n\n## Що почитати далі\n\n- [NIST CSRC Glossary: configuration](https://csrc.nist.gov/glossary/term/configuration)\n  — усі визначення, які публікації NIST дають цьому терміну, кожне з\n  документом-джерелом.\n- [TOML v1.0.0](https://toml.io/en/v1.0.0) — повна специфікація, достатньо\n  коротка, щоб прочитати її за один раз.\n- [YAML Ain’t Markup Language, version 1.2.2](https://yaml.org/spec/1.2.2/) —\n  специфікація; у розділі 10 описано базовий набір правил (Core Schema), який\n  вирішує, чим стане значення без лапок.\n- [The Twelve-Factor App: Config](https://12factor.net/config) — аргументи на\n  користь того, щоб тримати значення конкретного розгортання поза кодом, разом\n  із перевіркою на open source.\n- [sshd_config(5)](https://man.openbsd.org/sshd_config) — посібник із\n  конфігурації сервера OpenSSH: правило першого значення, Include і Match.\n- [sshd(8)](https://man.openbsd.org/sshd) — посібник демона, де `-t` перевіряє\n  конфігурацію, а `-T` виводить чинну.\n\n\u003chttps://engineer.company/uk/glossary/configuration/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Звідки програма бере свої налаштування, яке значення перемагає, коли джерела розходяться, і як довести, що записане у файлі — це те, що справді діє.","formats":{"gemtext":"https://engineer.company/uk/glossary/configuration/index.gmi","gopher":"https://engineer.company/uk/glossary/configuration/gophermap","html":"https://engineer.company/uk/glossary/configuration/","json":"https://engineer.company/uk/glossary/configuration/index.json","markdown":"https://engineer.company/uk/glossary/configuration/index.md","pdf":"https://engineer.company/uk/glossary/configuration/index.pdf"},"kind":"page","language":"uk","title":"Що таке конфігурація?","url":"https://engineer.company/uk/glossary/configuration/","version":1}