【独家整理】给 C 项目接入 AES-CMAC 认证码:三步跑通,标准测试向量自检

原创2026-11-14 23:25:531,726 阅读

【独家整理】给 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。

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