mufassall

Шпаргалка · Безопасность

Управление секретами

13 мин · Средний · mufassall.dtwin.uz/ru/l/secrets-management/

← Открыть урок

Проблема

Бэкенд магазина хранит пароль от базы в закоммиченном .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 down

Mermaid: последовательность запросов

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_1

D2

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
@enduml

PlantUML: компоненты

@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 на двоих.

Показатели: в начале и в конце

ПоказательВ началеВ конце
Копий статик-секрета91
Сервисов на утечку51
Простой при ротации0 с0 с
Чтений в аудите0%100%

Шаги

  1. Кейс Пароль живёт в файле в репозитории

    Сервис заказов читает логин к базе из файла .env.

  2. Проблема Утёк бэкап репозитория, кто-то заходит

    Бэкап ноутбука с репозиторием три дня лежал в открытом доступе.

  3. Проблема Срочная ротация роняет оформление заказа

    Админ меняет пароль в 02:31.

  4. Решение Секреты переезжают в менеджер секретов

    Пароль убирают из репозитория и чистят историю git.

  5. Решение Сервис доказывает, кто он, без хранимого токена

    Платформа, на которой крутятся поды, выдаёт каждому подписанный короткоживущий токен: «я сервис заказов в namespace shop».

  6. Решение Каждый сервис получает своего пользователя БД с lease

    Сервис заказов больше не читает сохранённый пароль, а запрашивает доступ.

  7. Кейс Что менеджер делает в базе

    У менеджера один админский логин в базу — только чтобы создавать и удалять пользователей.

  8. Решение Секреты на диске зашифрованы, корневой ключ в KMS

    Менеджер хранит секреты в своём хранилище, а с хранилища снимают бэкапы.

  9. Решение Ротация без простоя: две версии перекрываются

    Не все секреты бывают динамическими: API-ключ партнёра выдаёт сам партнёр.

  10. Решение Каждое чтение в журнале, чужое чтение видно

    Каждый запрос к менеджеру пишет запись аудита: какой workload, какой путь, результат и откуда.

  11. Кейс Когда лежит сам менеджер: break-glass

    В 04:12 менеджер секретов лежит, сервисы не могут получить доступы.

  12. Итоги Итог

    Шесть правил для секретов.

Термины

Менеджер секретов
Сервис, который хранит секреты, проверяет вызывающего и отдаёт только разрешённое ему, записывая каждое чтение в аудит.
Динамические доступы
Пользователь БД или ключ, который создаётся для конкретного сервиса по запросу и удаляется по истечении lease.
Workload identity
Подписанный короткоживущий токен, который платформа выдаёт сервису, чтобы тот доказал, кто он, без хранимого секрета.