使用说明与限制
计算接口签名的步骤
- 选择 HMAC-SHA256 或 HMAC-SHA512,按接口文档选择密钥编码:UTF-8 文本、Hex 字节或 Base64 字节。
- 填写密钥,在输入区粘贴待签名的原始消息。消息始终按 UTF-8 编码,不会自动整理 JSON、排序字段或删除换行。
- 点击“处理”,结果同时提供小写 Hex 与 Base64;对照接口要求取对应字段,而不是把整个结果 JSON 作为签名发送。
可对照的 HMAC-SHA256 示例
密钥编码选择 UTF-8,密钥为 key;消息为下面这一行,末尾不要额外换行:
The quick brown fox jumps over the lazy dog对应的 Hex 结果应为:
f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8密钥编码为什么会影响结果?
UTF-8 文本 ab、Hex 6162、Base64 YWI= 都表示同一组密钥字节;但 UTF-8 文本 6162 表示四个字符,是另一把密钥。Hex 需要完整的两位字节,例如 0A,不能输入单个 A;Base64 不要混用 Base64URL 的 -、_ 字符。
对接时签名不一致,按什么顺序排查?
- 核对算法、密钥内容与编码;不要把已经 Base64 编码的密钥又当作普通文本,除非接口明确这样要求。
- 核对原始消息的空格、字段顺序、换行以及结尾是否多了回车。语义相同的两份 JSON,字节内容也可能不同。
- 核对输出形式:Hex 大小写、Base64、前缀以及字段拼接规则都属于接口约定,本工具不会自动附加
sha256=等前缀。
HMAC 是消息认证码,不是可逆加密,也不是公钥数字签名。空密钥可用于算法测试,但不适合生产认证。请使用专门的测试密钥,生产密钥不要放入截图或公开分享的示例。
文本长度上限为 1,048,576 个 UTF-16 编码单元,约相当于同数量的常见中英文字符;emoji 可能占两个或更多单元。支持文件导入的工具另有 1 MiB 文件大小上限,文件需为 UTF-8 编码。