【独家整理】给 C 项目接入 AES-CMAC 认证码:三步跑通,标准测试向量自检
【独家整理】给 C 项目接入 AES-CMAC 认证码:三步跑通,标准测试向量自检
本项目用纯 C 实现了 AES-CMAC(基于 AES 的消息认证码)与完整 AES-128/192/256 加解密,附带 Makefile 和 FIPS 197、RFC 4493 标准测试向量,clone 后执行 make 即可编译运行。
为什么需要它
很多场景里,光加密还不够——接收方还得确认两件事:数据中途没被改动,且发送方确实握着同一把密钥。对称消息认证码(MAC)就是干这个的,而 AES-CMAC(RFC 4493) 因为能直接复用现成的 AES 运算、不引入额外硬件或查找表,成了很常用的一个选择。
但现实里常常卡在这两点:一是为了算一个 MAC 就拖进一大套通用加密库,觉得偏重;二是想弄明白 CMAC 内部到底怎么分块、怎么生成子密钥,却没有一个能逐行读的实现。这套源码正好补这个缺口——它自称是"教科书式实现",每一步都摊开写,既当工具用,也能当学习材料。
快速上手:3 步从 clone 到跑通测试
仓库克隆下来,根目录里是源码压缩包 AES-CMAC-master.zip,解压后进入 AES-CMAC-master/ 目录:
git clone https://gitcode.com/open-source-toolkit/b0eb4
# 解压 AES-CMAC-master.zip,进入 AES-CMAC-master/
make
make 会在 build/bin/aes-cmac.out 生成可执行文件,并在当前目录建一个同名软链。跑起来有两种方式:
./aes-cmac.out # 不带参数:自动执行标准测试向量
./aes-cmac.out "hello world" "0123456789abcdef" # 自定义消息 + 16 字节密钥
不带参数运行会依次打印 AES-128/192/256 的加解密结果和 AES-CMAC 结果,每一项后面跟着 passed / failed,全绿即说明实现和官方向量逐字节对上了。
集成到自己工程里:把 include/ 下的 cmac.h、aes.h、common.h、utils.h 与 src/ 下的 cmac.c、aes.c、utils.c 拷进项目,调用核心函数即可:
#include "cmac.h"
unsigned char key[16] = {0}; // 16 字节密钥
unsigned char msg[] = "hello, aes-cmac";
unsigned char mac[16];
aes_cmac(msg, sizeof(msg) - 1, mac, key); // 产出 16 字节 MAC
真实签名是 aes_cmac(in, length, out, key),注意参数顺序是"数据在前、密钥在后";返回值为 out 本身。
核心能力
零第三方依赖,好移植
整套只用到 C 标准库(stdlib、string、stdio),不依赖 OpenSSL、没有汇编,make 用系统自带的 gcc 就能过。想交叉编译到资源紧张的嵌入式目标上,也基本不用额外找依赖。
一个函数算出 16 字节 MAC
对外入口很薄:aes_cmac() 一条语句得到 MAC;配套的 verify_mac() 直接返回 bool,把"重算一遍并逐字节比对"封装好了,验证真伪不用再手写循环。
结果可自检:逐字节对照标准向量
test() 里内置了 FIPS 197 与 RFC 4493 的官方测试向量,对 AES-128/192/256 加解密和 AES-CMAC 逐项校验。你改完代码、或想确认某个改动没算错,跑一次就知道,不用自己另找参照。
附带完整 AES 加解密与 ECB
aes.h 里还有 aes_128/192/256_encrypt、decrypt 以及 ECB 模式的 ecb_encrypt / ecb_decrypt,需要单块加解密或看分组模式行为时也能直接取用。
它是如何工作的
CMAC 的计算分三步。先用全零块做 AES-128 加密得到 L,左移一位得到子密钥 K1(若 L 最高位为 1,则再异或常量 Rb=0x87);K1 左移一位同理得到 K2,GenerateSubkey() 负责这两步。
接着把消息按 16 字节分块:末块不满 16 字节时,补 0x80 再补零,然后与 K2 异或;若消息正好是整块,则末块与 K1 异或。随后做 CBC 链——从 X=0 起,逐块算 Y = M[i] ⊕ X 再做 AES-128 加密,最终输出即 MAC。verify_mac() 把同样的流程再算一遍,与传入的 MAC 逐字节比较。需要说明的是,这是教学取向的实现,未做常量时间、防侧信道等加固,生产环境建议优先选用经过安全审计的库。
适合谁用,典型场景有哪些
- 学习密码学 / 准备面试:想逐行看懂 CMAC 子密钥生成与填充逻辑,配合标准向量边读边验。
- 嵌入式与资源受限设备:需要一个轻量、无依赖的 MAC,且能塞进现有 C 工程。
- 应用层报文认证:物联网设备间通信、API 报文、存储完整性校验,给数据加一道"是否被篡改"的校验。
- 想验证自研实现:把这里的标准测试向量当参照,比对自家 AES / CMAC 的输出是否一致。
完整源码即上文 clone 的仓库,根目录 LICENSE 采用 MIT 许可证,可自由使用与修改;更多说明见 README.md。