- 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 变量
185 lines
8.9 KiB
Markdown
185 lines
8.9 KiB
Markdown
# 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 拖累)
|
||
|
||
```bash
|
||
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
|
||
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:密钥托管,不用等板子
|
||
|
||
```sh
|
||
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 永久改不了。
|