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_KMSorigin 的密钥材料由 KMS 在 Region 间安全传输;EXTERNAL(imported)origin 需要向每个副本 Region 单独导入同一份密钥材料,漏一个 Region 就没有可解密的副本。
不共享的东西才是真正容易出错的地方
| 同步(相关密钥一致) | 不同步(每 Region 独立) |
|---|---|
| key ID、key material | key 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 归属在设计期就定下来。