编程 DEK 密文跨 Region 解不开:只有 mrk- 同 key ID 能直解,其余一律要 rewrap

2026-11-23 00:06:28

DEK 密文跨 Region 解不开:只有 mrk- 同 key ID 能直解,其余一律要 rewrap

现象:数据已经复制过去了,读取时报告 key 不可访问

社区问答(repost.aws)里有一个案例:把一个用 KMS 加密的 AMI 跨账号复制到另一个账号的某个 Region,复制完成后,在目标 Region 启动时报告:

One or more of the attached Amazon EBS volumes are encrypted with an inaccessible AWS KMS key

同一账号内的两个 Region 都正常,只有跨账号那条路径失败;也有用 KMSInvalidStateException 一类的报错形式。帖子的结论是:多区域密钥不会跨账号自动共享,每个 Region 的副本密钥的 key policy / grants 都要单独配置跨账号访问。现象本身来自这则社区帖子,下面按机制拆开。

机制:KMS 把 key ID 绑进了密文

AWS KMS 在加密时会把 KMS 密钥的 key ID 绑定到密文里,因此密文只能用该密钥、或同 key ID 的密钥解密(mrk-how-it-works)。

这条规则直接推出两个结论:

  • 把 DEK 的密文换一个 KEK,指望直接 Decrypt 成功,基本上不可能。目标 KEK 的 key ID 和密文里绑的不一样,解不开是设计如此,不是配置漏了。
  • 唯一能“直接解”的情况是两把 KEK 共享同一个 key ID —— 也就是相关多区域密钥(related multi-Region keys)。

所以迁移路径只有两条:同 key ID 多区域密钥 → 密文原样搬;其他一切情况 → 解出明文 DEK,在目标 KEK 下重新加密(rewrap)。

mrk- 多区域密钥的确切规则

  • key ID 以 mrk- 开头,一组相关多区域密钥共享相同的 key material 和相同的 key ID,key ARN 只在 Region 字段上不同:
arn:aws:kms:us-east-1:111122223333:key/mrk-1234...
arn:aws:kms:eu-west-1:111122223333:key/mrk-1234...
  • 任何一副本密钥都能解密任何相关密钥加密的密文,包括该副本创建之前产生的密文。加密时间不影响互换性。
  • 单区域 / 多区域属性在创建时决定,之后不可转换。已有单区域密钥加密的负载要进多区域场景,只能重新加密(或用新的多区域密钥重新签名)。
  • 多区域密钥不是全局的:在同一 AWS partition 内,建好 primary 后手动 ReplicateKey 到选定 Region,AWS 不会自动复制。AWS managed key 始终是单区域。
  • 每个 Region 只能有一把相关密钥(primary 或 replica);多区域密钥不能建在 custom key store 里。
  • AWS_KMS origin 的密钥材料由 KMS 在 Region 间安全传输;EXTERNAL(imported)origin 需要向每个副本 Region 单独导入同一份密钥材料,漏一个 Region 就没有可解密的副本。

不共享的东西才是真正容易出错的地方

同步(相关密钥一致)不同步(每 Region 独立)
key ID、key materialkey policy、grants
origin、key spec / 算法、key usage启停状态(Enabled/Disabled)
自动轮换开关(只在 primary 上开关)description、alias、tag

key policy 不同步这一点,是跨账号场景的主要问题。控制台会把 primary 的 policy 显示出来方便查看,但不代表副本 Region 生效,必须逐 Region 单独授权。社区案例里“us-east 通、us-west 不通”,原因就是这个。

IAM 侧还有一处容易出错:带通配 Resource 的旧语句现在同时匹配单区域密钥和多区域密钥,需要区分时用 kms:MultiRegion(bool)或 kms:MultiRegionKeyType(PRIMARY / REPLICA)条件键来限定(multi-region-keys-auth)。aws:RequestedRegion 限制的是调用发往哪个 Region。grants 同样是区域性的,一个 grant 只对一把 KMS 密钥授权,不能覆盖整组相关密钥。

服务侧:即便两端都是 mrk-,仍然 rewrap

  • S3 跨区域复制(CRR):即使源桶和目标桶用的是相关多区域密钥,目标 Region 仍会对 data key 做 decrypt + re-encrypt。多数集成 KMS 的托管服务把多区域密钥当单区域密钥处理。
  • Secrets Manager 跨账号复制:每次复制都是两步 KMS 调用,kms:Decrypt(主密钥)→ kms:Encrypt(副本密钥)。两种授权方式:推荐 replication role(要求主密钥是 customer managed key,因为 aws/secretsmanager 托管密钥不支持服务角色调用 Decrypt),或 forward access session(调用者自己同时持有两边权限)。副本密钥的 key policy 必须授予主账户 kms:Encrypt,可用 SecretARN 作为 encryption context 收敛范围。RCP / SCP 也可能在半路拦掉这些调用,详见跨账号复制权限。

也就是说:服务层的“复制”不等于密文搬运,KMS 层的 rewrap 是隐式发生的,权限缺一不可。

跨云:KEK 出不去,只能在目标 KEK 下重包

KMS 的 KEK 不可导出。DEK 的密文一旦离开这家 KMS,任何外部系统都解不开——不是缺工具,是没有密钥材料。跨云迁移只有一条路:源侧 Decrypt 出明文 DEK,在目标云 KMS 的 KEK 下 Encrypt 成新密文。中间存在一段明文窗口,要放在受控进程里,尽量短。

这也是设计期问题:KEK 归属哪个云、哪个账号、哪个 Region,决定了后面能不能只搬密文。定错了,每次迁移都要付一次明文窗口的代价。multi-region-keys-overview 里对“什么时候该用多区域密钥”有正面说明,值得在建模阶段就对照。

Go:先判断能不能直解,否则走 rewrap

思路是先用 DescribeKey 拿目标密钥元数据做前置检查,能直解就整批搬密文;否则逐条 Decrypt + Encrypt,每条成功后写检查点,崩了从断点续。

var mrkRe = regexp.MustCompile(`mrk-[0-9a-f]{32}`)

// preflight 检查密钥状态与 key policy 可读性,权限不足在这里就失败,不要等到批量跑到一半。
func preflight(ctx context.Context, c *kms.Client, keyID string) (*types.KeyMetadata, error) {
	out, err := c.DescribeKey(ctx, &kms.DescribeKeyInput{KeyId: aws.String(keyID)})
	if err != nil {
		return nil, fmt.Errorf("describe %s: %w", keyID, err)
	}
	m := out.KeyMetadata
	if m.KeyState != types.KeyStateEnabled {
		return nil, fmt.Errorf("%s state=%s", keyID, m.KeyState)
	}
	if _, err := c.GetKeyPolicy(ctx, &kms.GetKeyPolicyInput{
		KeyId: aws.String(keyID), PolicyName: aws.String("default"),
	}); err != nil {
		return nil, fmt.Errorf("read key policy of %s (need kms:GetKeyPolicy): %w", keyID, err)
	}
	return m, nil
}

// canDecryptInPlace:目标密钥是多区域密钥,且与源密钥共享同一个 mrk- key ID。
// 满足则密文原样可用,一次 KMS 调用都不需要。
func canDecryptInPlace(src, dst *types.KeyMetadata) bool {
	if src == nil || dst == nil || dst.MultiRegion == nil || !*dst.MultiRegion {
		return false
	}
	s, d := mrkRe.FindString(aws.ToString(src.KeyId)), mrkRe.FindString(aws.ToString(dst.KeyId))
	return s != "" && s == d
}

func (m *Migrator) Migrate(ctx context.Context, srcKeyID, dstKeyID string, blobs [][]byte) error {
	srcMeta, err := preflight(ctx, m.Src, srcKeyID)
	if err != nil {
		return err
	}
	dstMeta, err := preflight(ctx, m.Dst, dstKeyID)
	if err != nil {
		return err
	}

	if canDecryptInPlace(srcMeta, dstMeta) {
		return m.writeAll(blobs) // 密文原样搬,不产生明文
	}

	for i, blob := range blobs {
		if m.done(i) { // 断点:检查点文件里已有第 i 条
			continue
		}
		plain, err := m.Src.Decrypt(ctx, &kms.DecryptInput{CiphertextBlob: blob})
		if err != nil {
			return fmt.Errorf("item %d decrypt: %w", i, err)
		}
		enc, err := m.Dst.Encrypt(ctx, &kms.EncryptInput{
			KeyId: aws.String(dstKeyID), Plaintext: plain.Plaintext,
		})
		if err != nil {
			return fmt.Errorf("item %d encrypt: %w", i, err)
		}
		if err := m.commit(i, enc.CiphertextBlob); err != nil { // 先落盘,再释放明文
			return err
		}
		zero(plain.Plaintext) // 同一作用域内尽快抹掉,压缩明文窗口
	}
	return nil
}

m.Src / m.Dst 是不同 Region(或不同账号)的 KMS client。源密文若是相关密钥加密的,用副本侧 client 解也行,这里保留源 client 让逻辑更直白。

清单

迁移前逐条过:

  • 两把 KEK 的 key ARN 除 Region 外是否完全一致(mrk- 前缀 + 同 key ID)?只差 Region 才可能直解。
  • 目标是多区域密钥时,确认副本在每个需要的 Region 都已 ReplicateKey;imported key material 是否每个 Region 都单独导入过。
  • 每个 Region 的副本 key policy 是否单独放行了调用方(跨账号尤其)——不要看 primary 的控制台展示。
  • grants、alias、启停状态是否需要各 Region 单独处理。
  • IAM 通配 Resource 是否误命中多区域密钥,必要时加 kms:MultiRegionKeyType 条件。
  • 走 S3 CRR / Secrets Manager 复制时,把隐式 rewrap 的 Decrypt + Encrypt 权限都补齐,aws/secretsmanager 托管密钥不支持服务角色 Decrypt。
  • 跨云迁移确认明文 DEK 的窗口有边界,KEK 归属在设计期就定下来。
复制全文 生成海报 信封加密 KMS 密钥轮换 DEK 多区域密钥 Go

推荐文章

程序员茄子在线接单