两个地方都写着SHA3,同样输入abc,摘要却不一样。联调时,先查算法的完整名称、输出位数和公开测试值,不要只用一行简写标签判断兼容性。

本次在MD5与哈希工具中测试三组公开文本,并用独立实现分别计算FIPS202的SHA3-512与Keccak-512。页面“SHA3”行的这三组结果都与Keccak-512一致,与标准SHA3-512不同。下面说明怎样识别这项边界,不把它当成所有名为SHA3工具的通用结论。

用abc先确认一组容易重复的输入

输入 abc,末尾不加空格或回车,输出编码保持Hex。查看页面靠下的“SHA3”行。

输入abc时,页面SHA3行的128个十六进制字符以18587dc2开头
输入abc时,页面SHA3行的128个十六进制字符以18587dc2开头

本次该行完整结果是:

18587dc2ea106b9a1563e32b3312421ca164c7f1f07bc922a9c83d77cea3a1e5d0c69910739025372dc14ac9642629379540c17e2a65b19d77aa511a9d00bb96

独立计算标准SHA3-512时,同样abc的结果为:

b751850b1a57168a5693cd924b6b096e08f621827444f70d884f5d0240d2712e10e116e9192af3c91a7ec57647e3934057340b4cf408d5a56592f8274eec53f0

两者都是512位摘要,Hex表示都为128个字符。位数一致不能证明算法相同,也不能把这处差异解释为Hex与Base64切换造成,因为这组比较固定采用同一种输出编码。

标准SHA3源自Keccak体系,但已经标准化的SHA3函数与通常名为Keccak-512的函数并不直接兼容。对接方写明SHA3-512时,不能仅凭页面有“SHA3”一行就直接填入结果。

换另一组公开英文文本复核

第二组输入不带末尾标点的公开测试句:

The quick brown fox jumps over the lazy dog
第二组SHA3行以d135bb84开头,独立核对仍匹配Keccak-512
第二组SHA3行以d135bb84开头,独立核对仍匹配Keccak-512

本次页面结果以 d135bb84d0439dba 开头,标准SHA3-512的对应结果以 01dedd5de4ef1464 开头。独立对照保存了两份完整摘要,比较的是完整值,不是只凭前缀认定相同。

再输入两个汉字“宝塔”:

中文样例按UTF-8核对后,页面SHA3行同样匹配Keccak-512而非标准SHA3-512
中文样例按UTF-8核对后,页面SHA3行同样匹配Keccak-512而非标准SHA3-512

第三组也得到相同的变体关系。此次中文按UTF-8计算,页面“SHA3”值以 a26949cc738c1c60 开头,标准SHA3-512值以 501d9934335b5fe8 开头。三组样例增加了核对材料,但不构成对任意输入或未来版本的完整实现认证。

页面还提供一行“SHA512”。它表示另一种哈希函数,不能用来替代SHA3-512;名称中同样有512,只说明所讨论输出的位数相同,不说明内部定义相同。联调时不要轮流复制几行摘要,直到某一次接口不报错,再倒推算法是什么。

如果对接文档只写了SHA3而没有位数或公开样例,可以先让双方明确完整函数与测试值。已经保存的旧摘要则要连同生成时的算法、输入编码和实现信息保留,避免后来只剩一串结果,无法确定该用哪个函数复核。确认变体是为了获得可复查的一致结果,不是给两种函数按“新旧”排列优劣。

独立计算时把算法写完整

本次对照使用Python的hashlib和PyCryptodomex。前者提供标准SHA3-512,后者的keccak接口明确选择512位输出。以下本地示例需要事先安装PyCryptodomex,只处理公开abc:

import hashlib
from Cryptodome.Hash import keccak

message = b"abc"
print("SHA3-512:", hashlib.sha3_512(message).hexdigest())
print("Keccak-512:", keccak.new(digest_bits=512, data=message).hexdigest())

实际接口要求Keccak-256时,512位输出同样不能代替256位;也不能把512位结果截断就假设得到另一函数。算法名称、输出位数、输入字节和结果编码需要同时一致。

如果比较的是带密钥的消息认证,还要核对是否采用HMAC等构造。普通哈希页面没有因为结果看起来像签名,就自动变成带密钥认证;可参照HMAC核对说明区分操作对象。

对接前用文档公开输入在两边各算一次,保存完整值与算法名。当前入口需要标准SHA3-512结果时,应换用明确实现该标准的环境核对,不能通过改结果大小写、删字符或换显示编码来消除算法差异。