Шпаргалка · Безопасность
Шифрование и секреты
Проблема
Приложение заметок хранит личные записи людей. Находим каждое место, где украденная копия читается: сеть, диск, бэкапы и файл конфигурации, — и закрываем их по одному.
Чему вы научитесь
- Что проверяет TLS-рукопожатие и почему сертификаты должны обновляться сами
- Шифрование данных на диске и почему ключ рядом с данными ничего не защищает
- Envelope-шифрование: свой data key на запись, master key никогда не покидает KMS
- Секреты в secrets manager с короткой арендой и ротация ключей без перешифрования всех данных
Диаграмма как код
Итоговая схема урока в виде текста: вставьте её в Jira, GitLab, GitHub, Notion или документацию, там Mermaid рисуется сам. Есть варианты для D2 и PlantUML (Confluence, IntelliJ).
Mermaid: схема
flowchart LR
n_app(["Мобильное приложение"])
n_api["API заметок"]
n_db[("База")]
n_attacker(("Злоумышленник"))
n_backup[("Бэкапы")]
n_kms>"KMS"]
n_secrets>"Secrets manager"]
n_app --> n_api
n_api --> n_db
n_db --> n_backup
n_backup --x|"потеряно"| n_attacker
n_api --x|"потеряно"| n_attacker
n_api --> n_kms
n_api -.->|"повтор"| n_secretsMermaid: последовательность запросов
sequenceDiagram
participant n_app as Мобильное приложение
participant n_api as API заметок
participant n_ca as Удостоверяющий центр
participant n_backup as Бэкапы
actor n_attacker as Злоумышленник
participant n_db as База
participant n_kms as KMS
participant n_secrets as Secrets manager
Note over n_app,n_api: Заметки идут открытым текстом
n_app->>n_api: POST /notes HTTP/1.1
n_api-->>n_app: HTTP/1.1 201 Created
Note over n_app,n_api: TLS-рукопожатие: общий ключ и доказательство личности
n_app->>n_api: ClientHello
n_api-->>n_app: ServerHello + Certificate
Note over n_app,n_api: Сертификат истёк в полночь
n_app->>n_api: ClientHello
n_api-->>n_app: ServerHello + Certificate
Note over n_api,n_ca: Сертификаты продлеваются сами
n_api->>n_ca: POST /acme/new-order HTTP/1.1
n_ca-->>n_api: HTTP/1.1 201 Created
Note over n_backup,n_attacker: Бэкап утёк, и он открытым текстом
n_backup->>n_attacker: $ strings notes-2026-11-01.bak #124; grep -i door
Note over n_api,n_db: Шифровать заметку до сохранения
n_api->>n_db: INSERT INTO notes (id, owner, text_enc, nonce)
n_db-->>n_api: INSERT 0 1
Note over n_api,n_attacker: Ключ лежит рядом с данными
n_api->>n_attacker: config/prod.json (from a leaked image)
Note over n_api,n_kms: Envelope-шифрование через KMS
n_api->>n_kms: POST /v1/keys/notes-master:generateDataKey HTTP/1.1
n_kms-->>n_api: HTTP/1.1 200 OK
Note over n_api,n_secrets: Никаких секретов в коде: secrets manager
n_api->>n_secrets: GET /v1/secret/notes-db HTTP/1.1
n_secrets-->>n_api: HTTP/1.1 200 OK
Note over n_api,n_kms: Ротация без перешифрования данных
n_api->>n_kms: POST /v1/keys/notes-master:reEncrypt HTTP/1.1
n_kms-->>n_api: HTTP/1.1 200 OKD2
direction: right
n_app: "Мобильное приложение" {
shape: rectangle
}
n_api: "API заметок" {
shape: rectangle
}
n_db: "База" {
shape: cylinder
}
n_attacker: "Злоумышленник" {
shape: person
}
n_backup: "Бэкапы" {
shape: stored_data
}
n_kms: "KMS" {
shape: cloud
}
n_secrets: "Secrets manager" {
shape: cloud
}
n_app -> n_api
n_api -> n_db
n_db -> n_backup
n_backup -> n_attacker: "потеряно" {
style.stroke-width: 4
target-arrowhead.shape: cross
}
n_api -> n_attacker: "потеряно" {
style.stroke-width: 4
target-arrowhead.shape: cross
}
n_api -> n_kms
n_api -> n_secrets: "повтор" {
style.stroke-dash: 3
}PlantUML: последовательность запросов
@startuml
participant "Мобильное приложение" as n_app
participant "API заметок" as n_api
boundary "Удостоверяющий центр" as n_ca
database "Бэкапы" as n_backup
actor "Злоумышленник" as n_attacker
database "База" as n_db
boundary "KMS" as n_kms
boundary "Secrets manager" as n_secrets
note over n_app, n_api : Заметки идут открытым текстом
n_app -> n_api : POST /notes HTTP/1.1
n_api --> n_app : HTTP/1.1 201 Created
note over n_app, n_api : TLS-рукопожатие: общий ключ и доказательство личности
n_app -> n_api : ClientHello
n_api --> n_app : ServerHello + Certificate
note over n_app, n_api : Сертификат истёк в полночь
n_app -> n_api : ClientHello
n_api --> n_app : ServerHello + Certificate
note over n_api, n_ca : Сертификаты продлеваются сами
n_api -> n_ca : POST /acme/new-order HTTP/1.1
n_ca --> n_api : HTTP/1.1 201 Created
note over n_backup, n_attacker : Бэкап утёк, и он открытым текстом
n_backup -> n_attacker : [дубль] $ strings notes-2026-11-01.bak | grep -i door
note over n_api, n_db : Шифровать заметку до сохранения
n_api -> n_db : INSERT INTO notes (id, owner, text_enc, nonce)
n_db --> n_api : INSERT 0 1
note over n_api, n_attacker : Ключ лежит рядом с данными
n_api -> n_attacker : [дубль] config/prod.json (from a leaked image)
note over n_api, n_kms : Envelope-шифрование через KMS
n_api -> n_kms : POST /v1/keys/notes-master:generateDataKey HTTP/1.1
n_kms --> n_api : HTTP/1.1 200 OK
note over n_api, n_secrets : Никаких секретов в коде: secrets manager
n_api -> n_secrets : GET /v1/secret/notes-db HTTP/1.1
n_secrets --> n_api : HTTP/1.1 200 OK
note over n_api, n_kms : Ротация без перешифрования данных
n_api -> n_kms : POST /v1/keys/notes-master:reEncrypt HTTP/1.1
n_kms --> n_api : HTTP/1.1 200 OK
@endumlPlantUML: компоненты
@startuml
left to right direction
agent "Мобильное приложение" as n_app
component "API заметок" as n_api
database "База" as n_db
actor "Злоумышленник" as n_attacker
storage "Бэкапы" as n_backup
cloud "KMS" as n_kms
cloud "Secrets manager" as n_secrets
n_app --> n_api
n_api --> n_db
n_db --> n_backup
n_backup -[#c62828,dashed]-> n_attacker : потеряно
n_api -[#c62828,dashed]-> n_attacker : потеряно
n_api --> n_kms
n_api ..> n_secrets : повтор
@endumlИтог
Найдите каждое место, где живёт копия данных, и закройте каждое.
1) TLS на каждом соединении, сертификаты продлеваются сами, алерт до истечения. 2) Шифрование на диске, включая бэкапы. 3) Envelope-шифрование: data key на запись, master key только в KMS. 4) Секреты в secrets manager с короткой арендой, никогда в коде. 5) Ротация переоборачиванием ключей, а не перешифрованием данных.
Показатели: в начале и в конце
| Показатель | В начале | В конце |
|---|---|---|
| Читаемые копии | 4 | 0 |
| Ответ p95 | 120 мс | 158 мс |
| Ошибки запросов | 0% | 0% |
Шаги
- Проблема Заметки идут открытым текстом
Приложение отправляет заметки по обычному HTTP.
- Решение TLS-рукопожатие: общий ключ и доказательство личности
До любых данных приложение и сервер договариваются о новом ключе: каждый отправляет публичную половину
key_share, и оба вычисляют один и тот же секрет. - Проблема Сертификат истёк в полночь
Сертификат продлевали вручную раз в год.
- Решение Сертификаты продлеваются сами
Теперь сервер сам запрашивает у CA новый сертификат по протоколу ACME.
- Проблема Бэкап утёк, и он открытым текстом
Ночные бэкапы ложатся в бакет хранилища.
- Решение Шифровать заметку до сохранения
Теперь API шифрует заметку AES-256-GCM до
INSERT. - Проблема Ключ лежит рядом с данными
Образ контейнера с файлом конфигурации по ошибке попал в публичный registry.
- Решение Envelope-шифрование через KMS
Master key теперь живёт в KMS и никогда его не покидает.
- Решение Никаких секретов в коде: secrets manager
Пароль от базы уходит из файла конфигурации.
- Кейс Ротация без перешифрования данных
Раз в год KMS создаёт новую версию master key, а старые версии остаются для расшифровки старых данных.
- Итоги Итоги
Найдите каждое место, где живёт копия данных, и закройте каждое.
Термины
- TLS
- Протокол шифрования соединения: при рукопожатии стороны договариваются об общем ключе, а сервер доказывает личность сертификатом. Сертификаты должны продлеваться сами, иначе истекут в полночь.
- Шифрование на диске (at rest)
- Данные шифруют до записи в базу, и на дисках и в бэкапах остаётся только шифртекст. Если ключ лежит рядом с данными, это ничего не защищает.
- Envelope-шифрование (KMS)
- Каждую запись шифруют своим data key, а data key заворачивают master key, который не покидает KMS. В базе лежит только завёрнутый ключ, а ротация требует перезавернуть ключи, а не перешифровать данные.