HMAC 组件概述

📖 简介

cCryptoHMAC 是基于 Windows CryptoAPI 的 HMAC（Hash-based Message Authentication Code）实现，支持 HMAC-SHA1 和 HMAC-SHA256 算法。

✨ 主要特性

特性	说明
标准 HMAC	遵循 RFC 2104 标准实现
双算法支持	HMAC-SHA1、HMAC-SHA256
密钥灵活	支持字符串、字节数组、Hex、Base64 格式的密钥
链式调用	流畅的 API 设计，支持方法链式调用
多种输出	支持 Hex、Base64、字节数组输出
自动密钥处理	密钥长度自动处理（超过块大小自动哈希）

🚀 快速开始

创建实例

Dim Hmac As New cCryptoHMAC

简单计算

' 计算 HMAC（默认 SHA256）
Dim result As String
result = Hmac.Compute("data to sign", "secret-key")
Debug.Print result

链式调用

' 使用链式调用
Dim result As String
result = Hmac.Mode(HMAC_ALG_SHA256) _
            .Secret("secret-key") _
            .DataString("data to sign") _
            .ReturnHex()

📋 支持的算法

算法	枚举值	块大小	说明
HMAC-SHA1	HMAC_ALG_SHA1	64 bytes	兼容性好
HMAC-SHA256	HMAC_ALG_SHA256	64 bytes	安全性高（推荐）

🔐 HMAC 用途

HMAC 主要用于：

1. API 请求签名 - 验证请求完整性和身份
2. 消息认证 - 确保消息未被篡改
3. 数据完整性校验 - 配合密钥的完整性验证
4. JWT 签名 - JSON Web Token 的签名部分

🔗 相关文档

• methods.md - 方法详细参考

---

最后更新: 2026-05-17