编程 信封加密轮换 KEK 后旧数据还能解:明文 DEK 缓存、key_id 比对与 3+N+M 分钟窗口

2026-11-23 00:05:36

轮换 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 文档。

三个默认值决定了“轮换不等于立刻失效”:

  1. DEK 明文在内存里缓存,生命周期跟进程走,跟 KEK 版本无关。
  2. encryption context 进 AAD。AWS 把它合并进密文的 AAD,Encrypt 时指定了,Decrypt 必须指定,否则解密失败;它不在响应里返回,但会进 CloudTrail。字段少一个报的是解密失败,看起来像密钥错。
  3. KMS 单次加密有明文上限,超了必须走信封加密:
服务单次 Encrypt 明文上限依据
AWS KMS4 KBKMS 密码学细节
GCP Cloud KMS64 KiBEnvelope 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 只放内存,不落盘、不打日志。
复制全文 生成海报 信封加密 KMS 密钥轮换 DEK etcd 加密 Go

推荐文章

程序员茄子在线接单