AWS Nitro Enclaves 与 KMS 远程证明实战

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 字节

验证方拿到这份文档后,可以确认三件事:

  1. 签名链有效,说明这确实是 Nitro 硬件生成的文档
  2. PCR0 与自己预期的镜像哈希一致,说明 enclave 里跑的是我认可的那份代码
  3. 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 收到请求后会做三件事:

  1. 验证 attestation 文档的签名
  2. 用文档中的 PCR 值去匹配 Key Policy 里的 kms:RecipientAttestation:PCR0、kms:RecipientAttestation:ImageSha384 等条件
  3. 不返回 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。
回到顶部 ↑/dev/oops