Кожен ключовий термін Lagune і методології Security-Driven Hardening, визначений один раз і простою мовою.
Security-Driven Hardening (SDH)
Методологія, яку реалізує Lagune: конвенція Blue Team з урахуванням контексту, що визначає контекст системи, сортує за пріоритетом ризики, які несе цей контекст, і спрямовує виправлення. Знання з безпеки містяться в специфікації та її спеціалізаціях на вимогу, тож розробник і нерозробник обслуговуються тим самим процесом.
Lagune
Еталонна реалізація SDH: дев'ять команд агента, кожна з шаблоном, який вона заповнює, що їх ШІ-агент виконує, щоб посилити захист кодової бази. Кожен агент встановлює їх через власний інсталятор плагінів або через skills.sh, як показано на сторінці встановлення, а вони запускають рушій Lagune для кожного детермінованого кроку.
Charter
Керівний рівень Lagune: набір принципів, що ставлять безпеку на перше місце і яких має дотримуватися кожна наступна фаза. Сприймайте її як перевірку під час компіляції для рівня захищеності проєкту. Вона зберігається в .lagune/memory/charter.md.
Процес розробки
Універсальна команда /lagune, що посилює захист роботи під час написання коду. Вона приймає будь-який промпт на будь-якому етапі, створює те, що ви попросили, і посилює захист безпечними налаштуваннями за замовчуванням, перш ніж повернути результат, керуючись принципами безпеки, якщо вони є. Вона нічого не записує у відстеження Lagune, тож її єдиним продуктом є захищений код. Разом із принципами безпеки (до) і процесом Blue Team (після) саме так Lagune захищає під час розробки.
Процес Blue Team
П'ятифазний аудит, що лежить в основі Lagune: charter, detect, plan, harden, verify. Кожна фаза спирається на попередню. "Blue Team" є традицією захисників у безпеці, на противагу наступальній Red Team.
Знахідка
Один виявлений ризик. Кожна знахідка містить, що це, чому це важливо, і доказ у коді. Знахідка є єдиною відстежуваною одиницею, яку plan, harden і verify передають далі, ідентифікованою за назвою в кожному артефакті.
Засіб захисту
Захід безпеки, застосований, щоб закрити ризик. Harden застосовує засоби захисту, verify доводить, що вони діють. Lagune ніколи не послаблює засіб захисту заради промпту.
Detect
Фаза, що читає код і визначає, що робить система і де ризики. Її головне правило: виявляти, а не вигадувати. Вона записує лише те, що підтверджує код.
Harden
Єдина фаза, що торкається вашого коду. Вона застосовує виправлення з плану по одному й записує кожне як Applied, Partial чи Blocked. Applied ще не означає доведене.
Verify
Фаза, що доводить, що кожне застосоване виправлення діє, читаючи код і зіставляючи його з тим, що записала harden. Вона повертає один із трьох вердиктів: Risk closed, Risk not closed або Cannot tell from the code.
Зняття з обліку
Коли verify доводить, що ризик закрито, знахідку знімають з обліку: прибирають з усього ланцюжка за вашим підтвердженням, щоб її більше не обробляли повторно.
Закриваність
Властивість, завдяки якій робота з безпеки має кінцевий стан. Оскільки знахідку, закриття якої доведено, знімають з обліку, процес може перейти в стан спокою й відкривається знову лише тоді, коли змінюється код. Безпеку в SDH можна закрити, це не нескінченний цикл.
Рушій
Пакет lagune в npm, через який команди виконують кожен детермінований крок за допомогою npx: хуки, каталог і категорії.
Спеціалізація
Цільовий модуль знань з безпеки, незалежний від мови програмування, який завантажується лише на вимогу, а не за замовчуванням. Спеціалізація не є командою. Завантажте її в будь-який промпт через read catalog <name> рушія, наприклад npx lagune read catalog regex.
Категорія
Іменована група вбудованих спеціалізацій, від owasp до спеціалізацій для окремих мов, як-от javascript, python, go і rust. Категорії, які використовує проєкт, записані в .lagune/configs.json, визначають, які вбудовані спеціалізації потрапляють до його каталогу. Поки жодної не записано, проєкт використовує лише owasp.
Каталог
Набір спеціалізацій, які використовує проєкт: вбудовані спеціалізації його категорій плюс власні, написані через /lagune-specialize. read catalog рушія виводить його, а фази зіставляють його з кодом.
Промпт на вимогу
Принцип, за яким потрібні знання з безпеки підтягуються для того, чим насправді є проєкт, замість того щоб за замовчуванням запускалися всі перевірки.
Ідентичність за назвою
Модель відстеження Lagune: назва кожної знахідки, записана однаково як заголовок розділу в кожному артефакті, є її ідентичністю в усьому ланцюжку. Карта відстеження (.lagune/tracking.json) містить лише відстеження, а не текст.
Часті запитання
SDH є методологією безпеки Blue Team з урахуванням контексту. Вона визначає контекст системи, сортує за пріоритетом ризики, які несе цей контекст, і спрямовує виправлення, викладаючи кожну знахідку простою мовою. Lagune є її еталонною реалізацією.
Charter є керівним рівнем Lagune, набором принципів, що ставлять безпеку на перше місце і яких має дотримуватися кожна наступна фаза. Вона зберігається в .lagune/memory/charter.md.
Коли verify доводить, що ризик закрито, знахідку знімають з обліку: прибирають з усього ланцюжка за вашим підтвердженням, щоб її більше не обробляли повторно.
