• 正文
  • 相关推荐
申请入驻 产业图谱

SAM AV3 中的一种安全密钥管理机制‑OfflineChangeKey

27分钟前
83
加入交流群
扫码加入
获取工程师必备礼包
参与热点资讯讨论

OfflineChangeKey 是 MIFARE SAM AV3 安全模块内部的专用安全密钥更新机制。该机制最大安全特征:密钥条目更新过程中,明文新密钥不会暴露给主机 MCU,密钥全程保护在 SAM 安全硬件内部。适合设备预个性化、密钥轮换、现场远程密钥更新等高安全等级业务;仅支持 AES‑128、AES‑192、AES‑256 密钥类型。本文基于原厂文档完整解析机制原理、前置条件、预‑个性化配置流程、密码计算逻辑、RFIDDiscover 实操步骤、MCU 开发 API 参考。

资料获取:SAM AV3 中的一种安全密钥管理机制-OfflineChangeKey

1. OfflineChangeKey 机制概述与使用约束

参考图 1 AV3 KeyEntryManagement 配置界面‑注册 0x10 密钥条目 OfflineChangeKey 用于SAM_ChangeKeyEntry、SAM_ChangeKUCEntry两条指令,实现两类离线安全操作:

  1. 离线更新密钥条目 KeyEntry:前提条件,待更新密钥条目的 KeyNoCEK 必须指向一条 OfflineChangeKey 类型密钥;
  2. 离线更新密钥使用计数器 KUC:前提条件,对应 RefNoKUC 的 KeyNoCKUC 必须指向 OfflineChangeKey 密钥。

核心安全优势:主机不会获取新密钥明文。传统 ChangeKeyEntry 指令主机需要传入密钥明文,存在主机侧密钥泄露风险;OfflineChangeKey 把全部密钥运算封闭在 SAM 硬件内部,主机只传递加密报文与校验码。

硬性格式约束:OfflineChangeKey 仅支持 AES‑128、AES‑192、AES‑256,DES/TDES 密钥不能使用该机制。

业务适用场景:

  • SAM 模块出厂后设备现场预个性化;
  • 已部署终端密钥轮换更新;
  • 远程现场密钥升级,高安全防密钥泄露系统。

2. SAM AV3 预个性化与个性化概念区分

原厂文档明确两个配置阶段,实际项目中 SAM AV3 出厂内置默认密钥,需要两步完成客户私有化改造:

  1. 预个性化 Pre‑personalization:替换 SAM 出厂预置默认密钥,写入客户自有根密钥,建立客户独立安全体系。
  2. 个性化 Personalization:在客户根密钥基础之上,进一步配置业务 KeyEntry、访问权限、业务参数,适配具体业务场景。

文档备注:AN12693《MIFARE SAM AV3 – Key Management and Personalization》对该机制描述比较抽象,缺少计算与实操步骤,本文档作为补充实操说明。

3. 预个性化阶段:注册两套 KeyEntry 密钥条目

参考图 2 AV3 KeyEntryManagement 配置界面‑注册 0x11 密钥条目 要启用 OfflineChangeKey,预个性化阶段必须注册两组密钥条目:

  1. KeyEntry 0x10:OfflineChangeKey 类型密钥,作为 CEK(Change Entry Key),用于离线更新其他密钥;
  2. KeyEntry 0x11:业务 PICC 密钥条目,该条目的KeyNoCEK/KeyVerCEK指向 0x10,代表该条目允许由 0x10 离线密钥来做安全更新。

3.1 KeyEntry 0x10 OfflineChangeKey 密钥配置

字段 数据 说明
KeyA 16 字节全 0 AES 密钥
KeyB 16 字节全 0
KeyC 16 字节全 0
DF_AID 0000 2 字节
DF_KeyNo 00 1 字节
KeyNoCEK/KeyVerCEK 0000 2 字节
REFNoKUC FF 1 字节
SET 2000 2 字节
Va/Vb/Vc 000000 3 字节
ExtSET 0200 2 字节
KeyNoAEK/KeyVerAEK 0000 2 字节
KeyClass OfflineChange 密钥类别必须选 OfflineChange

通过 RFIDDiscover 工具AV3 KeyEntryManagement页面填入参数,点击ChangeKeyEntry写入 SAM。

3.2 KeyEntry 0x11 PICC 业务密钥条目配置

该业务密钥的KeyNoCEK/KeyVerCEK = 1000,即指向 KeyNo=0x10 的 OfflineChangeKey。

字段 数据 说明
KeyA 16 字节全 0 业务密钥
KeyB 16 字节全 0
KeyC 16 字节全 0
DF_AID 0000 2 字节
DF_KeyNo 00 1 字节
KeyNoCEK/KeyVerCEK 1000 2 字节 指向 0x10
REFNoKUC FF 1 字节
SET 2002 2 字节
Va/Vb/Vc 000000 3 字节
ExtSET 0100 2 字节
KeyNoAEK/KeyVerAEK FFFF 2 字节
KeyClass PICC 业务密钥类别

预个性化完成之后:KeyEntry0x11 不允许普通明文方式修改,只能由 0x10 OfflineChangeKey 做离线加密更新。

4. OfflineChangeKey 密钥更新完整业务流程

参考图 3 AV3 DataProcessing 界面 Kce 密钥加密;图 4 AV3 DataProcessing 界面 Kcm 密钥加密;图 5 AV3 OfflineChangeDisableKey 下发离线报文界面。

示例目标:把 KeyEntry0x11 更新为新业务密钥,全部明文构造、派生运算在主机侧执行,新密钥明文不会下发给 SAM,下发的是加密报文 + 截断 CMAC 校验码。

4.1 构造 PlainKeyEntry 明文密钥数据包 PlainKeyEntry [80]

把 KeyEntry0x11 全部需要更新字段拼接,末尾填充 16 字节 padding,组成 80 字节 PlainKeyEntry 明文块。示例新配置:

  • KeyA=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
  • KeyB=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
  • KeyC=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
  • DF_AID=0000,DF_KeyNo=00
  • KeyNoCEK/KeyVerCEK=0000
  • REFNoKUC=FF,SET=2000,Va/Vb/Vc=000000
  • ExtSET=0100,KeyNoAEK/KeyVerAEK=FEFE

拼接完成 PlainKeyEntry [80]。

4.2 派生 Kce 加密密钥、Kcm CMAC 校验密钥

以 SAM 内部 0x10 存储的 Ks(OfflineChangeKey)为根密钥,构造两个 SV 向量,AES‑CBC 加密得到 Kce、Kcm:

  1. ChangeCtr(变更计数器,示例 = 0x0001)
  2. SV1 = ChangeCtr || 14 字节 0x71 → 00017171717171717171717171717171
  3. SV2 = ChangeCtr || 14 字节 0x72 → 00017272727272727272727272727272
  • \(Kce = E_{Ks}(SV1)\):用于加密 PlainKeyEntry 数据包
  • \(Kcm = E_{Ks}(SV2)\):用于生成 CMAC 完整性校验码

注:ChangeCtr 为变更计数器,每次离线密钥更新操作计数器必须递增,用于防重放攻击。

4.3 明文数据包加密得到 EncKeyEntry

使用 Kce,AES‑CBC 模式加密 80 字节 PlainKeyEntry,输出 EncKeyEntry [80] 加密密钥条目数据包。

4.4 计算 CMAC 校验值并做 MFP 截断

拼接 APDU 指令头 + EncKeyEntry 全部数据,使用 Kcm 计算完整 CMAC;执行 MFP Truncate 截断,取前 8 字节得到CMAC_Truc[8]。

主机最终发给 SAM 的离线报文 = EncKeyEntry [80] + CMAC_Truc [8]。

4.5 激活 OfflineChangeKey 会话

调用SAM_ActivateOfflineKey指令,指定对应的 OfflineChangeKey(KeyNo=0x10),使能 SAM 内部离线密钥更新机制。

API 原型:phStatus_t phhalHw_SamAV3_Cnd_SAM_ActivateOfflineKey(...)。 RFIDDiscover 对应操作页面:AV3 ActivateOfflineKey选项卡。

4.6 下发离线密码报文完成密钥条目更新

把EncKeyEntry + CMAC_Truc组合报文传入SAM_ChangeKeyEntry离线模式;SAM AV3 内部使用本机存储 Ks 解密、校验 CMAC。

  1. CMAC 校验通过 → 在 SAM 安全存储内部更新目标 KeyEntry(示例 0x11);
  2. CMAC 校验失败 → 拒绝更新,返回错误状态码。

关键点:整个交互流程,SAM 外部主机始终不会传输新密钥明文。

5. 开发调试工具与 API 参考

  1. MCU 程序开发环境
    • 软件参考工程:NfcrdlibEx7_MIFAREPlus and SAM AV3 X‑mode Project
    • NFC 阅读器 IC:RC663 / PN7642
    • 库版本:NxpNfcRdLib_v7.16、NxpRdLib_v17.1.0.2535
    • 核心 API:
      • phhalHw_SamAV3_Cnd_SAM_ActivateOfflineKey:激活 OfflineChangeKey 会话
      • phhalHw_SamAV3_Cnd_SAM_ChangeKeyEntry:支持离线模式更新密钥条目
  2. 无代码验证调试环境
    • Pegoda3 读写器 + RFIDDiscover 上位工具,可完成预个性化、密钥注册、加密计算、离线密钥更新全流程验证,适合前期方案验证。

6. 工程实操 FAQ

Q1:OfflineChangeKey 和普通 ChangeKeyEntry 最核心安全差异是什么?

A:普通 ChangeKeyEntry 主机下发密钥明文,主机侧存在密钥泄露风险。OfflineChangeKey 主机下发加密数据包 + CMAC 校验,新密钥明文全程不出 SAM 安全硬件,主机永远拿不到明文密钥,适合高安全、远程密钥轮换场景。

Q2:什么样的密钥条目允许使用 OfflineChangeKey 做离线更新?

A:目标密钥条目的KeyNoCEK必须配置为 OfflineChangeKey 类型密钥;不满足该条件,SAM 拒绝离线更新。

Q3:ChangeCtr 变更计数器有什么作用?可以固定不变吗?

A:用于防重放攻击,每一次离线密钥更新操作必须递增;如果重复使用相同 ChangeCtr,旧的离线报文可以被重放复现密钥更新,带来安全风险。

Q4:OfflineChangeKey 支持 DES/3DES 密钥吗?

A:不支持,仅支持 AES‑128、AES‑192、AES‑256。

Q5:预个性化、个性化两个阶段区别是什么?

A:预个性化:替换 SAM 出厂默认密钥,建立客户根安全体系;个性化:在客户根密钥基础上配置业务密钥、权限参数,适配业务场景。

Q6:CMAC 校验失败,SAM 会执行什么动作?

A:直接拒绝本次密钥更新,目标 KeyEntry 保持原有密钥,返回错误状态码,不会写入半完成数据。

重要声明:本文全部技术内容引自 NXP 文档《Update KeyEntry using OfflineChangeKey》,配置参数、字段定义、密码运算流程、API、约束条件完整还原原文,没有新增文档之外观点。NXP 保留修改芯片规格、应用文档权利;本文仅供开发实操参考,不构成商业承诺,文档不授予任何知识产权许可。

相关推荐