轮换 KEK 后旧数据仍能解:明文 DEK 缓存、key_id 比对与 3 分钟窗口
现象:换了 KEK,旧密钥还在被调用
KEK 轮换完成,新写入的数据开始用新版本包 DEK,但监控里旧 KEK 的 Decrypt 调用没有归零:旧对象照样能读,进程不重启就一直读得到。第一反应通常是“轮换没生效”,实际上轮换只换了 DEK 的外壳,数据密文和内存里的明文 DEK 都没动。
KMS 信封加密的分层是:本地生成一次性 DEK 加密数据;DEK 被 KEK(CMK)加密成 DEK 密文,与数据密文一起落盘。解密时先调 KMS 把 DEK 密文解成明文放内存,再用明文 DEK 解数据。明文 DEK 不落盘、不打日志——腾讯云文档明确要求不要将 DEK 明文打印到日志。
密钥层次与三个默认值
阿里云 GenerateDataKey 返回明文与密文,DEK 密文由密钥以 GCM 模式加密明文 DEK 生成;需要保存数据密文、数据密钥密文、KMS 密钥身份与加密参数;数据密钥建议 24 字节及以上,AES 需 16/24/32 字节。腾讯云建议 DEK 密文落盘(DB / 配置文件),解密时调 Decrypt 解出明文缓存在内存,以减少云 API 调用次数;也可复用一个 DEK 一段时间,或按用户/时间分 DEK 避免重复。参见阿里云信封加密、腾讯云 KMS 文档。
三个默认值决定了“轮换不等于立刻失效”:
- DEK 明文在内存里缓存,生命周期跟进程走,跟 KEK 版本无关。
- encryption context 进 AAD。AWS 把它合并进密文的 AAD,
Encrypt时指定了,Decrypt必须指定,否则解密失败;它不在响应里返回,但会进 CloudTrail。字段少一个报的是解密失败,看起来像密钥错。 - KMS 单次加密有明文上限,超了必须走信封加密:
| 服务 | 单次 Encrypt 明文上限 | 依据 |
|---|---|---|
| AWS KMS | 4 KB | KMS 密码学细节 |
| GCP Cloud KMS | 64 KiB | Envelope encryption |
AWS 的 GenerateDataKey 返回 {CiphertextBlob, KeyId, Plaintext},KeySpec 与 NumberOfBytes 必须二选一。每次加密在 HSM 内用一次性随机数派生密钥,所以同样明文、同样 KEK,每次 CiphertextBlob 都不同。GCP 侧 KMS 只管 KEK,DEK 本地生成,每次写入生成新 DEK,因此不需要轮换 DEK,也不要用同一 DEK 加密两个不同用户的数据。Tink 的 KmsEnvelopeAead 每次加密新建 AEAD DEK 并写进密文(密文稍长),每次加解密都向 KMS 发 RPC;另一种用法是用 KMS 加密 keyset 以限制调用次数,见 Tink client-side encryption。
rewrap 与重加密不是一回事
ReEncrypt 只换 DEK 的外壳:把 DEK 密文从旧 KEK 下换到新 KEK 下,数据密文本体不变。全量重加密(新 DEK 重新加密数据)只在怀疑 DEK 泄露或换算法时才做。
判断一条数据要不要处理,看它记录的 key_id,不看 KEK 的创建时间。key_id 还是旧的,就 rewrap;已经是当前 KEK 的 key_id,跳过。
缓存带来的失效点
Kubernetes KMS 驱动(envelope)的规则最典型:etcd 数据用 DEK 加密,DEK 由远端 KMS 的 KEK 加密存储。v1 已被弃用(1.28 弃用、1.29 默认禁用),配置里有 cachesize(以明文缓存的 DEK 数量)和 timeout(默认 3 秒)。v2 不支持 cachesize:一旦服务器通过 KMS 解密了 DEK,所有 DEK 以明文缓存在内存,可无限期用于解密,无需再次调用 KMS。详见 Kubernetes KMS 提供程序文档。
v2 插件协议的关键约束:
Status返回version/healthz/key_id;API server 每分钟轮询一次,不健康时每 10 秒。EncryptRequest延迟目标 <100 ms;DecryptRequest<10 ms,因为启动时可能执行数千次以填充 watch cache。- 所有不同明文必须产生不同的
(ciphertext, key_id, annotations)。 Status与EncryptRequest返回的 key_id 必须一致,否则响应被丢弃、插件被判不健康。- key_id 不得复用:A→B→A 要报
A_001或新值。key_id 变化即表示远程 KEK 已更换,旧 KEK 数据应标记过期。 - 因为轮询每分钟一次、且 3 分钟内以最近有效状态为准,被动迁移要在 KEK 轮换后 3+N+M 分钟执行(N 为插件观察时间,M 缓冲至少 5 分钟)。轮换不需要重启 API server。
- 由于不控制 DEK 使用次数,K8s 建议至少每 90 天轮换一次 KEK。
结论:退役旧 KEK 前,必须确认没有进程还缓存着由它包出来的 DEK。
每次 GenerateDataKey 返回不同密文
同样的明文、同样的 KEK,CiphertextBlob 每次都不同,所以 DEK 密文不能当幂等键或去重键;拿它做“同一请求只处理一次”的判据,永远不命中。
Go:缓存 + key_id 比对 + rewrap
type dekEntry struct {
plain []byte
keyID string // 包出这枚 DEK 的 KEK 版本
encCtx map[string]string // 与加密时逐字一致
}
// 解密:命中缓存也要比 key_id,不一致就重新 Decrypt
func (s *Store) dek(ctx context.Context, blob []byte, wantKeyID string,
encCtx map[string]string) ([]byte, error) {
id := sha256.Sum256(blob)
if e, ok := s.get(id); ok && e.keyID == wantKeyID {
return e.plain, nil
}
out, err := s.kms.Decrypt(ctx, &kms.DecryptInput{
CiphertextBlob: blob,
EncryptionContext: encCtx, // 少一个 key 就解密失败,不是密钥错
KeyId: wantKeyID,
})
if err != nil {
return nil, err
}
if out.KeyId != wantKeyID { // 防止解到非预期 KEK
return nil, fmt.Errorf("key_id mismatch: got %s want %s", out.KeyId, wantKeyID)
}
s.put(id, &dekEntry{plain: out.Plaintext, keyID: wantKeyID, encCtx: encCtx})
return out.Plaintext, nil
}
// 轮换后:只对 key_id 落后的记录 rewrap,数据密文不动
func (s *Store) rewrap(ctx context.Context, r *Record) error {
if r.KeyID == s.currentKEKID {
return nil
}
out, err := s.kms.ReEncrypt(ctx, &kms.ReEncryptInput{
CiphertextBlob: r.WrappedDEK,
SourceEncryptionContext: r.EncCtx,
DestinationKeyId: s.currentKEKID,
DestinationEncryptionContext: r.EncCtx,
})
if err != nil {
return err
}
r.WrappedDEK, r.KeyID = out.CiphertextBlob, s.currentKEKID
return s.save(r) // 数据密文原样写回
}
清单
- 退役旧 KEK 前,确认没有进程缓存着由它包出的 DEK;滚动重启或等缓存自然过期。
- encryption context 全字段原样回传,少一个就解密失败,先查上下文再怀疑密钥。
- rewrap 的判据是数据记录里的
key_id,不是 KEK 创建时间;ReEncrypt不动数据密文。 - DEK 密文不当幂等键、不当去重键,每次
GenerateDataKey结果都不同。 - K8s 轮换后留足 3+N+M 分钟(M≥5),KEK 至少 90 天一轮,key_id 复用时换新值。
- 明文 DEK 只放内存,不落盘、不打日志。