- 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 变量
12 KiB
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
验收(必须做,否则换密钥只是心理安慰):
- 自己私钥签的 TA → 加载成功;
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 安全岛。