
HMAC(Keyed-Hash Message Authentication Code)是一种使用加密哈希函数和密钥来验证消息完整性和真实性的机制。在API认证中,HMAC被广泛应用。当在不同编程环境(如PHP与Google Apps Script)中实现HMAC时,一个常见的挑战是确保密钥和消息的底层字节表示方式一致。特别是当密钥以十六进制字符串形式提供时,需要将其正确转换为二进制字节序列。
PHP的hash_hmac函数在处理字符串类型的密钥时,会将其解释为二进制数据。例如,chr(hexdec('C7'))会将十六进制C7(十进制199)转换为一个字节值为199的字符。然而,Google Apps Script中的Utilities.computeHmacSignature函数对输入类型有更严格的要求,通常期望密钥和消息都是字节数组(byte[])。
在Google Apps Script中,初次尝试将十六进制密钥转换为字符串时,可能会使用String.fromCharCode(parseInt("C7", 16))。这种方法会将十六进制值解析为Unicode字符,而不是原始的字节。例如,parseInt("C7", 16)得到199,String.fromCharCode(199)会生成一个Unicode字符,其字节表示可能与原始的二进制字节199不同,尤其是在不同的字符编码环境下。这会导致Utilities.computeHmacSignature函数对密钥的解释出现偏差,从而计算出错误的HMAC值。
原始的Google Apps Script尝试:
// 错误示例:将十六进制转换为Unicode字符
var klucz = String.fromCharCode(parseInt("C7",16)) + String.fromCharCode(parseInt("7C",16)) + ...;
// ...
var hmac = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_SHA_1, wiadomosc, klucz);这种方法未能正确地将十六进制表示的二进制密钥转换为Utilities.computeHmacSignature所期望的字节数组,导致计算结果与PHP不一致。
为了在Google Apps Script中正确计算HMAC,需要确保以下两点:
给定一个十六进制密钥字符串(例如C77C96EEF6F6995B),我们需要将其分解为每两个字符一组的十六进制对,然后将每对转换为其对应的十进制数值。由于Java(Google Apps Script底层)的byte类型是有符号的,范围是-128到127,因此对于大于127(即0x7F)的无符号字节值,需要进行相应的调整(减去256)以匹配Java的带符号字节表示。
以下是实现此转换的JavaScript代码片段:
/**
* 将十六进制字符串转换为Google Apps Script Utilities函数所需的字节数组。
* 对于大于127的无符号字节值,转换为其对应的带符号字节表示。
* @param {string} hexString 十六进制密钥字符串,例如 "C77C96EEF6F6995B"。
* @returns {number[]} 字节数组。
*/
function hexToSignedByteArray(hexString) {
return hexString.match(/.{2}/g).map(e => {
const byteValue = parseInt(e, 16);
// 如果字节值大于127(即最高位为1),则转换为带符号的负数
return byteValue > 127 ? byteValue - 256 : byteValue;
});
}
// 示例使用
var hexKey = "C77C96EEF6F6995B";
var kluczByteArray = hexToSignedByteArray(hexKey);
// kluczByteArray 现在是一个如 [-57, 124, -106, -18, -10, -10, -103, 91] 的数组这个hexToSignedByteArray函数确保了十六进制密钥被正确地解析为Google Apps Script Utilities函数所期望的byte[](实际上是number[],其中数字代表字节值,并处理了符号位)。
同样,为了确保一致性,传递给Utilities.computeHmacSignature的消息内容也应该是一个字节数组。Google Apps Script提供了Utilities.newBlob(string).getBytes()方法,可以将字符串按照UTF-8编码转换为字节数组。
var messageString = "https://www.ifirma.pl/iapi/abonent/miesiacksiegowy.json" + "user@example.com" + "abonent"; var messageByteArray = Utilities.newBlob(messageString).getBytes();
结合上述转换,以下是Google Apps Script中正确计算HMAC的完整函数:
/**
* 将字节数组转换为十六进制字符串,用于日志输出。
* @param {number[]} data 字节数组。
* @returns {string} 十六进制字符串。
*/
function bytesToHex(data) {
return data.map(function(e) {
// 将带符号字节转换为无符号字节(0-255),然后转为16进制
var v = (e < 0 ? e + 256 : e).toString(16);
return v.length == 1 ? "0" + v : v;
}).join("");
}
/**
* 将十六进制字符串转换为Google Apps Script Utilities函数所需的字节数组。
* 对于大于127的无符号字节值,转换为其对应的带符号字节表示。
* @param {string} hexString 十六进制密钥字符串。
* @returns {number[]} 字节数组。
*/
function hexToSignedByteArray(hexString) {
return hexString.match(/.{2}/g).map(e => {
const byteValue = parseInt(e, 16);
return byteValue > 127 ? byteValue - 256 : byteValue;
});
}
/**
* 在Google Apps Script中计算HMAC-SHA1签名。
*/
function callNumbers() {
// 1. 准备十六进制密钥并转换为字节数组
var hexKey = "C77C96EEF6F6995B";
var kluczByteArray = hexToSignedByteArray(hexKey);
// 2. 准备消息内容
var user = "user@example.com"; // 替换为实际的用户信息
var url = "https://www.ifirma.pl/iapi/abonent/miesiacksiegowy.json"; // 替换为实际的URL
var nazwaKlucza = "abonent"; // 替换为实际的键名
var messageString = url + user + nazwaKlucza;
// 3. 将消息字符串转换为字节数组
var messageByteArray = Utilities.newBlob(messageString).getBytes();
// 4. 使用Utilities.computeHmacSignature计算HMAC
// 注意:HMAC_SHA_1算法,消息和密钥都必须是字节数组
var hmacByteArray = Utilities.computeHmacSignature(
Utilities.MacAlgorithm.HMAC_SHA_1,
messageByteArray,
kluczByteArray
);
// 5. 将结果字节数组转换为十六进制字符串以便于显示和比较
var hmacHex = bytesToHex(hmacByteArray);
Logger.log(hmacHex); // 预期输出: 9b5f9bb41ac30b9c55b10f3cecdd6e12e852f274
}运行上述callNumbers函数,将得到与PHP脚本完全一致的HMAC哈希值:9b5f9bb41ac30b9c55b10f3cecdd6e12e852f274。
通过遵循这些指导原则,您可以在Google Apps Script中可靠地实现HMAC签名,确保与各种API和平台之间的兼容性。
以上就是正确使用Google Apps Script计算带十六进制密钥的HMAC的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号