Node.js中如何验证Werkzeug生成的密码哈希?代码返回false怎么办
校验始终返回false的核心原因
- 哈希拆分逻辑完全错误:werkzeug
generate_password_hash生成的scrypt格式哈希,所有字段以$作为分隔符,整串结构中不存在冒号。原代码执行hash.split(":")时,拆分结果仅为长度1的数组,解构得到的key变量直接为undefined,无论计算出的派生密钥是什么,都不可能和undefined相等。 - scrypt派生参数不匹配:werkzeug的scrypt实现有固定的默认运行参数(CPU/内存消耗值N、块大小r、并行度p、输出密钥长度dkLen),原代码既没有从哈希串中读取对应参数,还错误将整个哈希字符串的字符长度作为派生密钥长度传入
crypto.scrypt,计算出的派生密钥和werkzeug生成的密钥从根上就没有一致性。 - 编码处理不统一:werkzeug存储的盐值、最终哈希值均采用无填充的URL安全Base64编码,原代码未对这类编码值做解码,直接把字符串形式的编码值传入scrypt作为salt参数;同时将Node端派生的密钥转成十六进制字符串后,和Base64编码的存储值直接做相等比较,编码格式完全不对齐。
修正后的可用实现
以下代码完全对齐werkzeug scrypt哈希的计算逻辑,可直接完成原Flask环境生成的密码哈希校验:
const crypto = require('crypto'); async function verify(password, werkzeugHash) { return new Promise((resolve, reject) => { // 按照werkzeug的格式规则拆分哈希串 const hashParts = werkzeugHash.split('$'); // 校验scrypt格式的哈希结构完整性 if (hashParts.length !== 6 || hashParts[0] !== 'scrypt') { return reject(new Error('当前哈希格式不被支持,仅可校验scrypt类型的werkzeug哈希')); } // 解析哈希中内嵌的scrypt运行参数 const [, nStr, rStr, pStr, encodedSalt, storedEncodedHash] = hashParts; const scryptOptions = { N: parseInt(nStr, 10), r: parseInt(rStr, 10), p: parseInt(pStr, 10), maxmem: 32 * 1024 * 1024 // 匹配werkzeug scrypt运行所需的内存上限 }; const DKLEN = 64; // werkzeug scrypt默认派生密钥长度 // 解码werkzeug存储的URL安全Base64格式盐值 const saltBuffer = Buffer.from(encodedSalt, 'base64url'); crypto.scrypt(password, saltBuffer, DKLEN, scryptOptions, (err, derivedKey) => { if (err) return reject(err); // 解码存储的哈希值为Buffer,使用时间安全的比较方法避免时序泄露 const storedHashBuffer = Buffer.from(storedEncodedHash, 'base64url'); resolve(crypto.timingSafeEqual(derivedKey, storedHashBuffer)); }); }); }
补充说明
- 上述实现仅覆盖werkzeug默认使用的scrypt哈希方案,如果历史存储的哈希是pbkdf2系列、sha256等其他算法生成的,需要对应调整拆分规则和派生逻辑。
- 禁止使用直接字符串相等的方式校验哈希值,
crypto.timingSafeEqual可以避免校验过程中的时序攻击风险。 - 如果使用Node 14及以下的旧版本,需要手动对Base64url编码值做适配:将编码串中的
-替换为+、_替换为/,补充缺失的Base64填充字符后再解码。
内容的提问来源于stack exchange,提问作者Varun Rajkumar
相关产品推荐
相关产品推荐

