引言本用户手册介绍了如何开始使用X-CUBE-SBSFU STM32Cube扩展包。
, e8 K* H5 B3 |2 A2 O6 iX-CUBE-SBSFU安全启动和安全固件更新解决方案使STM32微控制器内部固件可升级到新版本，添加新功能，和纠正潜在问题。升级过程是以安全的方式进行，以防未经授权的更新，并阻止访问设备上的机密数据。
安全启动（可信根服务）是一种不可变代码，总是在系统复位后执行，它检查STM32静态保护、激活STM32运行时保护、然后在每次执行前验证应用程序代码的真实性和完整性，以确保无效或恶意代码无法运行。
安全固件更新应用通过使用Ymodem协议的UART接口接收固件映像，检查其真实性，并在安装代码之前检查其完整性。固件更新可更新整个固件镜像，或者部分镜像。单槽示例适用于固件映像最小化的情况，而双槽示例则适用于确保映像安全安装的情况，且也适用于IoT设备中常用的无线固件更新功能。对于复杂系统，固件映像配置可扩展至最多三个映像。示例代码可灵活配置，可配置使用对你或非对称加密方案，采用明文或密文方案。
安全密钥管理服务（KMS）通过PKCS #11 API（基于KEY ID的API）向用户应用程序提供加密服务，这些API在受保护和隔离的环境中执行。用户应用程序密钥存储在受保护和隔离的环境中，以便进行安全更新：真实性检查、数据解密和数据完整性检查。
STSAFE-A110是一种防篡改安全元件（通过硬件通用标准EAL5+认证），用于托管X509证书和密钥，并在安全启动和安全固件更新过程中执行用于固件镜像身份确认的验证。
X-CUBE-SBSFU基于STM32Cube软件技术，易于在不同STM32微控制器之间移植。它以参考代码的形式提供，演示了STM32安全保护措施的最佳使用方式。
/ F  ~7 g- F' Z/ K; aX-CUBE-SBSFU归类为ECCN 5D002。
0 ]. I6 g: z$ c6 J/ V9 n
1 概述
X-CUBE-SBSFU扩展包附带在STM32F4系列、STM32F7系列、STM32G0系列、STM32G4系列、STM32H7系列、STM32L0系列、STM32L1系列、STM32L4系列、STM32L4+系列和STM32WB系列产品上运行的示例。此外，还为STM32L4+系列提供了一个结合了STM32微控制器和STSAFE-A110的示例。
. D  ~' F+ w* M+ r4 |3 b4 i$ t5 vX-CUBE-SBSFU以独立STM32系统解决方案示例的参考代码的形式提供，这些示例演示了用来保护资产免遭未授权外部和内部访问的STM32保护措施的最佳使用方式。X-CUBESBSFU还提供了一个结合了STM32和STSAFE-A110的系统解决方案示例，演示了面向安全身份验证服务和安全数据存储的硬件安全元件保护。
X-CUBE-SBSFU是OEM根据其产品的安全要求级别开发安全启动和安全固件更新的起点。
4 Q  G, Q/ z1 P5 o  U1 TX-CUBE-SBSFU安全启动和安全固件更新扩展包可在基于Arm®(a) Cortex®-M处理器的STM3232位微控制器上运行。

) ^; _) v/ \+ J
/ f* W! Q8 G- K  @8 y2.术语和定义
+ V% I" C6 S7 f( a
, n* O2 K6 V& m, U1 f9 d



9 f1 I5 t( {) M* G2 STM32Cube 概述
STM32Cube是什么？
STM32Cube源自意法半导体，旨在通过减少开发工作量、时间和成本，明显提高设计人员的生产率。STM32Cube涵盖整个STM32产品系列。
STM32Cube 包括：
- A0 m( G. B" O8 y! ^• 一套用户友好的软件开发工具，覆盖从概念到实现的整个项目开发过程，其中包括：
8 D- P6 |6 Y# h4 f0 j4 E  S– 图形软件配置工具STM32CubeMX，可通过图形向导自动生成初始化C代码
% N: U! ^4 W# p; X( S$ j& k" C& D– STM32CubeIDE，一种集外设配置、代码生成、代码编译和调试功能于一体的开发工具
– STM32CubeProgrammer（STM32CubeProg），图形版本和命令行版本中可用的编程工具
6 `# F) R3 y2 {% W– STM32CubeMonitor（STM32CubeMonitor、STM32CubeMonPwr、STM32CubeMonRF和STM32CubeMonUCPD）是功能强大的监控工具，用于实时微调STM32应用的行为和性能
/ j, Q, h; d( x  I5 p" U4 A• STM32Cube MCU和MPU包，特定于每个微控制器和微处理器系列的综合嵌入式软件平台（如用于STM32L4系列和STM32L4+系列的STM32CubeL4），其中包含：
– STM32Cube硬件抽象层（HAL），确保在STM32各个产品之间实现最大限度的可移植性
– STM32Cube底层API，通过硬件提供高度用户控制，确保最佳性能和内存开销
– 一组一致的中间件组件，如FAT文件系统、RTOS、OpenBootloader、USB主机、USB设备、TCP/IP、触摸感应库，以及图形库
/ m6 e- f. C, C& C2 H. V: [( ^1 r– 包含的软件覆盖了全套外设以及对应可用的示例
2 l# e% l' C4 r0 G• STM32Cube扩展包，包含的软件组件是STM32Cube MCU和MPU包的功能补充：
! L9 W* g1 D0 Q- F/ H: r) e0 s– 中间件扩展和应用层
– 在特定的意法半导体开发板上运行的实现案例
. r0 x3 d( a3 p7 w. ~9 ^

此软件如何补充STM32Cube？
# d6 I% b  E1 Y0 P该软件基于STM32CubeHAL，即STM32微控制器的硬件抽象层。此软件包通过提供以下中间件组件扩展STM32Cube：
• 用于管理所有关键数据和操作（如访问固件加密密钥的加密操作等）的安全引擎
• 通过PKCS #11 API提供密码服务的密钥管理服务
• 用于管理硬件安全元件特性的STSAFE-A
该软件包包含有不同的示例应用程序，可提供完整的SBSFU解决方案：
• SE_CoreBin应用程序：提供包含所有“可信”代码的二进制文件。
$ R: ^6 H6 V, G1 h0 M( c• 安全启动和安全固件升级（SBSFU）应用程序：– 安全启动（可信根）
/ n* M! x$ C# ^* d+ y– 本地下载通过串口
– 固件安装管理
, h/ b7 v/ x7 M% G. M1 p• 用户应用程序：
& S7 ]+ I8 D) f, \– 在双插槽操作模式下下载新固件
– 提供了测试保护机制的示例
– 提供了使用KMS API的示例
! C' k; m/ c$ p, h示例应用提供了双插槽和单插槽操作模式，并且可以配置为不同加密方案。
: F( i3 }3 O5 l注： 在名称为1_Image 的示例中对单插槽配置进行了演示。
        在名为2_Images 的示例中对双插槽配置进行了演示。
本用户手册介绍了软件包的典型用法：
• 基于NUCLEO-L476RG板
• 示例应用在双插槽模式下运行，并配置了非对称身份验证和对称固件加密
) z( y8 r: A: U- A有关配置选项和单槽操作模式的更多信息，请参阅本文档的附录。
2 s; n8 h7 o5 P! S# Q! M8 v$ y0 m注： STM32L4系列和STM32L4+系列提供KMS功能，所提供示例基于B-L475E-IOT01A和B-L4S5IIOT01A板。
注： STM32L4+系列提供STSAFE-A110功能，所提供示例基于B-L4S5I-IOT01A板。

- O& K/ A5 R2 Q9 Q
  b& r3 S- P* A& {& q9 m. B3.安全启动和安全固件升级（SBSFU
3 j- D4 g2 r8 d/ r7 k3 U0 Y5 V" n3.1 产品安全介绍
现场部署的设备在不受信任的环境中运行，因此会受到威胁和攻击。为了减轻受攻击风险，我们的目标是只在设备上运行可靠的固件。已连接的设备时常需要更新固件映像以修复错误，或引入新功能或对策，否则极易遭受攻击。
其后果可能是破坏性的，如固件克隆、恶意软件下载或设备损坏。因此必须设计出一套安全的解决方案来保护敏感数据（甚至可能是固件本身）和关键操作。
; `! _# h3 I& r  N# S5 Z! X典型的对策基于加密技术（带有相关密钥）和内存保护：
• 密码可确保固件传输期间的完整性（确保数据未被破坏）、身份验证（确保某个实体确实符合其声明）以及机密性（确保只有经过授权的用户才能读取敏感数据）。
• 内存保护机制可以防止外部攻击（例如，通过JTAG物理访问设备）以及来自内部其它进程的攻击。
+ M" k, y2 e& a' S& o* h; v1 a+ @' \以下章节介绍实现机密性、完整性和身份验证服务的解决方案，以解决IoT终端节点设备最常见的威胁。
1 \9 G1 }' m" @
- u" N2 e. Y( h/ |' ~3 E/ f
3.2 安全启动
. E' o- D) P& Y& T) i; ^& `安全启动（SB）确保所执行的用户应用程序映像的完整性和真实性：使用密码检查，防止运行未经授权或恶意修改的软件。安全启动过程实现可信根（参见图 1）：从该可信组件（1）开始，其他每个组件在其执行之前（3）都要经过认证（2）。
6 u( p2 d8 y& p0 G对完整性进行验证，以确保即将执行的映像未被破坏或恶意修改。
1 Q1 S5 j# Q$ B0 O+ z- [可靠性检查旨在验证固件映像是来自可信且已知的源，以防止未经授权的实体安装及执行代码。
  l6 v7 i& ]! _- |/ v

) M* p3 `& U8 m1 \4 G
8 @! D5 l9 F; Q  W9 ^

3.3 安全固件更新
安全固件更新（SFU）实现了安全的现场固件更新，可以安全地将新固件映像下载到设备。如图 2中所示，通常有两个实体参与固件更新过程：
4 ]) A0 @( r/ Y• 服务器
4 b1 N5 Q4 J) _+ T( l8 w8 ?– OEM制造商服务器/Web服务
5 S' |) O, L: p4 ~& y3 W/ J1 I$ ?( J– 存储设备固件的新版本
7 w! |% j( h# B' H– 与设备通信，如果可用，则以加密形式发送该新映像版本
! H( s& M: P5 p• 设备
– 现场部署
– 内置了执行固件更新过程的代码。
  S' b$ E: ^* Q& s8 }( e# @– 与服务器通信并接收新的固件映像。
– 验证、解密并安装新固件映像，然后执行它。
( g$ `9 J3 C0 H) F9 K
- J/ X' y) X9 l8 D
; C  l% D, q& C" e
6 z$ e6 K8 O& T9 B
2 m% g- I- u: y8 C( q
" z% m) M6 r" C. L固件更新通过以下步骤进行：
! S- K' v- j8 n1. 如果需要更新固件，则创建一个新的加密固件映像并将其存储在服务器中。
2. 新的加密固件映像通过不受信任的通道发送到现场部署的设备。
3. 下载、检查并安装新映像。
可对整个固件映像或仅固件映像的一部分（仅适用于双插槽配置）执行固件更新。
固件更新容易受到第 3.1节：产品安全介绍中所示风险的影响：密码学技术用来确保机密性、完整性和身份验证。
机密性：用以保护固件映象，此固件映像可能是制造商的关键资产。它以加密的方式通过不可信通道发送，因此只有具备加密密钥访问权的设备才能解密固件包。
! P  s( l' w* [6 O1 d* u完整性：用来验证接收到的映象无任务损坏。
可靠性：检查旨在验证固件映像是来自可信且已知的源，以防止未经授权的实体安装及执行代码。

$ B3 }4 @/ Y  Z+ b: S8 \) f( S3.4 密码操作
X-CUBE-SBSFU STM32Cube扩展包提供了同时使用非对称和对称加密的四种加密方案。
默认的加密方案演示了用于固件验证的ECDSA非对称加密和用于固件解密的AES-CBC对称加密。利用非对称加密技术，固件验证可以通过公钥操作执行，因此设备中不需要任何保密信息。
X-CUBE-SBSFU扩展包中提供的其他加密方案是：
• 用于固件验证的ECDSA非对称加密技术，用AES-CBC或AES-CTR对称加密技术进行固件加密
• 用于明文固件验证的ECDSA非对称加密技术
• 用于明文固件验证的基于X509证书的ECDSA非对称加密技术
• 用于固件验证和加密的AES-GCM对称加密技术。
1 o0 o+ w1 v, A表 3介绍了每种密码方案相关的各种安全特性。

# L% R; O% f+ Z6 x
; w( A* S9 l: n. l, y

6 t0 u, {( u: G% w. R, K4 {0 a4 密钥管理服务(KMS)
9 h1 r- Y1 H4 z. Z- o密钥管理服务中间件通过标准PKCS #11 API（由OASIS指定）提供密码服务，这些API能够将密钥值提取给调用方（使用对象ID而非直接使用密钥值）。KMS运行在一个受保护/隔离的环境之内，主要是为了确保密钥值本身不能被未授权的外部代码访问。
' c  g4 ^6 @$ S7 G1 c8 KKMS也可以提供一些密码学服务，且由STM32微控制器以外的元件来安全管理，比如STSAFE-A110（基于令牌ID）。
KMS只支持PKCS #11 API的子集：
; X0 D8 h" J$ F, H' N• 对象管理功能：创建/更新/删除
7 {; D: ]' [1 f, w3 Y0 t• AES加密功能
• AES解密功能
• 摘要功能
) p- k7 L) V+ w% K; g/ x• RSA和ECDSA签名/验证功能
: l$ w6 A' @) \. J1 i• 密钥管理功能：密钥生成/派生KMS管理三类密钥：
" @% e: }8 m" s& o. @+ e, }• 静态嵌入式密钥：
– 在代码中嵌入预定义密钥。此类密钥不能修改。
% t6 d5 B0 J! w  n( }• 具有静态ID的可更新密钥：
– 在系统中预定义密钥ID
% W7 M3 |, R5 f" m– 可通过使用静态嵌入式根密钥的安全流程更新NVM存储器中的密钥值（真实性检查、数据完整性检查和数据解密）
5 ?& a' H5 [/ d3 J* }: K. S– 密钥无法删除
& {  c# k8 |  N+ U$ S1 P) I• 具有动态ID的可更新密钥：
  ^) g; w& V& @/ `, e! U: u– 密钥ID在创建密钥时定义
– 密钥值由使用内部函数来创建， 如DeriveKey()函数，可创建动态对象。
( U) v; {, ~+ N6 w9 t4 o% d– 密钥可以删除
9 M& f6 q9 z; b+ {
) f! Z! n, L1 I' B8 [/ i# Y, a6 Q, ]7 B
; C8 r- @" \7 W
0 h8 G! U) {: s. Y. O完整版请查看：附件
: y) d. h' `( r5 H* @

1 ]6 P! t! r' v6 L