【开箱即用】AES-CMAC C 语言实现:完整跑通 NIST 测试向量并集成的快速指南

原创2026-11-14 13:44:382,220 阅读

【开箱即用】AES-CMAC C 语言实现:完整跑通 NIST 测试向量并集成的快速指南

本仓库提供一套可直接编译运行的 AES-CMAC(基于 AES 的消息认证码)C 语言实现,内置 NIST 标准测试向量,一条命令即可自检。适合需要消息完整性校验、又想摸清算法细节的开发者。

AES-CMAC 解决什么问题

加密解决的是保密性,而消息认证码(MAC)解决的是另一件事:接收方能否确认消息确实来自持有同一密钥的发送方,且传输途中未被改动。AES-CMAC(RFC 4493)以 AES 分组密码为底层原语,为任意长度的消息生成固定 16 字节的认证标签,是网络协议和存储格式中常见的完整性校验手段。

这个仓库的定位是"可编译、可自检、可读"的 C 语言实现:AES 核心(支持 128/192/256 三种密钥长度)在 src/aes.c,CMAC 流程在 src/cmac.c,另附 ECB 模式封装、测试函数和命令行入口,全部由一个 Makefile 驱动,源码共五个文件,代码量很小,适合通读。

四步跑通:从 clone 到 NIST 测试向量自检

git clone https://gitcode.com/open-source-toolkit/b0eb4
cd b0eb4
unzip AES-CMAC-master.zip
cd AES-CMAC-master && make

编译完成后有两个用法:

  • 不带参数运行 ./aes-cmac.out:先执行 7 项内置测试(AES-128/192/256 的加密、解密各一组,外加 AES-CMAC 一组),再输出一条示例消息的 CMAC 标签;
  • 带两个参数运行 ./aes-cmac.out MESSAGE KEY:对你自己的消息和密钥计算 16 字节 CMAC 标签,并附带 ECB 加密/解密结果作对照。

集成到自己项目时,核心就是 src/cmac.c、src/aes.c 以及 include/ 下对应的头文件,拷贝后调用 aes_cmac() 即可。

内置测试向量,一条命令完成自检

src/utils.c 里的 test() 函数硬编码了 FIPS 197 的已知答案向量:密钥 0x000102…1f、明文 0x00112233…ff 及对应的标准密文。跑一次无参数命令,七项结果逐项打印 passed/failed。之后无论改动哪个模块,重跑这条命令就能确认没有回归,这是判断"实现是否正确"最直接的验证方式,比对着文档逐行核对省心得多。

RFC 4493 子密钥派生链路完整可读

src/cmac.c 中的 GenerateSubkey() 完整实现了 RFC 4493 的派生过程:先用密钥加密全零块得到 L,再做逐字节左移,溢出时与约减常数 Rb(0x87)异或,依次推出 K1、K2。消息处理同样按标准分支:末块不足 16 字节时补 0x80 再补零并异或 K2,长度恰为 16 的倍数时直接异或 K1。整个链路与规范逐条对应,读代码时可以随时对照 RFC 原文理解每一步的来由。

模块拆分清晰,ECB 封装可插拔

代码按 aes(核心加解密)、cmac(认证)、encrypt(ECB 模式)、utils(测试与打印)四层拆分,相互耦合很少。ecb_encrypt() / ecb_decrypt() 通过函数指针接收加密函数,aes_128_encrypt、aes_192_encrypt、aes_256_encrypt 都可以传入,结构上换成其他分组密码实现也不别扭,方便二次开发。

适用场景:哪些项目适合引入

  • 算法学习与教学:轮函数、密钥扩展、子密钥派生在源码里逐行可见,比读规范文档直观,适合做课程演示。
  • 原型与实验环境的完整性校验:教学设备、实验床或原型系统需要给消息附一个 16 字节标签时,这套代码集成成本很低(生产环境请先看下面的局限)。
  • 与其他库交叉核对:用同一密钥和消息,分别用本仓库和 OpenSSL 等成熟库计算标签,能快速发现自己集成时的参数是否传对。
  • 研究型项目:体量和结构都足够小,适合作为基线扩展到其他模式或做教学性改造。

上手成本与局限:集成前需要知道的边界

  • 集成成本低,但签名以头文件为准:五个源文件共几百行,拷贝即可用;不过根目录 README 中 aes_cmac() 的示例签名与实际源码参数顺序不一致,集成时请以 include/cmac.h 为准,另外命令行示例把消息末尾的空字符也算进了长度(strlen + 1),自己调用时注意传参。
  • 作者明确定位为教科书式实现:源码说明其不针对性能和安全性做优化——没有恒时比较,也没有侧信道防护。处理敏感数据的场景仍应选用 OpenSSL、mbedTLS 等成熟库。
  • verify_mac() 的返回值判断写反了:两个 MAC 完全相同时会返回 false。若需要 MAC 校验,请自行实现比较逻辑或修正该函数。
  • 能力边界:AES-CMAC 标签固定 16 字节,且本仓库的 CMAC 只走 AES-128 路径(密钥为 16 字节),AES-192/256 目前只用于加解密演示。

小结

如果你的目标是读懂 AES-CMAC,或者快速拿到一份带 NIST 测试向量的 C 语言实现,这个仓库的起步成本很低:clone 下来 make 一次,先跑测试向量,再决定要不要集成。项目源码通过上文 git clone https://gitcode.com/open-source-toolkit/b0eb4 获取,采用 MIT 许可证,详见 LICENSE。

登录后查看全文
AES-CMACC语言实现编程