Шпаргалка · Безопасность
Управление секретами
Проблема
Бэкенд магазина хранит пароль от базы в закоммиченном .env, и им пользуются пять сервисов. Пароль утекает, а срочная ротация роняет оформление заказа. Менеджер секретов решает обе проблемы: сервисы доказывают, кто они, через workload identity, получают собственных короткоживущих пользователей БД, секреты зашифрованы на диске, ключи ротируются с перекрытием версий, а каждое чтение попадает в аудит.
Чему вы научитесь
- Почему долгоживущий общий пароль в репозитории или env-файле отделяет от взлома одна утечка
- Workload identity вместо статического токена и динамические пользователи БД на сервис с lease
- Envelope-шифрование на диске и ротация без простоя через две перекрывающиеся версии
- Аудит каждого чтения секрета и break-glass на случай, когда лежит сам менеджер
Диаграмма как код
Итоговая схема урока в виде текста: вставьте её в Jira, GitLab, GitHub, Notion или документацию, там Mermaid рисуется сам. Есть варианты для D2 и PlantUML (Confluence, IntelliJ).
Mermaid: схема
flowchart LR
n_orders["Сервис заказов"]
n_reports("Джоб отчётов")
n_db[("БД магазина")]
n_secrets["Менеджер секретов"]
n_issuer>"Выдача identity"]
n_kms>"KMS"]
n_partner>"API партнёра"]
n_audit[("Журнал аудита")]
n_oncall(("Дежурный"))
n_safe[("Запечатанный сейф")]
n_orders --> n_db
n_reports --> n_db
n_orders --x n_secrets
n_reports --x n_secrets
n_secrets --> n_issuer
n_secrets --> n_db
n_secrets --> n_kms
n_orders --> n_partner
n_secrets --> n_partner
n_secrets --> n_audit
n_oncall --> n_safe
n_oncall -.->|"повтор"| n_db
classDef down fill:#fde2e2,stroke:#c62828,color:#4a0d0d,stroke-dasharray:4 3
class n_secrets downMermaid: последовательность запросов
sequenceDiagram
participant n_repo as Git-репозиторий
participant n_orders as Сервис заказов
participant n_intruder as Злоумышленник
participant n_db as БД магазина
participant n_secrets as Менеджер секретов
participant n_kms as KMS
participant n_partner as API партнёра
participant n_audit as Журнал аудита
actor n_oncall as Дежурный
participant n_safe as Запечатанный сейф
Note over n_repo,n_orders: Пароль живёт в файле в репозитории
n_repo->>n_orders: $ cat services/orders/.env
Note over n_intruder,n_db: Утёк бэкап репозитория, кто-то заходит
n_intruder->>n_db: 02:14:07 LOG connection authorized: user=app database=shop
Note over n_orders,n_db: Срочная ротация роняет оформление заказа
n_orders->>n_db: 02:31:00 admin ALTER ROLE app PASSWORD '***'
Note over n_orders,n_secrets: Секреты переезжают в менеджер секретов
n_orders->>n_secrets: GET /v1/secret/shop/db HTTP/1.1
n_secrets-->>n_orders: HTTP/1.1 200 OK
Note over n_orders,n_secrets: Сервис доказывает, кто он, без хранимого токена
n_orders->>n_secrets: POST /v1/auth/workload/login HTTP/1.1
n_secrets-->>n_orders: HTTP/1.1 200 OK
Note over n_orders,n_secrets: Каждый сервис получает своего пользователя БД с lease
n_orders->>n_secrets: GET /v1/database/creds/orders-rw HTTP/1.1
n_secrets-->>n_orders: HTTP/1.1 200 OK
Note over n_secrets,n_db: Что менеджер делает в базе
n_secrets->>n_db: CREATE ROLE #34;v-orders-h7Kq#34; LOGIN PASSWORD '***'
n_db-->>n_secrets: CREATE ROLE
Note over n_secrets,n_kms: Секреты на диске зашифрованы, корневой ключ в KMS
n_secrets->>n_kms: POST /v1/keys/secrets-root/decrypt HTTP/1.1
n_kms-->>n_secrets: HTTP/1.1 200 OK
Note over n_secrets,n_partner: Ротация без простоя: две версии перекрываются
n_secrets->>n_partner: 03:00:00 rotate partner/api-key: created version 8
Note over n_secrets,n_audit: Каждое чтение в журнале, чужое чтение видно
n_secrets->>n_audit: audit.log
Note over n_oncall,n_safe: Когда лежит сам менеджер: break-glass
n_oncall->>n_safe: 04:12 BREAK-GLASS shop-db opened by oncall_1D2
direction: right
n_orders: "Сервис заказов" {
shape: rectangle
}
n_reports: "Джоб отчётов" {
shape: rectangle
style.multiple: true
}
n_db: "БД магазина" {
shape: cylinder
}
n_secrets: "Менеджер секретов" {
shape: rectangle
style.fill: "#fde2e2"
style.stroke: "#c62828"
style.stroke-dash: 3
}
n_issuer: "Выдача identity" {
shape: cloud
}
n_kms: "KMS" {
shape: cloud
}
n_partner: "API партнёра" {
shape: cloud
}
n_audit: "Журнал аудита" {
shape: stored_data
}
n_oncall: "Дежурный" {
shape: person
}
n_safe: "Запечатанный сейф" {
shape: stored_data
}
n_orders -> n_db
n_reports -> n_db
n_orders -> n_secrets {
target-arrowhead.shape: cross
}
n_reports -> n_secrets {
target-arrowhead.shape: cross
}
n_secrets -> n_issuer
n_secrets -> n_db
n_secrets -> n_kms
n_orders -> n_partner
n_secrets -> n_partner
n_secrets -> n_audit
n_oncall -> n_safe
n_oncall -> n_db: "повтор" {
style.stroke-dash: 3
}PlantUML: последовательность запросов
@startuml
database "Git-репозиторий" as n_repo
participant "Сервис заказов" as n_orders
boundary "Злоумышленник" as n_intruder
database "БД магазина" as n_db
participant "Менеджер секретов" as n_secrets
boundary "KMS" as n_kms
boundary "API партнёра" as n_partner
database "Журнал аудита" as n_audit
actor "Дежурный" as n_oncall
database "Запечатанный сейф" as n_safe
note over n_repo, n_orders : Пароль живёт в файле в репозитории
n_repo -> n_orders : $ cat services/orders/.env
note over n_intruder, n_db : Утёк бэкап репозитория, кто-то заходит
n_intruder -> n_db : 02:14:07 LOG connection authorized: user=app database=shop
note over n_orders, n_db : Срочная ротация роняет оформление заказа
n_orders -> n_db : 02:31:00 admin ALTER ROLE app PASSWORD '***'
note over n_orders, n_secrets : Секреты переезжают в менеджер секретов
n_orders -> n_secrets : GET /v1/secret/shop/db HTTP/1.1
n_secrets --> n_orders : HTTP/1.1 200 OK
note over n_orders, n_secrets : Сервис доказывает, кто он, без хранимого токена
n_orders -> n_secrets : POST /v1/auth/workload/login HTTP/1.1
n_secrets --> n_orders : HTTP/1.1 200 OK
note over n_orders, n_secrets : Каждый сервис получает своего пользователя БД с lease
n_orders -> n_secrets : GET /v1/database/creds/orders-rw HTTP/1.1
n_secrets --> n_orders : HTTP/1.1 200 OK
note over n_secrets, n_db : Что менеджер делает в базе
n_secrets -> n_db : CREATE ROLE "v-orders-h7Kq" LOGIN PASSWORD '***'
n_db --> n_secrets : CREATE ROLE
note over n_secrets, n_kms : Секреты на диске зашифрованы, корневой ключ в KMS
n_secrets -> n_kms : POST /v1/keys/secrets-root/decrypt HTTP/1.1
n_kms --> n_secrets : HTTP/1.1 200 OK
note over n_secrets, n_partner : Ротация без простоя: две версии перекрываются
n_secrets -> n_partner : 03:00:00 rotate partner/api-key: created version 8
note over n_secrets, n_audit : Каждое чтение в журнале, чужое чтение видно
n_secrets -> n_audit : audit.log
note over n_oncall, n_safe : Когда лежит сам менеджер: break-glass
n_oncall -> n_safe : 04:12 BREAK-GLASS shop-db opened by oncall_1
@endumlPlantUML: компоненты
@startuml
left to right direction
component "Сервис заказов" as n_orders
collections "Джоб отчётов" as n_reports
database "БД магазина" as n_db
component "Менеджер секретов" as n_secrets #fde2e2;line:c62828;line.dashed
cloud "Выдача identity" as n_issuer
cloud "KMS" as n_kms
cloud "API партнёра" as n_partner
storage "Журнал аудита" as n_audit
actor "Дежурный" as n_oncall
storage "Запечатанный сейф" as n_safe
n_orders --> n_db
n_reports --> n_db
n_orders -[#c62828]-> n_secrets
n_reports -[#c62828]-> n_secrets
n_secrets --> n_issuer
n_secrets --> n_db
n_secrets --> n_kms
n_orders --> n_partner
n_secrets --> n_partner
n_secrets --> n_audit
n_oncall --> n_safe
n_oncall ..> n_db : повтор
@endumlИтог
Шесть правил для секретов.
1) Никаких секретов в репозиториях, образах и env-файлах; всё, что было в git, утекло. 2) Сервисы доказывают, кто они, через workload identity, а не хранимый токен. 3) Предпочитайте динамические доступы на сервис с lease и минимумом прав. 4) Шифруйте секреты на диске envelope-шифрованием, корневой ключ — в KMS. 5) Ротируйте с двумя перекрывающимися версиями и отзывайте старую, только когда ей перестали пользоваться. 6) Аудит каждого чтения, алерты на отказы и проверенный break-glass на двоих.
Показатели: в начале и в конце
| Показатель | В начале | В конце |
|---|---|---|
| Копий статик-секрета | 9 | 1 |
| Сервисов на утечку | 5 | 1 |
| Простой при ротации | 0 с | 0 с |
| Чтений в аудите | 0% | 100% |
Шаги
- Кейс Пароль живёт в файле в репозитории
Сервис заказов читает логин к базе из файла
.env. - Проблема Утёк бэкап репозитория, кто-то заходит
Бэкап ноутбука с репозиторием три дня лежал в открытом доступе.
- Проблема Срочная ротация роняет оформление заказа
Админ меняет пароль в 02:31.
- Решение Секреты переезжают в менеджер секретов
Пароль убирают из репозитория и чистят историю git.
- Решение Сервис доказывает, кто он, без хранимого токена
Платформа, на которой крутятся поды, выдаёт каждому подписанный короткоживущий токен: «я сервис заказов в namespace shop».
- Решение Каждый сервис получает своего пользователя БД с lease
Сервис заказов больше не читает сохранённый пароль, а запрашивает доступ.
- Кейс Что менеджер делает в базе
У менеджера один админский логин в базу — только чтобы создавать и удалять пользователей.
- Решение Секреты на диске зашифрованы, корневой ключ в KMS
Менеджер хранит секреты в своём хранилище, а с хранилища снимают бэкапы.
- Решение Ротация без простоя: две версии перекрываются
Не все секреты бывают динамическими: API-ключ партнёра выдаёт сам партнёр.
- Решение Каждое чтение в журнале, чужое чтение видно
Каждый запрос к менеджеру пишет запись аудита: какой workload, какой путь, результат и откуда.
- Кейс Когда лежит сам менеджер: break-glass
В 04:12 менеджер секретов лежит, сервисы не могут получить доступы.
- Итоги Итог
Шесть правил для секретов.
Термины
- Менеджер секретов
- Сервис, который хранит секреты, проверяет вызывающего и отдаёт только разрешённое ему, записывая каждое чтение в аудит.
- Динамические доступы
- Пользователь БД или ключ, который создаётся для конкретного сервиса по запросу и удаляется по истечении lease.
- Workload identity
- Подписанный короткоживущий токен, который платформа выдаёт сервису, чтобы тот доказал, кто он, без хранимого секрета.