AES-CTR算法下Node.js crypto对应WebCrypto.subtle.decrypt的实现问题

针对你从Node.js crypto.createCipheriv 迁移到WebCrypto subtle.encrypt/decrypt 的三个疑问，直接解答如下：

1. WebCrypto的counter是否等同于Node.js的IV？ #

是的，完全等同。AES-CTR模式中，初始向量（IV）的本质就是初始计数器值。你的旧代码中用的是16字节（128位）的IV，直接把这个Buffer传入WebCrypto的counter参数即可，同时要将length设为128（和AES-128的密钥长度匹配，对应旧代码的aes-128-ctr算法）。

2. 如何用相同密码生成WebCrypto所需的密钥？ #

旧代码中直接将UTF-8编码的16字节字符串作为AES密钥，WebCrypto需要通过importKey方法导入原始密钥：

• 密钥格式用raw（对应Node.js的Buffer原始字节）
• 算法指定为AES-CTR
• 密钥用途设置为encrypt和decrypt

示例代码：

const privateKey = '16Random_Letters';
const keyBuffer = new TextEncoder().encode(privateKey); // 等价于Node.js的Buffer.from(privateKey, 'utf8')

async function getCryptoKey() {
  return crypto.subtle.importKey(
    'raw',
    keyBuffer,
    { name: 'AES-CTR' },
    false, // 密钥是否可提取，这里设为false即可
    ['encrypt', 'decrypt']
  );
}

3. 编码转换逻辑的复刻 #

WebCrypto仅处理ArrayBuffer类型数据，所以需要手动实现旧代码中的UTF-8和Base64转换逻辑：

• 加密流程：UTF-8字符串 → Uint8Array → 加密得到ArrayBuffer → 转换为Base64字符串
• 解密流程：Base64字符串 → Uint8Array → 解密得到ArrayBuffer → 转换为UTF-8字符串

对应的转换工具函数：

// UTF-8字符串转Uint8Array
function stringToUint8Array(str) {
  return new TextEncoder().encode(str);
}

// Uint8Array转UTF-8字符串
function uint8ArrayToString(buf) {
  return new TextDecoder().decode(buf);
}

// ArrayBuffer/Uint8Array转Base64字符串
function bufferToBase64(buf) {
  return btoa(String.fromCharCode(...new Uint8Array(buf)));
}

// Base64字符串转Uint8Array
function base64ToUint8Array(base64) {
  return new Uint8Array(atob(base64).split('').map(c => c.charCodeAt(0)));
}

完整迁移代码（匹配旧逻辑） #

// 配置和旧代码一致
const ivHex = '0123456789ABCDEF0123456789ABCDEF';
const privateKey = '16Random_Letters';
const counter = new Uint8Array(Buffer.from(ivHex, 'hex')); // 直接复用旧IV作为counter

// 密钥导入
async function getCryptoKey() {
  const keyBuffer = new TextEncoder().encode(privateKey);
  return crypto.subtle.importKey(
    'raw',
    keyBuffer,
    { name: 'AES-CTR' },
    false,
    ['encrypt', 'decrypt']
  );
}

// 编码转换工具
function stringToUint8Array(str) {
  return new TextEncoder().encode(str);
}
function uint8ArrayToString(buf) {
  return new TextDecoder().decode(buf);
}
function bufferToBase64(buf) {
  return btoa(String.fromCharCode(...new Uint8Array(buf)));
}
function base64ToUint8Array(base64) {
  return new Uint8Array(atob(base64).split('').map(c => c.charCodeAt(0)));
}

// WebCrypto版加密函数
async function webEncryptData(data) {
  const key = await getCryptoKey();
  const encodedData = stringToUint8Array(data);
  const encryptedBuffer = await crypto.subtle.encrypt(
    { name: 'AES-CTR', counter, length: 128 },
    key,
    encodedData
  );
  return bufferToBase64(encryptedBuffer);
}

// WebCrypto版解密函数
async function webDecryptData(data) {
  const key = await getCryptoKey();
  const encodedData = base64ToUint8Array(data);
  const decryptedBuffer = await crypto.subtle.decrypt(
    { name: 'AES-CTR', counter, length: 128 },
    key,
    encodedData
  );
  return uint8ArrayToString(decryptedBuffer);
}

// 测试函数（验证和旧代码结果一致）
async function testMigration() {
  const sourceText = `any text to encrypt!`;
  
  // 旧代码加密结果
  const oldEncrypted = oldEncryptData(sourceText);
  // WebCrypto加密结果
  const webEncrypted = await webEncryptData(sourceText);
  console.log('加密结果是否一致:', oldEncrypted === webEncrypted);
  
  // 解密验证
  const oldDecrypted = oldDecryptData(oldEncrypted);
  const webDecrypted = await webDecryptData(oldEncrypted);
  console.log('解密结果是否匹配源文本:', sourceText === oldDecrypted && sourceText === webDecrypted);
}

testMigration();

内容的提问来源于stack exchange，提问作者Ivan Shesterkin