STM32 MCU内建多种安全功能，为设备信息安全打造坚固的平台，在这个平台的基础上进而可以运行可信的进程以及密码学操作。STM32 MCU底层硬件具备的安全能力能够覆盖存储访问保护、代码/系统隔离、启动入口限定、防篡改检测、密码学算法加速等多方面的安全需求，例如：


身份识别：UID, OTP


存储访问保护/软件IP保护：RDP（读保护），WRP（写保护），PCROP（专有代码保护），OTFDEC（On-The-Fly Decryption实时解密模块）

3 S2 V9 e' V, t1 `8 ~. r; _
: }8 D- a! {' X代码/系统隔离：MPU，Firewall（防火墙），TrustZone，Secure User Memory（安全用户存储区）
# f( `- c- r, H: }& x' b5 n, B3 g

+ g( N8 y6 ~# i, ]启动入口限定：RDP2，BOOTLOCK（启动锁定）


3 D8 z$ F5 j5 r% @$ y# |: k) U防篡改检测：Anti-Tamper
, ^2 l3 m, R. }. ?' d, W

- g% A( e# `1 w0 o- U% r  V密码学算法硬件：AES，HASH，PKA，TRNG

芯片硬件安全功能结合软件能够实现更多应用层的安全功能，例如安全启动，安全更新，安全存储，安全通信，可信执行环境等等。
/ E" J  C/ ?6 H5 a' e
9 [2 m: t2 `8 G0 j: O% D这次我们将手把手教你如何基于防火墙和PCROP在STM32L0上实现关键数据和代码保护。
- ]* M4 {3 x& E9 X' j
STM32L现有5大子系列，STM32L0、STM32L1、STM32L4/STM32L4+和刚刚宣布量产的STM32L5，为低功耗应用提供了完整的解决方案。

STM32L0系列是意法半导体的入门级32位超低功耗MCU产品组合，旨在实现卓越的低功耗水平。由此产生了真正的超低功耗MCU，125℃时的功耗为世界最低。ARM® Cortex®-M0+内核与STM32超低功耗特性的独有结合，使STM32L0非常适合电池供电或供电来自能量收集的应用。
# Z) O/ T) n; d$ S1 t2 G# W- q! Y! _

STM32L0和STM32L4系列的硬件除了通常的RDP、WRP，还带有Firewall和PCROP硬件安全特性。使用STM32的security硬件模块(Firewall和PCROP)实现对关键数据(密钥)的保护:应用代码可以使用加解密功能，但是无法拿到密钥。本方案提供了在STM32L073（STM32L073-Nucleo）上的参考实现，以及相应测试代码。

+ r: G1 f  P0 f7 ~方案包的内容包括：

" F1 s* F, m- s7 i
三个IDE下的示例工程：IAR，MDK，STM32CubeIDE
8 W4 `4 q& W, m$ E9 U; m' Z2 r
5 N5 M/ {/ M( J: g$ r1 A- ~/ o) s
" R# C, b6 Q# y; g6 r/ ~' a8 D9 @方案介绍文档
9 M& m# R7 S! D2 r9 L  C
4 z/ z# |- T6 G
8 E7 P- Z1 w# j, L6 L$ L7 B脚本工具(生成秘钥相关文件)

PCROP私有代码保护

# |. a$ e3 M5 z! _2 ^

PCROP提供了一个额外层次的代码保护，PCROP可以设置内部Flash的指定区域成为只能执行的代码区域，该区域无法被读取（作为数据），修改或擦除，也就是说无论是通过调试器还是芯片运行的代码（包括运行在PCROP区域内部的代码本身）都无法读取PCROP保护区域的指令，而且，即使在RDP0的状态下，PCROP所保护的区域也无法通过调试器进行数据读取。
' c; o+ c: }; ?* Y7 B! C- j) r2 h
+ v+ D: ~. r5 D5 ~5 Z6 EPCROP的常见用途是联合开发，对部分软件IP进行保护，受保护部分的代码不能被二次开发用户读出或修改，但是其中的函数API可以被调用。PCROP同时也可以成为对数据进行某种程度保护的手段，这时候，需要将被保护的数据转换成一段指令，只有执行该段指令之后，数据才会被恢复到寄存器或者RAM当中。
6 o8 T% b# \. C5 I8 r' V9 ^% }
( c$ R/ h- X9 |$ S" _9 g1 KPCROP主要防止来自CPU、DMA以及通过调试端口的数据访问；PCROP主要保护用户片上Flash的一段区域(由选项字节设置区域范围，保护上电即生效)。其保护机制是PCROP区域仅能被指令访问，不允许数据访问(包括DMA 、调试访问) 。

5 c" R6 p) Y9 S1 R. m' I主要用途包括：


常用于保护关键代码，只可被执行，不能被读出(dump)
! M1 x  I2 f0 Q. k  N防止内部攻击:注入恶意程序读取关键代码
4 e. e0 s( D- F! d3 I) E防止外部攻击:来自调试端口的读取
也可用于保护“代码化的” 关键常数数据
* o' i' X) ]7 A需要先将关键常数转换成代码
CPU执行这段代码，会把关键数据恢复到SRAM或者寄存器中，这段SRAM再 使用STM32的其他存储和执行保护模块，比如Firewall保护，防止恢复出来的 关键数据被用户代码直接读取;或者寄存器本身是WO属性
+ g4 k6 `# r6 X; H, |9 P

Firewall防火墙

3 T  V" [. Y4 r使用Firewall防火墙硬件IP，可以在片上Flash和RAM中隔离出一块隔离区，该隔离区具有唯一的入口，只有从该入口进入后防火墙隔离区域内的代码和数据才能够被执行和访问，从防火墙保护区域跳转出去之前也必须进行关闭操作才能够允许跳转，也就是说函数只能从设计允许的出口退出，除此之外的任意的调用、访问和跳转都会引发系统复位。
. \8 Z: x2 D& v
6 K5 p% P. n  x& v: k3 a4 `通过防火墙提供的隔离功能，部分关键的软件功能和数据可以放置于防火墙隔离区内，防火墙外的应用程序只能够通过防火墙提供的唯一入口函数调用防火墙内部的功能，而无法直接看到其中的代码或者数据，起到将关键操作与系统其它部分的软件隔离开的作用。

防火墙的功能是系统运行后动态开启的，而不是来自OptionByte的静态设置，但是防火墙一旦使能，则在当前的Power Cycle始终有效，且不能被禁止，直到下一次复位。

具有防火墙功能的STM32系列包括STM32L0和STM32L4。
5 x3 E9 b0 f+ ~: V. T1 C2 B" o
) F' f: J; _+ ]8 `% `" V防火墙主要用于防护CPU，DMA，保护用户片上Flash、片上EEPROM 和 片上SRAM上的指定区域(防火墙里的区域)。


保护机制：

% k* {- \) |# S# Z
防火墙里的代码、数据不能被墙外的代码直接访问


2 O4 v5 v% i2 E9 k; U' d2 F必须走固定入口(Call Gate)进入墙里再访问


出去(跳转到防火墙以外的代码)之前必须置位寄存器


否则产生系统复位


7 |# W& ^( P, e/ H6 b' f5 d. T（对中断的影响: 进墙之前，应用需要关中断；出墙之后，应用需要开中断）

! g2 u5 W/ D- J4 m. H- s
由寄存器设置范围并使能，即上电缺省没有保护
1 w. `8 n; U- o% `( a8 }

一旦防火墙使能，保护生效直到下一次系统复位

使用PCROP和防火墙保护关键数据和操作: 密钥及使用密钥的加解密操作

: {5 |) m- g! Y, A* _: O
加解密函数放在防火墙(Firewall)的Code segment
/ ]" {" E, O1 I8 ?' E

终端客户的密钥代码化后，放在PCROP区域里，该区域也是防火墙的一部分；执行密钥代码把密钥数据恢复到也由防火墙保护的SRAM中
6 W3 O0 e8 L, O$ ]

- }0 O( Y9 J+ E* c: V墙外的用户代码要调用加解密函数，必须走固定的地址进入(防火墙Call Gate)，并以参数的形式指定调用具体的加解密函数
6 Q7 p4 }/ H1 y  N* Q" J

! X4 K" t# j; h5 H" {6 }/ W* ~0 [墙内的加解密函数调用同在墙内的密钥代码，从而把密钥数据恢复到SRAM中，供加解密函数使用
. ^5 H; n9 f1 F3 {$ E- L
) e; A. y$ u$ F2 I
墙外的代码不能直接调用墙内的加解密函数，也不能直接读写墙内的数据，否则系统复位
7 {' u) x  x+ G/ N( v0 c* n
保护方案图解

2 X5 ?. f- M* M; ~" c
允许的访问:
. W  }1 f$ O; v$ d( s

. E$ B  a% o) U9 R8 l墙外代码通过callgate进入墙内，调用墙内代码


3 D0 a' M" s8 j4 j墙内代码执行也在墙内的PCROP区域
. u  g/ _5 _9 Z

, p  K+ g% i" o# j; v5 u墙内代码读写墙内的数据
3 v1 B/ \: w4 [" I% @5 O
+ y  ]( \& s5 p; L7 s& E非法的访问:

0 ?$ |+ V4 _# y( x" V
墙外代码企图直接调用墙内代码
4 S2 A7 x' q* p* a& M
# V) Q6 t  q0 u3 G5 @, w
墙内代码读写墙的PCROP区域
8 e" h" h; D! }6 D4 D
6 K9 V8 B! x8 a# U+ d
4 ?* q9 }5 l2 P7 G  }1 L墙外代码企图直接读写墙内数据
' Q% p% G3 k4 ^

% N9 t# T( t" i- R5 O8 c- D和不使用PCROP和防火墙的普通方案比较：
! O1 D" H8 V0 e2 L  @
$ y3 @8 `) w/ }$ _0 S  Q
未使用PCROP、FW功能的方案

* d5 E8 c, h* z) q+ m3 ^
, F/ ~9 a3 \2 A/ V3 j: J& p密钥数据未受保护
+ E6 J! R0 ~) s, b1 U- [$ K
/ l. _/ Q- k5 @. y: u  i
内部攻击，注入的恶意程序可以直接读取

8 B( G, [+ @( x$ W0 L$ }
& X9 Q1 b. u7 v* z* s外部攻击，通过调试probe可以读取(没有 RDP的情况下)
+ k6 m" j0 C% ~( X. V

0 N$ i% G# x( _4 j5 Z, I4 L
; j! X3 I: y( s& F1 E) v7 @6 O) T3 o- d
本方案


" q( t" }  p$ C6 z  C密钥数据被PCROP和Fire wall双重保护

0 V2 o+ y, V" }/ |3 e- }  _4 `! Q0 [- S
- T4 w# k1 b8 [7 B1 A/ Y4 D加解密功能被Fire wall保护
7 V+ C$ Z/ c7 P4 d  F
4 T5 O1 T( F' C! T1 y7 f! {
墙外代码可以使用加解密功能，但得不到密钥数据

0 z. p, G4 W+ s! R5 g3 v6 Q1 U

STM32L0上的密钥保护方案示例

STM32L0的PCROP

STM32L0的Firewall
2 ~! E3 P5 |/ @: T" W: h( f$ O

2 A+ d1 `; a3 t) j7 ]3 |/ gSTM32L0上的密钥保护Demo(1)
$ c/ ]; s  i) U  }) f: E

9 K% V3 s) \: M9 y- l  w2 R; x0 \
- Z. r) X" e3 RSTM32L0上的密钥保护Demo(2)

STM32L0上的密钥保护Demo(3)

墙外代码合法调用墙内代码:走Callgate进入


1 k) Z) K/ s+ J7 r% K外部代码访问墙里的代码，进入callgate之前需要关中断，退出后开中断
  B% M" O" v# `5 x" z; i
9 b5 ], R$ i* ]4 F7 v( l- o
8 N" E/ x8 k# D7 b" A" CSE_EnterSecureMode&SE_ExitSecureMode
$ k; B( o! B  w给函数指针赋值 fp=...CALL_GATE_FUNCTIOIN_ADDR +1 = 0x0800 0505


% u. L8 l+ {1 M! e( V& @. P该函数指针带两个参数，发起调用

: R" X! ?! A* i9 [
墙内代码可以随意调用墙内代码、数据
+ J* F( e( C: j2 h# ]0 p

7 [4 t( k5 w8 Q* r7 ?
STM32L0上的密钥保护Demo(4)

0 U& \% F5 C% F5 q1 L* q, a
墙外代码的非法访问，被识别和阻止

- p* }9 y& J0 _8 R% o应用key的生成和烧录
: w5 c/ _% g& a& `- E( q

& L  J% J% P% e% f: C

例程Setup

" r% d+ L3 o4 \

·解压缩例程包
5 F1 `- s7 N* a1 g& B  o3 P6 R( X·下载X-Cube-Cryptolib软件包(https://www.st.com/x-cube-cryptolib)，将软件包中FW库 L0对应目录下的Middlewares文件夹拷贝到例程包对应位置(参见下面左图)
·使用你熟悉的IDE，分别打开Boot和App两个工程，编译后分别下载
( `$ X: ~5 K; z/ d·使用STM32CubeProgrammer把例程包里的密钥文件烧写到0x08004000(参见下面右图)
·使用STM32CubeProgrammer设置0x08004000开始的4KB区域为PCROP保护
·STM32L0上，闪存扇区的“写保护”和“PCROP保护”都由WRPOT控制
·当WRPMOD=1，WRPOT=0，表示对应扇区被PCROP
·勾选WRPMOD;除了WRPOT4之外，其他WRPOTx都勾选上
·打开串口调试助手
  W6 n9 @, v0 D$ j9 ?1 P8 O$ r4 F2 x115200，8 bit数据位，1 bit停止位;无校验位，无流控
' Y+ P4 _- W: [6 n4 _" T8 u6 y·STM32L073-Nucleo板:按复位键，运行

测试案例(1)

' H# p* t4 g( k  {: U
/ y/ n: M  t( O" Q6 x6 l9 K2 a% p代码化KEY未烧录或已擦除：使用hardcode的缺省Key
& s" k) m+ G1 O- O: d' d

BL不会设置和使能防火墙
+ i1 h. Z2 m. R! n1 @9 ]

用户未使能PCROP

" C. U  `5 s; h/ N0 J% ~" P' B1 P
. K7 N1 a5 u* K7 kcase 2: 读取墙内数据 → OK
case 3: 写墙内数据 → OK
( a0 l# F! b0 Y: o: Q. {case 4:直接调用敏感代码 → 执行0指令码， hard fault
, u' p6 B5 k: T4 P; y& ucase 5:直接读取敏感数据 → OK
case 6:合法调用加密函数 → 加密失败
case 7:合法调用解密函数 → 解密失败

4 U: T" L7 l9 H9 ]
测试案例(2)

" p4 I( S3 t: p5 \! A

: G; y6 a+ X+ A& V" n' }) R

IDE相关的链接文件

存储区域分配及其Layout
+ ^' [; k. A3 f; q9 I

' ^+ `, ]5 H: D: L) x8 \. e% r把函数放到指定地址

( N3 @: d8 b& M
+ U/ B6 ~6 a( C* w& I4 Z通过链接文件实现期望的存储区分配- Boot工程，IAR环境下的 linker.icf 文件

+ h% l; [3 C1 b通过链接文件实现期望的存储区分配—— Boot工程，MDK环境下的 linker.sct 文件

1 R2 l; L, I! p: D7 @通过链接文件实现期望的存储区分配 ——Boot工程，STM32CubeIDE环境下的 linker.ld文件
$ j2 t8 n. p) d

, S% Z# U/ f  o8 s通过链接文件实现期望的存储区分配 Boot工程，STM32CubeIDE环境下的 linker.ld文件
: F6 a9 L# Y) O; l6 y

. x0 |  d, Y* W6 s6 u# c