如何使用sjcl.js正确实现AES-GCM解密？

我经常用SJCL处理AES加密解密，针对你给出的代码片段，整理了几个关键要点和可运行的示例代码，帮你顺利完成解密：

核心前提：SJCL对AES-GCM的处理逻辑 #

SJCL在AES-GCM模式下，加密时会自动把随机数（nonce）、密文、认证标签打包成一个比特数组，再编码成Base64输出；解密时则需要把完整的密文解码回比特数组，它会自动拆分这三部分并完成校验。

可运行的解密代码示例 #

结合你提供的密钥和密文，完整的解密代码应该是这样的：

// 你的Base64编码密钥
const keyBase64 = "8mUzwnewfaBFKiGW/rO5Xw==";
// 将Base64密钥解码为SJCL需要的比特数组
const keyBits = sjcl.codec.base64.toBits(keyBase64);

// 注意：这里要使用完整的Base64密文，你当前提供的内容末尾有`...`会导致解码失败
const cipherTextBase64 = "Oz9IH7sElYzEyLCQoHJZJgH6z4J3INJtJyrpQzFQg3dRbEFIla4r4ox0ktA/Sh077fvCnnaMrCKu9PiYOQiRN7bS7EAXKgdiMN/zL98j4HyeVB9nRrH2PVXGKL+TcjM3F+kScl0DyCHJxHiXb+rKhXlYc/3T2ulBV8xIwk+S0IdV5TwjIfLIY7lxWcvZt9Mi2JEt9C54RFU3nFQIexSPIpoLtwnonbguSlx/KsNYgpObhlhRsC9W/Ix2m4n6eDxfQWCuhQp5614OiizBzgKBD1dKkjpGvUajZqhVwW4/AY6BwqucflasjA...";
// 将密文解码为比特数组
const cipherBits = sjcl.codec.base64.toBits(cipherTextBase64);

try {
    // 初始化AES实例并执行GCM解密
    const plaintextBits = sjcl.mode.gcm.decrypt(new sjcl.cipher.aes(keyBits), cipherBits);
    // 将解密后的比特数组转成UTF-8字符串
    const plaintext = sjcl.codec.utf8String.fromBits(plaintextBits);
    console.log("解密成功：", plaintext);
} catch (error) {
    console.error("解密失败：", error.message);
    // 常见失败原因参考下面的坑点列表
}

解密时容易踩的坑 #

• 密文必须完整：你当前提供的密文末尾有...截断标记，这会导致Base64解码失败，一定要使用加密时生成的完整密文
• 密钥长度合规：你的密钥Base64解码后是16字节（128位），正好符合AES-128的要求；如果是24字节对应AES-192，32字节对应AES-256，SJCL会自动适配
• 认证标签校验：GCM模式自带完整性校验，如果密文被篡改、密钥不匹配，或者标签丢失，解密时会直接抛出错误，这是正常的安全特性
• 编码格式统一：加密时用的编码（Base64/十六进制）和解密时必须一致，你这里用Base64，所以解码要用sjcl.codec.base64.toBits

特殊场景：手动拆分nonce、密文、标签 #

如果你的密文是分开存储nonce、密文、标签的（不是SJCL默认的打包格式），可以手动传入这些参数解密：

// 示例：假设nonce、密文、标签都是Base64编码
const nonceBits = sjcl.codec.base64.toBits("你的nonce的Base64值");
const cipherOnlyBits = sjcl.codec.base64.toBits("仅密文部分的Base64值");
const tagBits = sjcl.codec.base64.toBits("认证标签的Base64值");

const plaintextBits = sjcl.mode.gcm.decrypt(
    new sjcl.cipher.aes(keyBits), 
    cipherOnlyBits, 
    nonceBits, 
    tagBits
);
const plaintext = sjcl.codec.utf8String.fromBits(plaintextBits);

内容的提问来源于stack exchange，提问作者Ismayil Niftaliyev