{"canonical_url":"https://engineer.company/uk/glossary/secret/","content_markdown":"# Експлуатаційний секрет\n\n## Що це таке\n\nЕксплуатаційний секрет — це значення, яке дає програмі або людині, що її обслуговує, змогу діяти в\nсистемі і дає ту саму силу кожному, хто його прочитає. Пароль до з'єднання з базою даних, API-токен,\nприватна половина пари SSH-ключів і парольна фраза, якою зашифровано резервну копію, — усе це\nексплуатаційні секрети. У повсякденній мові кажуть просто секрети, а роботу зі створення,\nзберігання, ротації та знищення секретів називають керуванням секретами (secrets management).\n\nВід коду довкола них їх відрізняють дві речі. Перша — хто їх читає. Пароль користувача зберігається\nв пам'яті людини, і його вводять у відповідь на запит, а експлуатаційний секрет читає програма,\nскрипт розгортання чи завдання за розкладом, і пам'ятати його нікому не треба. Тому OWASP Secrets\nManagement Cheat Sheet описує для нього окремий життєвий цикл: його створюють із мінімальними\nпривілеями, яких він потребує, змінюють за графіком, відкликають, коли він міг витекти, і обмежують\nстроком дії там, де платформа це дозволяє, а тривалість життя коливається від хвилин до років.\nПаролі користувачів у цю регулярну ротацію не входять. Друга — межа між секретом і конфігурацією,\nяка на нього вказує. Ім'я хоста чи шлях до репозиторію резервних копій кажуть, де щось лежить.\nСекрет — це та частина, яка впускає власника, і та, копії якої треба рахувати.\n\nСекрети ще й вкладені один в одного. Сховищу, де вони лежать, потрібен власний секрет, і шпаргалка\nOWASP зазначає, що цей первинний секрет, наприклад кореневі облікові дані хмарного провайдера,\nзазвичай доводиться тримати деінде.\n\n## Чому це важливо\n\nСекрет працює на того, хто його пред'являє. Токен не зберігає відомостей про те, кому його\nпризначали, тож кожна копія розширює коло людей і програм, які можуть ним скористатися. Репозиторій\nвихідного коду — найгірше місце, куди він може потрапити: кожен клон несе всю історію, тож значення,\nзакомічене один раз, розходиться на кожен ноутбук, раннер збірки й дзеркало, що його завантажує, і\nлишається в історії після того, як рядок із ним видалено.\n\nСтандарти перетворюють це на вимоги. OWASP Application Security Verification Standard вимагає\nрішення для керування секретами, наприклад сховища ключів (key vault), яке створює й зберігає\nсерверні секрети, контролює доступ до них і знищує їх, і прямо пише, що секрети не можна включати у\nвихідний код застосунку чи в артефакти збірки. Він вимагає мінімальних привілеїв для доступу до них,\nа на найвищому рівні — щоб строк їхньої дії спливав і їх змінювали. NIST SP 800-53 додає посилення\nконтролю IA-5(7): незашифровані статичні автентифікатори не можна вбудовувати в застосунки чи інше\nстатичне сховище. Настанова закриває й лазівку: значення, яке використовують точно в тому вигляді, у\nякому його збережено, вважається незашифрованим, хай у якому файлі воно лежить.\n\nКомпроміси реальні. Центральне сховище — ще одна система, яка має працювати саме тоді, коли вона\nнайпотрібніша, і шпаргалка нагадує, що під час інциденту люди чекають нових облікових даних швидко.\nСпільний секрет для кількох сервісів економить роботу, але коштує простежуваності, бо після витоку\nнеможливо сказати, хто з власників його втратив. Ручна робота зростає з кожним секретом, тому\nшпаргалка радить автоматичну ротацію і попереджає, що перезапуск застосунку лишає викрадені облікові\nдані чинними. Зупиняє їх лише відкликання.\n\n## Як це виглядає на практиці\n\nСайт формулює своє правило на\n[сторінці про те, як компанія працює безпечно](/uk/security/):\nсекрети тримають поза репозиторієм. Облікові дані лежать у сховищі секретів або на рівні\nрозгортання, поза вихідним кодом і поза всім, що створює збірка, а автоматичне сканування перевіряє\nкожен коміт і зупиняє його, щойно щось знаходить.\n\nНотатки для розробників цього репозиторію додають подробиці. Сканер — gitleaks, він проходить робоче\nдерево під час кожного коміту й ще раз у повній перевірці якості, і знахідка означає жорстку\nзупинку, яку не обходять винятком. Каталог залежностей і згенеровані дерева виводу виключено зі\nсканування, бо це копії, які збірка відтворює з нуля. Нотатки фіксують і тихіший збій: коли файл\nзникає посеред сканування, gitleaks друкує рядок із помилкою і все одно завершується успішно, тому\nзавдання, яке запускає сканер, падає на будь-якому такому рядку. Сам сайт статичний і секретів\nзастосунку не має, а розгортають його через SSH ключами, які тримає власник.\n\nКоли секрети тримають поза репозиторієм, вони опиняються там, куди перевірки репозиторію не\nдістають, і\n[попередній плей для секретів](/uk/portfolio/added-a-one-second-preflight-for-secrets/)\nзакриває цю прогалину. Секрети щойно розділили за хостами, і код був правильний, але зашифроване\nсховище секретів оператора, що навмисно живе лише на його машині й поза полем зору перевірки якості,\nдосі тримало старе значення, розраховане на один хост. Перший прогін converge дістався живого хоста,\nвиконав вісім завдань і відмовився на дев'ятому, коли вже записав на продакшн налаштування свопу.\nВідповіддю став плей, що не звертається до жодного хоста, не збирає фактів і проганяє на сховищі ті\nсамі два файли завдань, що й справжній converge, приблизно за секунду і раніше за будь-який інший\nкрок підготовки хоста. Оскільки код той самий, а не переказ правила, перевірка й converge не\nрозходяться. Хибний секрет тепер коштує двосекундної відмови на ноутбуці.\n\nСам поділ описано на сторінці про те, як\n[кожен експлуатаційний секрет отримав окреме значення для кожного хоста](/uk/portfolio/split-every-operational-secret-per-host/).\nПлатформа мала один хост і от-от мала отримати другий, а кілька секретів мали лише одне значення\nна всю платформу, серед них репозиторій резервних копій, його парольна фраза й перемикач тривоги.\nКожне стало словником із ключем за ім'ям хоста в інвентарі, і поруч із конфігурацією записано дві\nпричини. Dead man's switch, спільний для двох хостів, лишається зеленим, поки бодай один із них\nподає сигнал, тож другий хост приховує смерть першого. Окремі репозиторії restic можуть мати різні\nголовні ключі, навіть якщо використовують ту саму парольну фразу. Проте той, хто отримає цю парольну\nфразу й зможе прочитати зашифровані дані та файли ключів обох репозиторіїв, зможе відкрити обидва.\nОтже, спільна парольна фраза пов'язує ризики розкриття даних обох репозиторіїв замість того, щоб\nізолювати хости. Наявний хост внесено в усі чотири словники, залишивши порожніми його репозиторій та\nобидва перемикачі: обв'язка вже є, а значення ще має надати оператор.\n\n## Де виникають проблеми\n\n**Секрет потрапляє в коміт.** Сканер позначає значення в diff, або хтось помічає токен у запушеному\nфайлі, бо той лежав у файлі конфігурації чи тестовій фікстурі, коли робили коміт. Шпаргалка OWASP\nзадає порядок дій: спершу відкликати скомпрометоване значення, потім змінити його, і лише тоді\nвидалити з коду чи журналів. Переписування історії, щоб прибрати коміт, змінює всі пізніші коміти й\nламає посилання на них, тож його треба планувати. Виявляти такі речі слід до коміту, у\npre-commit-хуку чи в редакторі, де знахідка нічого не коштує.\n\n**Сканування проходить повз файли, яких не прочитало.** Прогін завершується зеленим, хоча частину\nдерева так і не перевірено: файл зник посеред обходу, виняток вийшов заширокий або секрет не має\nвпізнаваної форми. Правила-шаблони добре ловлять токени фіксованого формату й пропускають пароль,\nякий вигадала людина, тому шпаргалка радить більше ніж один інструмент. Вважайте будь-яку помилку\nсканера провалом прогону і лишайте у винятках тільки копії, які відтворює збірка.\n\n**Один секрет на багатьох власників.** Два хости, два сервіси чи ціла команда користуються тим самим\nзначенням. Коли воно витікає, журнали не можуть сказати, яка копія пішла, а заміна вимагає\nторкнутися всіх власників одночасно. SP 800-53 вимагає змінювати автентифікатори групових і рольових\nоблікових записів щоразу, коли змінюється їхній склад, а окремий секрет для кожного власника робить\nце однією заміною замість узгодженої.\n\n**Секрет їде разом зі збіркою або потрапляє в журнал.** Образ контейнера, зібраний скрипт чи\nналагоджувальний рядок виносить значення за межі місця, де воно мало лишатися. ASVS згадує артефакти\nзбірки поруч із вихідним кодом, а шпаргалка просить тримати секрети поза журналами й маскувати їх\nтам, де рядок мусить на них посилатися. Скануйте те, що створює збірка, а не лише репозиторій.\n\n## Що почитати далі\n\n- [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)\n  — життєвий цикл секрету, виявлення до коміту й порядок дій після витоку.\n- [OWASP Application Security Verification Standard](https://owasp.org/www-project-application-security-verification-standard/)\n  — вимоги до керування секретами в групі 13.3: сховище, мінімальні привілеї й ротація.\n- [NIST SP 800-53 Rev. 5](https://csrc.nist.gov/pubs/sp/800/53/r5/upd1/final)\n  — керування автентифікаторами в IA-5 і IA-5(7) проти вбудованих статичних автентифікаторів.\n- [Gitleaks](https://github.com/gitleaks/gitleaks)\n  — сканер, який сайт запускає по своєму робочому дереву під час кожного коміту.\n\n\u003chttps://engineer.company/uk/glossary/secret/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Як експлуатаційні секрети тримають поза вихідним кодом і артефактами збірки, чому одне значення на два хости підводить непомітно і що робити після витоку.","formats":{"gemtext":"https://engineer.company/uk/glossary/secret/index.gmi","gopher":"https://engineer.company/uk/glossary/secret/gophermap","html":"https://engineer.company/uk/glossary/secret/","json":"https://engineer.company/uk/glossary/secret/index.json","markdown":"https://engineer.company/uk/glossary/secret/index.md","pdf":"https://engineer.company/uk/glossary/secret/index.pdf"},"kind":"page","language":"uk","title":"Що таке експлуатаційний секрет?","url":"https://engineer.company/uk/glossary/secret/","version":1}