mufassall

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

Шифрование и секреты

14 мин · Средний · mufassall.dtwin.uz/ru/l/encryption/

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

Проблема

Приложение заметок хранит личные записи людей. Находим каждое место, где украденная копия читается: сеть, диск, бэкапы и файл конфигурации, — и закрываем их по одному.

Чему вы научитесь

  • Что проверяет TLS-рукопожатие и почему сертификаты должны обновляться сами
  • Шифрование данных на диске и почему ключ рядом с данными ничего не защищает
  • Envelope-шифрование: свой data key на запись, master key никогда не покидает KMS
  • Секреты в secrets manager с короткой арендой и ротация ключей без перешифрования всех данных
Итоговая сцена
35%

Диаграмма как код

Итоговая схема урока в виде текста: вставьте её в 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_secrets

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

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 OK

D2

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

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

@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) Ротация переоборачиванием ключей, а не перешифрованием данных.

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

ПоказательВ началеВ конце
Читаемые копии40
Ответ p95120 мс158 мс
Ошибки запросов0%0%

Шаги

  1. Проблема Заметки идут открытым текстом

    Приложение отправляет заметки по обычному HTTP.

  2. Решение TLS-рукопожатие: общий ключ и доказательство личности

    До любых данных приложение и сервер договариваются о новом ключе: каждый отправляет публичную половину key_share, и оба вычисляют один и тот же секрет.

  3. Проблема Сертификат истёк в полночь

    Сертификат продлевали вручную раз в год.

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

    Теперь сервер сам запрашивает у CA новый сертификат по протоколу ACME.

  5. Проблема Бэкап утёк, и он открытым текстом

    Ночные бэкапы ложатся в бакет хранилища.

  6. Решение Шифровать заметку до сохранения

    Теперь API шифрует заметку AES-256-GCM до INSERT.

  7. Проблема Ключ лежит рядом с данными

    Образ контейнера с файлом конфигурации по ошибке попал в публичный registry.

  8. Решение Envelope-шифрование через KMS

    Master key теперь живёт в KMS и никогда его не покидает.

  9. Решение Никаких секретов в коде: secrets manager

    Пароль от базы уходит из файла конфигурации.

  10. Кейс Ротация без перешифрования данных

    Раз в год KMS создаёт новую версию master key, а старые версии остаются для расшифровки старых данных.

  11. Итоги Итоги

    Найдите каждое место, где живёт копия данных, и закройте каждое.

Термины

TLS
Протокол шифрования соединения: при рукопожатии стороны договариваются об общем ключе, а сервер доказывает личность сертификатом. Сертификаты должны продлеваться сами, иначе истекут в полночь.
Шифрование на диске (at rest)
Данные шифруют до записи в базу, и на дисках и в бэкапах остаётся только шифртекст. Если ключ лежит рядом с данными, это ничего не защищает.
Envelope-шифрование (KMS)
Каждую запись шифруют своим data key, а data key заворачивают master key, который не покидает KMS. В базе лежит только завёрнутый ключ, а ротация требует перезавернуть ключи, а не перешифровать данные.