Files
ssw 60b6fa6f7b vault: 设备绑定密钥 + 密封存储(宿主 16 用例 / QEMU VAULT_ALL_OK / 签名验收通过)
- src/vault-core: no_std 密码学核心(HKDF 派生、AES-256-GCM、两条水位线防回滚)
- src/ta-vault / src/ca-vault: TA 薄壳与 selftest 客户端
- build/p1_vault_qemu.sh: QEMU 全链,判据 VAULT_ALL_OK
- build/p2_ta_keys_qemu.sh: TA 公钥编进 tee.bin,默认密钥签的被拒
- build/gen_ta_keys.sh: 自建签名密钥
- docs/07-VAULT-TA.md: 设计 + 已验证/未验证清单
- CLAUDE.md 雷区 11-16:user_ta_header、嵌套 workspace、ARCH=arm、SIGPIPE、TA_PUBLIC_KEY、heredoc 变量
2026-10-28 14:37:04 +08:00

12 KiB
Raw Permalink Blame History

07 · Vault TA:把密钥关进安全世界

目标:把 docs/03-TRUST-CHAIN.md 里的 B1 + B2(每机唯一根、密钥进安全世界) 做成能跑的东西,而不是设计文档。

与 docs/05 的 P5 是同一件事,区别是:这一层不依赖板子。密码学与状态机 在宿主上就能验证,TA 只是薄壳。


0. 状态

项 状态 证据
syvault-core(派生/密封/防回滚/设备绑定) ✅ 宿主已验证 bash build/vault_selftest_host.sh → 16 个单测 + HOST_DEMO_OK
两台设备互相解不开 ✅ 宿主已验证 examples/two_devices.rs 输出 DeviceMismatch
TA + CA 编译(armv7 / 真 SDK) ✅ 已验证 ELF32 ARM,TA 195 KB、CA 335 KB;sign_encrypt.py verify 通过
TA 在 QEMU 跑通 VAULT_ALL_OK ✅ 已验证 bash build/p1_vault_qemu.sh → logs/vault-nw.log
board feature 读真实 DNA ❌ 未上板 地址待用 devmem 核对,见 §6
自建签名密钥端到端(公钥进 tee.bin 后拒绝默认密钥签的 TA) ✅ 已验证 bash build/p2_ta_keys_qemu.sh → logs/ta-keys-nw.log

QEMU 实测输出(logs/vault-nw.log,OP-TEE 4.11.0 / armv7):

info: ver=1.0 flags=0x0000 dev_tag=c44b97fa8cc37da0 seal_floor=0 accepted=0 provisioned=false
  seal: 43 B 明文 -> 95 B blob, counter=1
  unseal: 43 B,内容一致(密钥只可能来自 secure storage)
  tamper: 已被拒绝(A security fault was detected. (error code 0xffff000f, origin 0x4))
  bitmap = 0b11111  [seal=1 unseal=1 match=1 tamper_rej=1 rollback_rej=1]
VAULT_ALL_OK
VAULT_RC=0

注意第 3 行:unseal 发生在关掉 session 再重开之后——TA 实例已销毁,密钥只可能来自 secure storage。这是"密钥真的不在普通世界"最直接的证据。


1. 能解什么、不能解什么

结论
✅ 能解 密钥明文常驻 DDR(L6):K_device/DEK 只在 TA 内存里出现,普通世界 root 用 devmem 读不到
✅ 能解 每机唯一根:同一份 BOOT.bin 刷到不同芯片,派生出的密钥不同(DNA 进 KDF)
✅ 能解 防回滚:旧 blob 被拒
❌ 不能解 内核被替换(L3)。换掉 zImage 的攻击者仍能调用本 TA 的合法接口。要真正收口,必须先做 docs/03 阶段 A(FIT 验签)+ TA 侧调用方认证
⚠️ 半解 TA 被替换。默认 default_ta.pem 是公开开发密钥 → 必须换成自己的并把公钥编进 tee.bin(§7)

顺序不要反:先 A(启动链),再 B2(vault)。现在做的是 B2,它能让"密钥泄露" 降级成"密钥可用但不可见";"可用"这件事本身还得靠 A 去限。


2. 三层结构

src/vault-core/     no_std,零 TEE 依赖 —— 密码学 + 状态机 + blob 编解码
      ↑ 宿主 cargo test(16 用例)
src/ta-vault/       TA 薄壳 —— 参数搬运 / Random / secure storage / 设备 DNA
      ↑ armv7 + OP-TEE
src/ca-vault/       CA —— info / provision / seal / unseal / rotate / zeroize / selftest

为什么这么切:TA 里的代码只能上板或 QEMU 才能测,一次迭代十几分钟;而真正会写错 的是密钥派生、AAD 覆盖范围、水位线语义这些逻辑。把它们放进普通 crate,cargo test 两秒出结果。TA 里只剩「取参数、调 Random、读写对象」这种一眼能看出对错的代码。


3. 密钥层次与 blob 格式

K_root  = 32B,首次 provision 时由 TA 用 TEE 随机数生成 → secure storage → 永不导出
dev_tag = SHA256("syvault/dev/v1" ‖ DeviceDNA(57bit) ‖ USER eFuse)[0..8]
K_enc   = HKDF-SHA256(salt = dev_tag, ikm = K_root, info = "syvault/v1/enc") → 32B

dev_tag 放进 HKDF 的 salt 而不是 info,是这条链的关键:同一份 K_root 落到 不同芯片上必然派生出不同的 K_enc。这就是 docs/03 里 B1 想要的"每机唯一根", 而且不需要多烧一位 eFuse。

blob(v1,固定 52B 开销):

off size 字段
0 4 magic SYVL
4 1 version = 1
5 1 alg = 1 (AES-256-GCM)
6 2 flags,必须 0(未知位直接拒)
8 8 dev_tag
16 8 counter (u64 BE)
24 12 nonce(TEE 随机数)
36 n 密文
36+n 16 GCM tag

AAD = 前 36 字节。所以改 magic / dev_tag / counter / nonce 任何一个字节,解密都会 失败 —— 而不是"接受一个被改过的头,然后按错误的版本号记账"。


4. 命令集

码 命令 参数 说明
0x00 GET_INFO out: 32B 版本 / flags / dev_tag / 两条水位线
0x01 PROVISION — 生成 K_root。幂等:已存在就 no-op,绝不覆盖
0x10 SEAL in 明文, out blob nonce 由 TA 取随机
0x11 UNSEAL in blob, out 明文 校验设备 + 版本 + GCM
0x20 ROTATE — 换 K_root,旧 blob 全废(这是特性)
0x30 ZEROIZE — 删 K_root 与水位线
0xF0 SELFTEST out: 8B 位图 TA 内部跑 seal/unseal/篡改/回滚

命令字只有一份定义(syvault_core::proto),TA 与 CA 共用,避免"两边写岔了,运行时才发现"。


5. 两条水位线(一个真实踩到的设计错误)

第一版只维护一条 floor:seal 时 floor = counter,unseal 时要求 counter > floor。 单测立刻炸了 —— 而炸的方式很有价值:

seal 之后立刻 unseal 会被自己挡住。 而这正是设备上最正常的顺序:seal → 落盘 → 重启 → unseal。

修法是拆成两条:

  • seal_floor:已 seal 的最高版本,保证新 blob 版本号严格递增;
  • accepted:已解封接受的最高版本,只用来拒绝比它更旧的 blob。

于是语义变成「防回滚」而不是「一次性令牌」:同一版本可以重复读(重启后再读一次 是正常需求),旧版本被拒。要一次性语义,就每次重新 seal 一个新版本。

两条都由 TA 写进 secure storage,普通世界既读不到也改不了 —— 改水位线就等于开回滚门。


6. 设备身份:两种模式

模式 触发 设备身份来源 用途
模拟 默认 编译期 VAULT_SIM_DEV → HKDF 展开 40B QEMU / 宿主做"两台设备"实验
板上 --features board SLCR:0xF8000534(DNA[31:0])、0xF8000538(DNA[56:32],低 25 bit) 真机

模拟模式只在编译期有一个注入点,板上不存在任何运行时输入 —— 否则等于给 CA 一个 "我是别的设备"的后门。

上板前必须做的一件事

busybox devmem 0xF8000534     # DNA 低位
busybox devmem 0xF8000538     # DNA 高位(低 25 bit 有效)

读错地址的后果不是报错,而是每次启动派生出不同的 K_device,表现为"昨天加密的 数据今天解不开"。所以第一次上板时:读两次、中间断电一次,确认两次值相同。

USER eFuse 暂未纳入(user_fuse 填 0)。原因是 8 个 dword 的起始偏移在不同 Zynq-7000 文档/硅片版本上有出入,没核对过就用 = 引入不稳定的密钥输入。DNA 已足够 做到"每机唯一",等核对完再把值填进 device_identity() 即可,core 不用改。


7. 签名密钥(默认密钥等于没有)

default_ta.pem 是上游公开的开发密钥。用它签的 TA,任何人都能替换。

OP-TEE 4.11 的机制(mk/config.mk):

TA_SIGN_KEY   ?= keys/default_ta.pem    # 签 TA 的私钥
TA_PUBLIC_KEY ?= $(TA_SIGN_KEY)         # 编进 OP-TEE OS 的公钥

所以两步:

bash build/gen_ta_keys.sh                       # 生成 keys/ta_sign.pem + ta_pub.pem
make PLATFORM=zynq7k TA_PUBLIC_KEY=$PWD/keys/ta_pub.pem ...   # 公钥进 tee.bin
SIGN_KEY=$PWD/keys/ta_sign.pem bash build/build_vault.sh      # 用私钥签 TA

验收(必须做,否则换密钥只是心理安慰):

  1. 自己私钥签的 TA → 加载成功;
  2. default_ta.pem 签的 TA → 加载失败。

已实测通过(logs/ta-keys-nw.log,core 内嵌 3072-bit 公钥):

--- A: 自己密钥签名 ---
info: ver=1.0 flags=0x0000 dev_tag=c44b97fa8cc37da0 seal_floor=0 accepted=0 provisioned=false
A_RC=0
--- B: 上游默认密钥签名 ---
ERROR: A security fault was detected. (error code 0xffff000f, origin 0x3)
B_RC=1

origin 0x3 = 错误来自 TEE 侧(core 验签失败),不是客户端。这就是「TA 换不了」的硬证据。

这条验收踩过的三个坑(都会把排查带偏)

现象 真因
ta_pub_key.c 里模数是 512 字节(默认 4096),不是我的 3072 TA_PUBLIC_KEY=... 写在 make 命令行会被 qemu.mk 吞掉,必须 export 成环境变量;且 out/arm 会缓存上一轮配置,要删
A、B 一律报 Input data was of invalid format (0xffff0005, origin 0x0),core 侧一条错误日志都没有 CA 的入参错了:init 里写了 SYVAULT_UUID=$VAULT_UUID,而该变量在 init(引号 heredoc)里不存在 → 空串 → Uuid::parse_str("")。这个错误码和"TA 格式坏"一模一样
以为是 dev kit 差异(out/arm vs out/zynq7k) 不是。两种 dev kit 编出来的 TA 都能加载,问题全在上面两条

所以脚本里加了两个自检:嵌入模数必须是 384 字节、init 里的 UUID 必须是字面量。没有自检的话,每一次失败都要重跑 20 分钟才能排除一个方向。


8. 怎么跑

宿主(现在就能跑,两秒)

bash build/vault_selftest_host.sh
# == 1/2 单元测试 == 16 passed
# == 2/2 两台设备的边界行为 ==
# [B] unseal A 的 blob -> DeviceMismatch ✓ 拒绝
# [A] 篡改 1 字节 -> AuthFailed ✓ 拒绝
# [A] 回滚到旧版本 -> 被拒 ✓
# HOST_DEMO_OK

编 TA + CA(Linux x86_64,需要 optee_os 的 export-ta_arm32)

export OPTEE_OS=~/optee_os
export SDK_DIR=~/teaclave-trustzone-sdk
export OPTEE_CLIENT_EXPORT=~/optee_client/out/export

VAULT_SIM_DEV=dev-A bash build/build_vault.sh     # 设备 A
VAULT_SIM_DEV=dev-B bash build/build_vault.sh     # 设备 B(拿 A 的 blob 去解应当失败)

QEMU 全链(一条命令,约 15 分钟,已验证)

# 在 Linux x86_64(16 核最佳)上,仓库源码放 /root/src 或显式指定
SRC=/root/src bash build/p1_vault_qemu.sh
# PASS 判据:正常世界串口出现 VAULT_ALL_OK

它与 p0_qemu_arm32.sh 共用同一套构建链(ATF / U-Boot / OP-TEE / 内核 / rootfs), 只把 hello TA/CA 换成 vault —— p0 是已验证基线,不要拿它改。

跑通后直接看两份串口日志:$W/run/nw.log(正常世界)、$W/run/sw.log(安全世界)。

目标机上

cp syvault.ta /lib/optee_armtz/3f7a1c92-5d84-4b6e-8f21-9c0d5e6b7a31.ta
tee-supplicant -d /dev/teepriv0 &
syvault selftest        # 期望最后一行 VAULT_ALL_OK
syvault seal  /etc/hostname && syvault unseal /etc/hostname.blob

selftest 的第 2 步是关掉 session 再重开——等价于 TA 重新加载。如果密钥真的只在 安全世界且持久化正确,这一步仍能解开;而 CA 从头到尾没见过任何密钥字节。


9. 与既有文档的对应

docs/03 里的项 本仓的实现
B0 快速缓解(短窗口、随机地址) 不适用:密钥已经不在 DDR,没有"窗口"了
B1 每机唯一根(HKDF + DNA) syvault_core::DeviceIdentity + Vault::new
B2 密钥进安全世界 K_root 存 secure storage,K_enc 只在 TA 内存
L3 启动链验签 不在本层。TA 管不了内核被换
L7 会话密钥 + 远程证明 未做。现在的形态是"宿主请求 TA 解密",还没有 DAK 签名与验签

下一步按价值排序:FIT 验签(A)> 调用方认证 > 远程证明(L7)> PL 安全岛。