Skip to content

Commit 29f14bf

Browse files
committed
docs(kms): clarify rotation features and disk rollback
Signed-off-by: Kevin Wang <wy721@qq.com>
1 parent ad3ad85 commit 29f14bf

2 files changed

Lines changed: 12 additions & 3 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
### Added
11+
12+
- KMS root and application key epochs, epoch-scoped authorization, SealedEnv
13+
HPKE encryption, automatic environment migration, and epoch-aware SDK key
14+
selection.
15+
1016
### Changed
1117

1218
- KMS: retain `GetTempCaCert`, temporary CA files and legacy handover fields so

‎docs/app-key-epochs.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,9 +49,12 @@ regardless of epoch selection; historical responses cannot replace that pin.
4949
The guest migrates disk headers and environment ciphertext if either dimension
5050
changes and rejects future epochs in either dimension. LUKS tokens record both
5151
epochs (missing app epoch means zero). Rekeying replaces the keyslot wrapping key;
52-
it does not rotate the volume encryption key or erase host snapshots. App
53-
rotation isolates future app keys from an exposed old derived key, but cannot
54-
recover from compromise of the KMS root or revoke already disclosed secrets.
52+
it does not rotate the volume encryption key or erase host snapshots. Once a disk
53+
header carries an epoch token, older guest images reject that header as malformed;
54+
reverting the VM image therefore requires migrating the disk with a compatible
55+
image or restoring a compatible header backup. App rotation isolates future app
56+
keys from an exposed old derived key, but cannot recover from compromise of the
57+
KMS root or revoke already disclosed secrets.
5558

5659
## SDK selection
5760

0 commit comments

Comments
 (0)