AWS Nitro Enclaves 与 KMS 远程证明实战
文章目录
在 MPC 钱包、签名服务这类场景里,私钥只要以明文出现在内存里,就有被拿走的风险。服务器上的 root、运维同学,或者一个被打穿的依赖,都可能读到它。可信执行环境(TEE)要解决的就是这个问题:让密钥只在一个连宿主机都看不见的地方被使用,并且能向外界证明”确实如此”。
AWS 给出的答案是 Nitro Enclaves。本文先介绍它的原理,然后用一个 Go demo 走完完整链路:enclave 向 KMS 证明自己的身份,拿到密钥,再把计算结果连同证明交给任意第三方去验证。
1. Nitro Enclaves 是什么
Nitro Enclaves 是 2020 年推出的 EC2 功能。它从一台普通 EC2 实例(父实例)里切出一部分 vCPU 和内存,交给 Nitro Hypervisor 单独起一个虚拟机,这个虚拟机就是 enclave。切出去的资源由 enclave 独占,父实例和 enclave 之间没有共享内存。即使是父实例的 root,也无法读取 enclave 的内存。
enclave 默认非常”贫瘠”:
- 没有持久化存储:重启之后所有数据消失
- 没有交互式访问:不能 SSH,也没有控制台(调试模式除外)
- 没有外部网络:不能访问 VPC,也不能访问互联网
它与外界唯一的通道是 vsock,即与父实例之间的本地虚拟 socket。父实例固定是 CID 3,enclave 启动时会分配一个 CID。攻击面就这样被压到了很小。
该功能不额外收费,只需支付父实例本身的费用。
2. 远程证明:Attestation Document
enclave 的价值不仅在于隔离,更在于可以证明自己是谁。
enclave 内有一个虚拟设备 /dev/nsm,也就是 Nitro Secure Module。程序可以通过它请求一份证明文档(Attestation Document)。这份文档是一个 COSE_Sign1 结构,载荷采用 CBOR 编码,签名证书链一直追溯到 AWS Nitro 根证书。其中最重要的字段如下:
| 字段 | 含义 |
|---|---|
| PCR0 | enclave 镜像文件(EIF)整体的 SHA-384 |
| PCR1 | Linux 内核与引导程序的哈希 |
| PCR2 | 用户应用的哈希 |
| PCR3 | 父实例 IAM 角色 ARN 的哈希 |
| PCR4 | 父实例 ID 的哈希 |
| PCR8 | EIF 签名证书的哈希 |
| public_key | 调用方自带的公钥(可选),最长 1024 字节 |
| user_data | 调用方自带的任意数据(可选),最长 512 字节 |
| nonce | 调用方自带的随机数(可选),最长 512 字节 |
验证方拿到这份文档后,可以确认三件事:
- 签名链有效,说明这确实是 Nitro 硬件生成的文档
- PCR0 与自己预期的镜像哈希一致,说明 enclave 里跑的是我认可的那份代码
public_key、user_data、nonce由这份代码填入,可以把任意数据绑定到上面
第 3 点是后面所有设计的基础:可信代码把什么放进 user_data,外界就能相信是它说的。
用
--debug-mode启动的 enclave,PCR 全部为 0。生产环境的验证一定要拒绝它。
3. 与 KMS 的集成
KMS 原生理解 attestation 文档。调用 Decrypt、GenerateDataKey、GenerateRandom 时,可以附带一个 Recipient 参数:
"Recipient": {
"AttestationDocument": "<base64 attestation doc>",
"KeyEncryptionAlgorithm": "RSAES_OAEP_SHA_256"
}
KMS 收到请求后会做三件事:
- 验证 attestation 文档的签名
- 用文档中的 PCR 值去匹配 Key Policy 里的
kms:RecipientAttestation:PCR0、kms:RecipientAttestation:ImageSha384等条件 - 不返回
Plaintext,而是用文档里的public_key把明文加密成 CMS EnvelopedData,放在CiphertextForRecipient中返回
这样一来,即使请求经由父实例转发,父实例看到的也只是密文。而且只要 Key Policy 写了 PCR 条件,父实例拿着同一个 IAM 角色直接调用 Decrypt 也会被拒绝:请求里没有 attestation,条件键不存在,条件就不成立。
{
"Sid": "OnlyTheEnclaveCanDecrypt",
"Effect": "Allow",
"Principal": { "AWS": "arn:aws:iam::111122223333:role/EnclaveParentRole" },
"Action": "kms:Decrypt",
"Resource": "*",
"Condition": {
"StringEqualsIgnoreCase": {
"kms:RecipientAttestation:PCR0": "<PCR0>"
}
}
}
4. Demo:在 enclave 里用 KMS 密钥,并让第三方远程验证
完整代码在 nitro-kms-demo 仓库,包含三个程序:
| 程序 | 运行位置 | 职责 |
|---|---|---|
cmd/enclave |
enclave 内 | NSM 证明、带 Recipient 的 KMS Decrypt、CMS 解密、HMAC |
cmd/parent |
父实例 | 获取实例角色凭证,通过 vsock 转发请求 |
cmd/verifier |
任意机器 | 校验签名链、PCR0、nonce,以及结果绑定 |
场景设定:KMS 中保存着一个 32 字节的密钥,只有 enclave 能解开。enclave 用它对调用方的消息计算 HMAC。第三方验证者不信任父实例,但希望确认两件事:
- 这个 HMAC 是用那把 KMS 密钥,在我审计过的代码里算出来的
- 这是对我这次请求的回答,不是重放的旧结果
4.1 整体时序
Verifier Parent (不可信) Enclave KMS
| | | |
|-- nonce ----------->| | |
| |-- vsock:5000 --------->| |
| | ciphertext, msg, | |
| | nonce, 角色凭证 | |
| | |-- 生成临时 RSA 密钥对 |
| | |-- NSM: attest(pubkey) = docA
| | | |
| |<== vsock:8000 (TLS 密文, vsock-proxy 转发) ======>|
| | |-- Decrypt(ct, Recipient=docA)
| | | 校验签名 + PCR0
| | |<- CiphertextForRecipient |
| | |-- RSA 私钥解 CMS → secret
| | |-- mac = HMAC(secret, msg)
| | |-- NSM: attest(user_data=H(result),
| | | nonce) = docB
| |<-- result + docB ------| |
|<-- response.json ---| | |
|-- 校验 docB: 签名链 / PCR0 / nonce / user_data == H(result) |
这里有两次证明:
- docA 给 KMS 看:KMS 据此确认 enclave 的身份,然后把明文加密给只存在于 enclave 内存里的公钥
- docB 给验证者看:它绑定了这次的计算结果和验证者给出的 nonce
信任链因此是:验证者相信 PCR0 对应的代码 → 代码只会在 KMS Decrypt 成功后才签出 docB → KMS 只会把明文交给 PCR0 匹配的 enclave。
4.2 Enclave:带 Recipient 调用 KMS
enclave 没有网络,所以要给 KMS 客户端换一个 HTTP Transport,把所有连接都拨到父实例的 vsock 8000 端口。父实例上的 vsock-proxy 再把流量原样转发到 kms.<region>.amazonaws.com:443。TLS 在 enclave 内终止,父实例只能看到密文。
func vsockHTTPClient() *http.Client {
return &http.Client{
Timeout: 30 * time.Second,
Transport: &http.Transport{
DialContext: func(ctx context.Context, _, _ string) (net.Conn, error) {
return vsock.Dial(protocol.ParentCID, protocol.KMSProxyPort, nil)
},
},
}
}
获取证明使用 github.com/hf/nsm:
func attest(publicKey, nonce, userData []byte) ([]byte, error) {
sess, err := nsm.OpenDefaultSession()
if err != nil {
return nil, err
}
defer sess.Close()
res, err := sess.Send(&request.Attestation{
PublicKey: publicKey,
Nonce: nonce,
UserData: userData,
})
if err != nil {
return nil, err
}
if res.Error != "" || res.Attestation == nil {
return nil, fmt.Errorf("nsm: %s", res.Error)
}
return res.Attestation.Document, nil
}
核心流程如下:
// 1. 临时密钥,只存在于这次请求的 enclave 内存中
priv, _ := rsa.GenerateKey(rand.Reader, 2048)
pubDER, _ := x509.MarshalPKIXPublicKey(&priv.PublicKey)
// 2. 给 KMS 的证明,携带公钥
kmsDoc, _ := attest(pubDER, nil, nil)
// 3. 带 Recipient 的 Decrypt
out, err := client.Decrypt(ctx, &kms.DecryptInput{
CiphertextBlob: req.Ciphertext,
Recipient: &types.RecipientInfo{
AttestationDocument: kmsDoc,
KeyEncryptionAlgorithm: types.KeyEncryptionMechanismRsaesOaepSha256,
},
})
secret, _ := cms.DecryptEnvelopedData(out.CiphertextForRecipient, priv)
defer clear(secret)
// 4. 使用密钥,但不让它离开 enclave
mac := hmac.New(sha256.New, secret)
mac.Write(req.Message)
result := &protocol.Result{KeyID: aws.ToString(out.KeyId), Message: req.Message, MAC: mac.Sum(nil)}
// 5. 给验证者的证明,绑定结果和 nonce
proof, _ := attest(nil, req.Nonce, result.Digest())
Digest() 对结果的每个字段做长度前缀拼接后取 SHA-256,正好 32 字节,可以放进 user_data。长度前缀是为了避免 ("ab","c") 和 ("a","bc") 这类字段边界歧义造成碰撞。
4.3 解析 CiphertextForRecipient
KMS 返回的是 RFC 5652 定义的 CMS EnvelopedData,结构大致如下:
ContentInfo
└─ EnvelopedData
├─ RecipientInfos
│ └─ KeyTransRecipientInfo
│ ├─ keyEncryptionAlgorithm = RSAES-OAEP (SHA-256)
│ └─ encryptedKey = RSA-OAEP(pubkey, CEK)
└─ EncryptedContentInfo
├─ contentEncryptionAlgorithm = AES-256-CBC, IV
└─ encryptedContent = AES-CBC(CEK, plaintext)
解密分两步:先用 RSA 私钥做 OAEP 解出内容加密密钥(CEK),再用 AES-256-CBC 解出明文。
麻烦在于这个结构可能采用 BER 编码,包括不定长和分段的 OCTET STRING,而 Go 的 encoding/asn1 只接受 DER。常见的 pkcs7 库对 OAEP 的支持也参差不齐。好在需要的子集很小,demo 里用一百多行代码实现了一个 BER 读取器(internal/cms),并用单元测试和 fuzz 测试覆盖了 DER 编码、BER 不定长编码,以及错误密钥、截断密文等情况。
4.4 Verifier:离线验证
验证者不需要任何 AWS 权限。github.com/hf/nitrite 内置了 AWS Nitro 根证书,可以完成证书链和 COSE 签名的校验,其余检查由我们自己完成:
res, err := nitrite.Verify(resp.Attestation, nitrite.VerifyOptions{CurrentTime: time.Now()})
if err != nil || !res.SignatureOK {
fail("attestation verification failed")
}
doc := res.Document
// 拒绝 debug enclave,并比对镜像度量
if bytes.Equal(doc.PCRs[0], make([]byte, 48)) { fail("debug mode") }
if !bytes.Equal(doc.PCRs[0], expectedPCR0) { fail("PCR0 mismatch") }
// 防重放:nonce 必须是我刚给出的
if !bytes.Equal(doc.Nonce, nonce) { fail("nonce mismatch") }
// 防篡改:结果必须与 user_data 绑定
if !bytes.Equal(doc.UserData, resp.Result.Digest()) { fail("result modified") }
4.5 跑起来
准备一台开启 enclave 的 EC2 实例:选择 m6i.xlarge 这类基于 Nitro 的机型,启动时带上 --enclave-options Enabled=true,安装 aws-nitro-enclaves-cli,并在 /etc/nitro_enclaves/allocator.yaml 中预留 2 个 vCPU 和 1024 MiB 内存。
# 构建镜像,得到 PCR0
docker build -t nitro-kms-demo .
nitro-cli build-enclave --docker-uri nitro-kms-demo:latest \
--output-file demo.eif | tee measurements.json
PCR0=$(jq -r .Measurements.PCR0 measurements.json)
# 用 PCR0 填写 Key Policy,然后加密一个随机密钥
aws kms encrypt --key-id alias/enclave-demo \
--plaintext fileb://<(head -c 32 /dev/urandom) \
--query CiphertextBlob --output text | base64 -d > secret.enc
# 父实例自己解不开
aws kms decrypt --ciphertext-blob fileb://secret.enc # AccessDeniedException
# 启动 vsock-proxy 和 enclave
vsock-proxy 8000 kms.us-east-1.amazonaws.com 443 &
nitro-cli run-enclave --eif-path demo.eif --cpu-count 2 --memory 1024
CID=$(nitro-cli describe-enclaves | jq -r '.[0].EnclaveCID')
# 验证者生成 nonce → 父实例转发 → 验证者校验
NONCE=$(verifier -new-nonce)
parent -cid "$CID" -ciphertext secret.enc -message "pay 42" -nonce "$NONCE"
verifier -in response.json -nonce "$NONCE" -pcr0 "$PCR0"
验证通过时的输出:
✔ attestation signed by AWS Nitro PKI
✔ PCR0 matches 9a1f...
✔ nonce matches, document is fresh
✔ result is bound to the attestation
5. 父实例能做什么、不能做什么
| 父实例的行为 | 结果 |
|---|---|
直接调用 kms:Decrypt |
被 Key Policy 拒绝 |
| 窃听 vsock 上的 KMS 流量 | 只能看到 TLS 密文 |
截获 CiphertextForRecipient |
需要 enclave 内存中的 RSA 私钥才能解开 |
| 替换 EIF 为恶意版本 | PCR0 改变,KMS 和验证者都会拒绝 |
| 以 debug 模式启动 | PCR 全为 0,同样被拒绝 |
| 篡改返回给验证者的结果 | user_data 对不上 |
| 重放旧的响应 | nonce 对不上 |
| 丢弃请求、拒绝服务 | 可以,隔离不能保证可用性 |
另外要注意,父实例能拿到 IAM 角色的临时凭证,所以它可以用这个身份调用其他 KMS 接口。Key Policy 需要按最小权限来写,必要时可以再加上 kms:RecipientAttestation:PCR3,把父实例的 IAM 角色也绑定进去。
6. 与其他 TEE 的对比
| 维度 | Nitro Enclaves | Intel SGX | AMD SEV-SNP / Intel TDX |
|---|---|---|---|
| 隔离粒度 | 独立 VM | 进程内的 enclave 区域 | 整个机密虚拟机 |
| 信任根 | AWS Nitro 系统 | CPU 厂商 | CPU 厂商 |
| 内存加密 | 依赖 Nitro 隔离 | 有 | 有 |
| 编程模型 | 普通 Linux 程序 | 需要用 SDK 拆分可信/不可信部分 | 普通 VM |
| 是否需要信任云厂商 | 需要 | 不需要 | 理论上不需要 |
Nitro Enclaves 最大的优点是简单:任何 Linux 程序打成 Docker 镜像就能运行,而且与 KMS 原生集成。代价是威胁模型中必须信任 AWS 本身。如果需要防范云厂商,应该考虑 SEV-SNP 或 TDX。
7. 踩坑提示
- PCR0 的可复现性:镜像中任何一个字节变化都会改变 PCR0。基础镜像要按 digest 固定,Go 构建要加上
-trimpath -buildid=。否则审计方无法从源码重新计算出同一个 PCR0。 - 时间:TLS 证书校验和 SigV4 签名都依赖 enclave 的时钟。它跟随宿主机的 kvm-clock,一般没有问题,但时钟漂移出现时这里会先报错。
- 证书有效期:attestation 的叶子证书有效期只有几个小时,验证方应该当场验证,而不是先存档、过后再验。
- vsock-proxy 白名单:默认只允许
/etc/nitro_enclaves/vsock-proxy.yaml中列出的地址,访问其他服务需要自行添加。 - 资源:enclave 的 CPU 和内存从父实例中扣除,并且不支持 GPU。