- 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 变量
op-tee-test
Zynq-7015(ACZ7015,双核 Cortex-A9 / armv7)上跑 OP-TEE 4.11 + Rust 写的 TA 的完整工作集: 构建脚本、沙箱编排、实测日志、预编译产物,以及板子上的后续动作清单。
打包时间:2026-10-28 · 来源工程:~/WorkBuddy/2026-10-26-13-43-18
一句话现状
| 状态 | |
|---|---|
| QEMU(arm32)全链 | ✅ 已跑通。Rust CA → /dev/tee0 → SMC → OP-TEE 4.11 → Rust TA 执行并返回 |
| 真板(Zynq-7015) | ❌ 未开始。tee.bin 已编出,剩下是 FSBL/内存/内核/DT 的板级活 |
| vault(设备绑定密钥 + 密封存储) | ✅ 宿主 16 用例 + QEMU VAULT_ALL_OK + 签名验收(默认密钥签的 TA 被拒),见 docs/07 |
QEMU 上的成功证据(logs/p0-nw.log):
optee: revision 4.11 (f54190f2)
optee: initialized driver
crw------- 1 0 0 250, 0 /dev/tee0
crw------- 1 0 0 250, 16 /dev/teepriv0
--- run CA ---
INC_VALUE: 41 -> 42
ALL OK
CA_RC=0
安全世界侧(logs/p0-sw.log):
I/TC: OP-TEE version: 4.11.0 (gcc 12.2.0) #1 ... arm
I/TC: Primary CPU switching to normal world boot
验证用的是 armv7,和目标板同架构 —— 不是拿 aarch64 糊过去的。
目录
op-tee-test/
├── README.md ← 本文件
├── CLAUDE.md ← 给 AI 编码助手的项目约定(怎么改、别踩什么)
├── docs/
│ ├── 01-HANDOFF.md 交接文档:目标/前置/阶段划分/Rust 侧要点
│ ├── 02-P0-RESULTS.md ★ QEMU 实测全过程,含两个「根因级」坑与纠正
│ ├── 03-TRUST-CHAIN.md Zynq 八层启动信任链 + eFuse 位定义 + 优化排序
│ ├── 04-PL-ENCLAVE.md PL 安全岛设计(PS 不可见内存 / AXI-NS 校验 / 寄存器映射)
│ ├── 05-BOARD-ACTIONS.md ★★ 上板动作清单(P1→P5、验收、回滚)
│ ├── 06-QSPI-UPDATE-LOOP.md QSPI 安全更新闭环 + eFuse 烧写 Runbook
│ └── 07-VAULT-TA.md ★ 设备绑定密钥 + 密封存储(core/TA/CA 三层,QEMU 已验证)
├── build/
│ ├── p0_qemu_arm32.sh ★ 一键:空容器 → 看到 INC_VALUE(203 行,已验证)
│ ├── p1_vault_qemu.sh ★ 一键:vault TA 全链 → VAULT_ALL_OK(已验证)
│ ├── p2_ta_keys_qemu.sh ★ 一键:TA 签名公钥进 tee.bin → 默认密钥签的被拒
│ ├── build_ta_ca.sh TA+CA 单独编译签名(本地容器版,参数化)
│ ├── build_vault.sh 编 vault TA/CA,支持 board / VAULT_SIM_DEV
│ ├── gen_ta_keys.sh 生成自己的 TA 签名密钥(公钥编进 tee.bin)
│ ├── vault_selftest_host.sh 宿主验证:纯 Rust,两秒,不需要板子/QEMU
│ ├── steps/s1..s5 分步脚本,就是本次实际执行顺序(排错用这个)
│ └── sandbox/csbx.py CubeSandbox 托管(创建/复用/后台跑/收发文件)
├── src/
│ ├── ta/ Rust TA(no_std,CMD_INC_VALUE / CMD_ECHO)— P0 基线
│ ├── ca/ Rust CA(libteec)— P0 基线
│ ├── vault-core/ ★ no_std 密码学核心:HKDF 派生 / AES-GCM 密封 / 防回滚
│ ├── ta-vault/ ★ vault TA(薄壳:参数/随机数/secure storage/DNA)
│ ├── ca-vault/ ★ vault CA(provision/seal/unseal/rotate/selftest)
│ ├── c-skeleton/ C 版 TA/CA 对照骨架(想用 C 写就从这开始)
│ └── pl_enclave_regs.h PL 安全岛寄存器/命令字定义(RTL 与驱动共用)
├── logs/
│ ├── p0-nw.log 正常世界串口(成功)
│ ├── p0-sw.log 安全世界串口(成功)
│ ├── vault-nw.log ★ vault 全链:VAULT_ALL_OK
│ ├── vault-sw.log ★ 同上,安全世界侧
│ └── fail-bl32-silent.log 修复前:「BL32 后静默」的真实现象,留作对照
└── artifacts/
├── tee-zynq7k.bin OP-TEE OS,PLATFORM=zynq7k(391 KB)
├── hello_rust.ta Rust TA,已 RSA-PSS-SHA256 签名 + verify 通过
├── hello_ca Rust CA(ELF32 ARM)
├── libteec.so.2.0.0 armhf
├── tee-supplicant armhf
├── SHA256SUMS 上面几个产物的校验和
└── vault/
├── syvault.ta ★ vault TA(armv7,开发密钥签名)
├── syvault_ca ★ vault CA(armhf)
└── SHA256SUMS
全部都是 ELF32 / ARM(hello_rust.ta 是被签名的容器,file 显示 data 属正常)。
怎么跑(QEMU,约 15 分钟)
路线 A:沙箱(推荐,16 核 / 16G,不受本机 I/O 拖累)
cd build/sandbox
PY=/path/to/python3 # 需要 pip install cubesandbox
$PY csbx.py up # 创建(token 会落到 /tmp/cube_sbx.json)
$PY csbx.py put ../p0_qemu_arm32.sh /root/p0.sh
$PY csbx.py bg p0 'bash /root/p0.sh' 1800
$PY csbx.py log p0 80
$PY csbx.py down # 用完销毁
服务端地址与默认模板写在 csbx.py 顶部(CUBE_API_URL 等),按环境改。
路线 B:任意 Linux x86_64(含 WSL / 云主机)
bash build/p0_qemu_arm32.sh 2>&1 | tee build.log
# 判据:最后打印 PASS: Rust TA 在安全世界被调用并返回
脚本自带:装依赖 → 拉 6 个源码 → 编 optee_os/u-boot/ATF → 编内核(开 OPTEE)→ 编 Rust TA/CA 并签名 → 拼 armhf rootfs → 生成带 optee 节点的 DTB → 跑 QEMU → 判 PASS。
本机(2015 i5 / 4 核 / 2.5G 容器)跑不动:光解压内核就要 25 分钟。 别在这类机器上死磕,换台像样的。
五条「不改就会再踩」的硬约束
-
OP-TEE 的 console 走 secure UART = 第二个
-serial官方qemu.mk一直是-serial tcp:NW -serial tcp:SW两条。只用-nographic(只接 serial0) 会看到BL1: Booting BL32之后永久静默,让人误判「BL32 挂了 / 上游已 bit-rot」。 → 正确做法:-serial file:nw.log -serial file:sw.log分开落盘。 -
DT 的 optee 节点必须带
interruptsOP-TEE 4.x 默认开 async notif,Linux 驱动因此强制要求中断。缺了就是optee: error -ENXIO: IRQ index 0 not found,/dev/tee0不出现。板子上同理。 -
平台名是
PLATFORM=zynq7k,不是zynq(后者报plat-zynq/sub.mk: No such file)。 -
Rust 工具链版本以 SDK 的
rust-toolchain.toml为准(当前nightly-2026-08-05)。 网上文档写的 2024-05 已过时,会报feature edition2024 is required。 另外 SDK 自带的cargo-optee工具本身编不过,直接用cargo build,然后手工补dyn_list。 -
构建机上的
python3必须是系统 python3(带cryptography/pyelftools)。 很多镜像/usr/local/bin/python3是另一个,会报ModuleNotFoundError: cryptography。 →PYTHON3=/usr/bin/python3。
vault:密钥托管,不用等板子
bash build/vault_selftest_host.sh # 2 秒:16 个用例 + 「两台设备互相解不开」
SRC=/root/src bash build/p1_vault_qemu.sh # 15 分钟:QEMU 全链 → VAULT_ALL_OK
做的事:K_device = HKDF(K_root, Device DNA ‖ USER eFuse),AES-256-GCM 密封,
K_root 只在 TA 内存与 secure storage 里出现;普通世界拿到的只有 blob,且旧 blob 会被判回滚。
它不解决内核被替换(L3)—— 换掉 zImage 的攻击者仍能调用 TA 的合法接口。
详见 docs/07-VAULT-TA.md(含"已验证 / 未验证"清单)。
从哪开始做板子
先读 docs/05-BOARD-ACTIONS.md,按 §0 把六个先决条件过一遍。最关键的两条:
- 内核源码 + DTS 拿不拿得到? 拿不到就做不了(开 OP-TEE 必须重编内核)。
- 用哪块板?
.233是生产网关(别碰),.234的 SD 卡已坏(先换卡)。
然后按 P1(OP-TEE 起来)→ P2(内存划分)→ P3(内核+用户态)→ P4(Rust TA)→ P5(DEK 下沉)推进。
Zynq 上没有 ATF:A9 无虚拟化扩展,OP-TEE 自己就是 secure monitor,跑 Monitor 模式。 QEMU 那套 ATF(BL1/BL2/BL31) + BL32 的启动链不能照搬。
注意
artifacts/里的 TA/CA 是 armv7 + 开发签名,只能用于验证;量产换自己的密钥, 且要把 TA 签名公钥编进tee.bin,否则攻击者可以换 TA。- 令牌/凭据不落盘:
csbx.py把 sandbox token 写到/tmp/cube_sbx.json,用完down即删。 - 三个 eFuse 位(
AES_ONLYbit8 /BBRAM_KEY_DISABLEbit10 /JTAG_DISbit9)不可逆, 顺序在docs/06里;JTAG_DIS必须最后烧,否则 PL eFuse 永久改不了。