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

8.9 KiB
Raw Permalink Blame History

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 分钟。 别在这类机器上死磕,换台像样的。


五条「不改就会再踩」的硬约束

  1. 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 分开落盘。

  2. DT 的 optee 节点必须带 interrupts OP-TEE 4.x 默认开 async notif,Linux 驱动因此强制要求中断。缺了就是 optee: error -ENXIO: IRQ index 0 not found,/dev/tee0 不出现。板子上同理。

  3. 平台名是 PLATFORM=zynq7k,不是 zynq(后者报 plat-zynq/sub.mk: No such file)。

  4. Rust 工具链版本以 SDK 的 rust-toolchain.toml 为准(当前 nightly-2026-08-05)。 网上文档写的 2024-05 已过时,会报 feature edition2024 is required。 另外 SDK 自带的 cargo-optee 工具本身编不过,直接用 cargo build,然后手工补 dyn_list。

  5. 构建机上的 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_ONLY bit8 / BBRAM_KEY_DISABLE bit10 / JTAG_DIS bit9)不可逆, 顺序在 docs/06 里;JTAG_DIS 必须最后烧,否则 PL eFuse 永久改不了。