1. 课程导入
在物联网、工业控制、车联网与边缘计算设备大规模铺开的今天，密码能力已经不再是“可选项”，而是设备可信身份、数据机密性与固件完整性的底座。PSA Crypto（Platform Security Architecture Cryptography API）由 Arm 主导制定，目标是为资源受限设备提供一套统一、可移植、可认证的密码服务接口。本课程围绕“如何把 PSA Crypto 真正集成进一个嵌入式工程”展开，而不是停留在 API 手册的逐条讲解。
一、学习目标：从会调用到能交付
很多工程师第一次接触 PSA Crypto 时，会把它理解为“另一套 AES/SHA 函数库”。这种理解会导致集成阶段频繁踩坑：密钥散落在业务代码里、错误码被忽略、随机数源不合规、不同芯片平台移植时接口语义不一致。本课程设定四个递进目标：
- 接口层：掌握 PSA Crypto 的核心对象模型——密钥标识（psa_key_id_t）、密钥属性（psa_key_attributes_t）、操作句柄（psa_operation_t）与策略（usage/algorithm/type）之间的关系。
- 实现层：理解 PSA Certified 的信任模型，能区分 API 层、驱动层、硬件安全模块（SE/TPM/TrustZone）之间的职责边界。
- 工程层：能够完成密钥生命周期管理、错误码处理、构建配置裁剪与多平台适配。
- 验证层：能设计并执行符合 PSA Crypto API 测试规范的验证用例，输出可复现的集成报告。
二、核心价值：为什么是 PSA Crypto
PSA Crypto 的价值不在“算法更多”，而在“契约稳定”。它把密码实现抽象为可替换后端：同一份业务代码，可以在软件实现、硬件加速器、安全元件之间切换，而无需改动上层逻辑。这对量产设备尤为关键——芯片选型变更、成本优化、合规升级都不应引发业务代码重写。
| 维度 | 传统裸调密码库 | PSA Crypto 集成方式 |
|---|---|---|
| 接口一致性 | 各厂商 API 不同，移植需改代码 | 统一 API，后端可替换 |
| 密钥管理 | 密钥常以明文数组出现在业务层 | 密钥由实现托管，业务只持 ID |
| 权限控制 | 无策略，任意代码可调用 | 密钥属性约束用途与算法 |
| 合规证据 | 需自行举证 | 可对接 PSA Certified 认证体系 |
| 错误处理 | 返回值语义不统一 | 标准化 psa_status_t 错误码 |
三、整体知识框架
本课程的知识结构可以概括为“一条主线、三层结构、五个能力域”。主线是密钥的生命周期：生成/导入 → 存储 → 使用 → 更新 → 销毁。三层结构是 API 层、适配层、硬件信任根。五个能力域包括：密钥管理、对称密码、非对称密码、哈希与 MAC、随机数与熵源。
四、实战路线图：从环境到量产
课程按“可运行—可替换—可验证—可量产”四阶段推进。每个阶段都有明确交付物，避免学完仍无法落地。
- 阶段一：环境与最小闭环。搭建构建系统，完成 psa_crypto_init() 初始化，跑通一次 AES-GCM 加解密与 SHA-256 摘要，确认错误码处理路径。
- 阶段二：密钥与策略。用 psa_key_attributes_t 定义密钥类型、算法、用途与生命周期，实现密钥导入、持久化与销毁，杜绝明文密钥散落。
- 阶段三：后端替换与移植。将软件后端切换为硬件加速或安全元件后端，验证接口语义不变、性能与安全边界符合预期。
- 阶段四：验证与量产。执行 PSA Crypto API 测试套件，输出集成报告，固化构建配置与版本基线。
/* 最小闭环示例：初始化 + 摘要 */
psa_status_t st = psa_crypto_init();
if (st != PSA_SUCCESS) {
return st; /* 必须处理，不可忽略 */
}
uint8_t digest[32];
size_t digest_len = 0;
st = psa_hash_compute(PSA_ALG_SHA_256,
data, data_len,
digest, sizeof(digest), &digest_len);
if (st != PSA_SUCCESS) {
return st;
}五、典型场景与常见误区
以智能门锁为例：设备需与云端双向认证，本地需保护开锁凭证。集成 PSA Crypto 后，设备私钥在安全元件内生成且不可导出，业务层只持有密钥 ID；云端下发数据用 AES-GCM 解密，固件升级用 ECDSA 验签。整条链路中，业务代码不接触任何明文密钥。
常见误区二：忽略 psa_status_t 返回值，密钥生成失败后继续使用无效 ID。
常见误区三：在业务层硬编码密钥字节数组，绕过密钥属性与策略约束。
常见误区四：认为“用了 PSA API 就等于安全”，忽视熵源质量与后端实现强度。
接下来，课程将沿着这条路线图逐层展开：先建立接口与对象模型，再深入密钥管理与算法调用，随后进入后端适配与移植，最后完成验证与量产准备。掌握这套方法，你就能把 PSA Crypto 从“文档里的 API”变成“产品里的可信能力”。