Node.js中实现PBEWithHmacSHA256AndAES_128加密遇问题求指引

核心逻辑说明 #

PBEWithHmacSHA256AndAES_128 是基于密码的加密方案，本质流程为：

• 用 PBKDF2 从用户密码派生32字节密钥（16字节用于AES-128-CBC加密，16字节用于HMAC-SHA256完整性验证）
• 生成16字节随机初始化向量（IV，匹配AES块大小）
• 使用Node.js内置crypto库的aes-128-cbc-hmac-sha256算法完成加密+自动HMAC验证

完整代码示例 #

const crypto = require('crypto');

// 加密函数
function encrypt(plaintext, password) {
  // 生成16字节随机盐
  const salt = crypto.randomBytes(16);
  // 生成16字节随机IV（AES-128-CBC要求与块大小一致）
  const iv = crypto.randomBytes(16);
  // 迭代次数（可根据安全性需求调整，推荐至少10000）
  const iterations = 10000;
  // 派生32字节密钥：16字节AES密钥 + 16字节HMAC密钥
  const key = crypto.pbkdf2Sync(password, salt, iterations, 32, 'sha256');

  // 创建加密实例
  const cipher = crypto.createCipheriv('aes-128-cbc-hmac-sha256', key, iv);
  // 执行加密
  let ciphertext = cipher.update(plaintext, 'utf8', 'base64');
  ciphertext += cipher.final('base64');

  // 返回盐、IV、密文的Base64编码（方便存储/传输）
  return {
    salt: salt.toString('base64'),
    iv: iv.toString('base64'),
    ciphertext: ciphertext
  };
}

// 解密函数
function decrypt(encryptedData, password) {
  const { salt, iv, ciphertext } = encryptedData;
  // 将Base64编码的盐、IV转成Buffer
  const saltBuffer = Buffer.from(salt, 'base64');
  const ivBuffer = Buffer.from(iv, 'base64');
  const iterations = 10000;

  // 用相同参数派生密钥
  const key = crypto.pbkdf2Sync(password, saltBuffer, iterations, 32, 'sha256');

  // 创建解密实例（自动验证HMAC，数据篡改会抛出错误）
  const decipher = crypto.createDecipheriv('aes-128-cbc-hmac-sha256', key, ivBuffer);
  // 执行解密
  let plaintext = decipher.update(ciphertext, 'base64', 'utf8');
  plaintext += decipher.final('utf8');

  return plaintext;
}

// 测试示例
const testPassword = 'your_secure_password';
const testPlaintext = 'Hello, PBEWithHmacSHA256AndAES_128!';

const encrypted = encrypt(testPlaintext, testPassword);
console.log('加密结果:', encrypted);

const decrypted = decrypt(encrypted, testPassword);
console.log('解密结果:', decrypted);

常见错误排查 #

• Invalid key length：aes-128-cbc-hmac-sha256要求密钥长度为32字节，需确保PBKDF2的keylen参数设为32。
• Invalid initialization vector：AES-128-CBC模式要求IV长度必须等于块大小（16字节），需保证生成的IV是16字节的随机Buffer。

内容的提问来源于stack exchange，提问作者Nick Triantafillou