本文详细介绍了在 Node.js 环境下实现 HMAC-based Extract-and-Expand Key Derivation Function (HKDF) 的扩展（Expand）阶段。针对 Node.js crypto 模块不直接提供 HKDFExpand 的挑战，文章通过分析其算法原理，提供了一个基于 Bitwarden 源码的自定义实现方案，并结合 PBKDF2HMAC 演示了密钥派生的完整流程，旨在帮助开发者在 Node.js 中实现与 Python 等其他语言兼容的密钥扩展功能。
1. 理解 HKDF 与密钥派生
密钥派生函数 (Key Derivation Function, KDF) 的主要目的是从一个主密钥（或密码）派生出多个安全强度高、用途不同的子密钥。HKDF (HMAC-based Extract-and-Expand Key Derivation Function) 是一种广泛使用的 KDF，它由两个主要阶段组成：
Extract（提取）：从一个弱熵输入密钥（IKM, Input Key Material）和一个可选的盐值（salt）中提取出一个固定长度的伪随机密钥（PRK, Pseudo-Random Key）。这个阶段通常使用 HMAC-SHA256 等算法。Expand（扩展）：从 PRK 派生出所需长度的输出密钥材料（OKM, Output Key Material）。这个阶段允许派生出多个不同用途的子密钥，每个子密钥都可以通过一个“信息”（info）字符串进行上下文绑定，确保其唯一性。
在 Bitwarden 等密码管理器中，通常会先使用 PBKDF2HMAC 等算法从用户密码派生出一个主密钥，然后将此主密钥作为 HKDF 的 PRK，通过 HKDF-Expand 派生出用于加密、解密等操作的实际工作密钥。
2. Node.js 中实现 HKDF-Expand 的挑战
Node.js 的 crypto 模块提供了 HMAC、PBKDF2 等核心加密原语，但并没有直接提供一个与 cryptography.hazmat.primitives.kdf.hkdf.HKDFExpand 功能完全对应的 API。这导致在尝试从 Python 等其他语言移植使用 HKDF-Expand 的密钥派生逻辑时，开发者可能会遇到不一致的结果。
例如，直接使用 crypto.createHmac 尝试模拟 HKDF-Expand 是不正确的，因为 HKDF-Expand 包含了一个迭代过程和特定的数据拼接逻辑。
不正确的尝试示例：
import crypto from 'crypto';const salt = 'salt';const iterations = 100000;const password = '123';const info = 'enc'; // 对应 HKDF-Expand 的 info 参数// 1. PBKDF2HMAC 派生主密钥 (masterKey)const masterKey = crypto.pbkdf2Sync(password, salt, iterations, 32, 'sha256');console.log('Node.js Master Key:', masterKey.toString('hex')); // 与 Python 结果一致// 2. 尝试使用 createHmac 模拟 HKDF-Expand// 这种方式是错误的，因为它不符合 HKDF-Expand 的算法规范const stretchedKeyAttempt = crypto.createHmac('sha256', info).update(masterKey).digest();console.log('Node.js Stretched Key (Incorrect Attempt):', stretchedKeyAttempt.toString('hex'));
与 Python cryptography 库的正确 HKDF-Expand 结果进行对比，可以发现 stretchedKeyAttempt 的结果是不同的，这验证了直接使用 createHmac 的方法是错误的。
3. HKDF-Expand 算法原理
HKDF-Expand 的核心在于迭代地计算 HMAC，并拼接上下文信息和计数器。其算法步骤如下：
给定：
PRK (Pseudo-Random Key)：伪随机密钥，长度至少为哈希输出长度。info：可选的上下文信息字符串。L：所需输出密钥材料的字节长度。Hash：HMAC 使用的哈希函数（例如 SHA256），其输出长度为 hashLen。
步骤：
计算 N = ceil(L / hashLen)，即需要进行 HMAC 迭代的次数。初始化 T(0) 为空字节序列。对于 i 从 1 到 N：T(i) = HMAC(PRK, T(i-1) || info || L_byte)|| 表示字节序列拼接。L_byte 是一个单字节，表示当前的迭代计数 i (例如，0x01, 0x02, …)。最终的 OKM 是 T(1) || T(2) || … || T(N) 的前 L 个字节。
4. 在 Node.js 中实现自定义 HKDF-Expand 函数
根据 HKDF-Expand 的算法原理，我们可以实现一个兼容的自定义函数。以下是基于 Bitwarden 源码的实现，它利用 Node.js crypto 模块的 createHmac 功能来执行 HMAC 运算。
import crypto from 'crypto';/** * 内部 HMAC 辅助函数 * @param data 要进行 HMAC 计算的数据 * @param key HMAC 密钥 * @param algorithm 哈希算法（例如 'sha256'） * @returns HMAC 结果 Buffer */function hmac(data: Uint8Array, key: Buffer, algorithm: string): Buffer { return crypto.createHmac(algorithm, key).update(data).digest();}/** * 实现 HKDF-Expand 密钥扩展函数 * * @param prk 伪随机密钥 (Pseudo-Random Key)，Buffer 类型 * @param info 上下文信息字符串 * @param outputByteSize 所需输出密钥的字节长度 * @returns 派生出的输出密钥材料 (Output Key Material) Buffer */function hkdfExpand( prk: Buffer, info: string, outputByteSize: number): Buffer { const algorithm = "sha256"; // 使用 SHA256 哈希算法 const hashLen = 32; // SHA256 的输出长度为 32 字节 // 确保 PRK 长度足够 const prkArr = new Uint8Array(prk); if (prkArr.length < hashLen) { throw new Error("prk is too small."); } // 将 info 字符串转换为 Uint8Array const infoBuf = Buffer.from(info); const infoArr = new Uint8Array(infoBuf); let runningOkmLength = 0; // 当前已生成的 OKM 长度 let previousT = new Uint8Array(0); // T(i-1) // 计算需要迭代的次数 N const n = Math.ceil(outputByteSize / hashLen); // 预分配 OKM 存储空间 const okm = new Uint8Array(n * hashLen); for (let i = 0; i = outputByteSize) { break; } } // 返回 OKM 的前 outputByteSize 字节 return Buffer.from(okm.slice(0, outputByteSize).buffer);}
5. 完整示例：结合 PBKDF2HMAC 和 HKDF-Expand
现在，我们可以将 PBKDF2HMAC 密钥派生与自定义的 hkdfExpand 函数结合起来，实现完整的密钥派生过程。
import crypto from 'crypto';// 假设上述 hkdfExpand 和 hmac 函数已定义或导入// ... (hkdfExpand 和 hmac 函数代码如上所示) ...const salt = 'salt';const iterations = 100000;const password = '123';const info = 'enc'; // HKDF-Expand 的上下文信息const outputKeyLength = 32; // 期望派生出的密钥长度// 1. 使用 PBKDF2HMAC 从密码派生主密钥 (PRK)const masterKey = crypto.pbkdf2Sync( password, salt, iterations, outputKeyLength, // 这里通常是 32 字节，作为 HKDF 的 PRK 'sha256');console.log('Node.js Master Key (PBKDF2):', masterKey.toString('hex'));// 2. 使用自定义的 hkdfExpand 函数从 masterKey 派生最终的工作密钥const stretchedKey = hkdfExpand(masterKey, info, outputKeyLength);console.log('Node.js Stretched Key (HKDF-Expand):', stretchedKey.toString('hex'));// Python 对应结果 (仅供参考，应与上述 Node.js 结果一致)// master_key.hex() # 5bb4...5990// stretched.hex() # 5bf9...473b
通过运行上述代码，你会发现 Node.js 输出的 stretchedKey 与 Python 中 HKDFExpand 派生出的密钥完全一致。这表明自定义的 hkdfExpand 函数成功地模拟了 HKDF-Expand 的行为。
6. 注意事项
Buffer 与 Uint8Array 的转换：在 Node.js 中，Buffer 和 Uint8Array 都是处理二进制数据的重要类型。在加密操作中，经常需要在这两者之间进行转换。Buffer.from(uint8array) 和 new Uint8Array(buffer) 是常见的转换方式。本例中，为了与 crypto 模块的 Buffer 接口兼容，并在内部处理中方便地进行字节拼接，使用了两者结合的方式。安全性：盐值 (Salt)：在实际应用中，盐值必须是随机生成且足够长的，并且对于每个用户或每个密钥都应该是唯一的，不能使用固定的字符串如 ‘salt’。迭代次数 (Iterations)：PBKDF2 的迭代次数应足够大，以抵御暴力破解攻击。随着计算能力提升，推荐的迭代次数也在增加。密钥长度：派生出的密钥长度应根据加密算法的要求选择，通常为 16 字节（AES-128）、24 字节（AES-192）或 32 字节（AES-256）。上下文信息 (Info)：HKDF-Expand 的 info 参数非常重要，它用于将派生出的密钥与特定的上下文或用途绑定。不同的 info 值将派生出不同的密钥，即使 PRK 相同。这有助于防止密钥重用，并提高安全性。性能：对于性能敏感的应用，尤其是需要大量密钥派生操作的场景，应评估自定义实现的性能。Node.js 的 crypto 模块底层是 C++ 实现，性能通常较高，但手动循环和内存操作仍需注意。库的替代方案：虽然 Node.js crypto 模块没有直接提供 HKDF-Expand，但社区中可能存在封装好的第三方库，它们可能提供了更简洁的 API 或更全面的功能。在生产环境中，优先考虑使用经过充分审计和测试的第三方库，而不是自行实现复杂加密算法。
7. 总结
在 Node.js 中实现 HKDF-Expand 密钥扩展功能，虽然 crypto 模块未直接提供 API，但通过深入理解 HKDF 的算法原理，并利用 crypto.createHmac 等基本原语，我们可以构建一个功能完整且与其他语言实现兼容的自定义函数。本文提供的实现方案，源自对实际应用（如 Bitwarden）的分析，展示了如何从 PBKDF2HMAC 派生主密钥，再通过自定义的 HKDF-Expand 派生出最终的工作密钥。在实际应用中，务必关注安全性最佳实践，确保密钥派生过程的健壮性和安全性。
以上就是在 Node.js 中实现 HKDF-Expand 密钥扩展函数的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1521722.html
微信扫一扫 
支付宝扫一扫 
