npm install --save sm-crypto

### 微信小程序中 `miniprogram-sm-crypto` 的 SM4 加密模式 #### 安装与引入 为了在微信小程序中使用 `miniprogram-sm-crypto` 库中的 SM4 功能，需先通过 npm 进行安装： ```bash npm install miniprogram-sm-crypto --save ``` 随后，在项目文件中导入该模块以便后续调用其函数[^1]。 #### 初始化配置 确保已正确设置编译工具链支持 ES6 转换至 ES5 语法兼容性处理；另外还需注意检查 `package.json` 文件内的 `"type"` 字段应设为 `"commonjs"` 或者不指定此字段以保持默认行为[^5]。 #### 创建加密实例并执行操作 下面展示了一个简单的例子来说明如何创建一个基于 ECB 模式的 SM4 密码器对象以及完成字符串的加解密过程： ```javascript const smCrypto = require('miniprogram-sm-crypto'); // 获取随机生成的16字节秘钥用于演示目的 let key = smCrypto.util.hexToBytes(smCrypto.sm4.randomHex(16)); function encryptData(data) { let cipherText; try { const sm4Cipher = new smCrypto.sm4.Cipher(key, 'ecb', null); // 将明文转换成字节数组形式再进行填充补位 let paddedPlainText = smCrypto.padding.pkcs7Padding( smCrypto.util.stringToUtf8ByteArray(data) ); // 执行实际的数据加密运算得到密文结果 cipherText = sm4Cipher.encrypt(paddedPlainText); console.log(`Encrypted Data: ${cipherText}`); } catch (error) { console.error(error.message); } } function decryptData(ciphertextBase64) { let decryptedText; try { const sm4Decipher = new smCrypto.sm4.Decipher(key, 'ecb', null); // 解析 Base64 编码后的密文恢复原始二进制表示 let decodedCiphertext = smCrypto.util.base64ToBytes(ciphertextBase64); // 实施逆向变换即解密流程获得去除填充后的原文本 decryptedText = smCrypto.util.utf8ByteArrayToString( smCrypto.padding.removePkcs7Padding( sm4Decipher.decrypt(decodedCiphertext) ) ); console.log(`Decrypted Text: ${decryptedText}`); } catch (error) { console.error(error.message); } } ``` 上述代码片段展示了如何利用 `miniprogram-sm-crypto` 库来进行基本的 SM4 数据保护工作。值得注意的是这里选择了ECB作为运作模式之一，并采用了PKCS#7标准做为填充方案[^3]。

### 微信小程序 SM 加密算法使用方法及库 #### 1. 库的选择与安装 对于微信小程序而言，`miniprogram-sm-crypto`是一个非常受欢迎且实用的加密库[^1]。此库不仅提供了诸如对称加密、非对称加密以及消息认证码(MAC)等多种加密方式的支持，而且特别针对微信小程序进行了优化，使得开发者能够更加便捷地在其应用内加入必要的安全措施。 为了开始使用该库，在命令行界面执行如下指令完成依赖包的下载： ```bash npm install --save miniprogram-sm-crypto ``` #### 2. 对称加密(SM4) 当涉及到敏感信息如用户登录凭证等场景下，可以考虑采用SM4作为对称加密方案来保障信息安全传递给服务器端处理。下面给出一段简单的例子展示如何利用这个库来进行字符串级别的加解密操作: ```javascript const crypto = require('miniprogram-sm-crypto').default; // 初始化向量IV, 密钥key长度需满足特定要求 let iv = '0123456789abcdef'; let key = 'fedcba9876543210'; function encrypt(data){ let cipher = new crypto.sm4.Cipher(iv, key); return cipher.update(data).final().toString(crypto.util.format.base64); // 返回Base64编码后的密文 } function decrypt(encryptedData){ let decipher = new crypto.sm4.Decipher(iv, key); return decipher.update(atob(encryptedData)).final(); // 解析Base64并返回原文 } ``` 需要注意的是，如果后端已经采用了Base64编码，则前端无需再做额外转换；反之则应按照上述代码所示先通过`atob()`函数还原原始字节流后再进行下一步骤[^4]。 #### 3. 非对称加密(SM2) 除了常见的对称加密外，有时也会遇到公私钥体系下的需求——即发送方用接收者的公开密钥加密消息而只有持有对应私人密钥的一方才可读取内容的情况。此时就可以借助于`sm2`模块实现这样的功能： ```javascript import { sm2 } from 'miniprogram-sm-crypto'; async function generateKeyPair(){ const pair = await sm2.generateKeyPairHex(); console.log(`Public Key:${pair.public}`, `Private Key:${pair.private}`); return pair; } function sign(message,privateKey){ var signature = sm2.doSign(privateKey,message); return signature.toString('hex'); } function verifySignature(publicKey,message,signature){ try{ if(sm2.doVerify(publicKey,message,new Buffer(signature,'hex'))===true){ console.log("验证成功"); return true; } }catch(e){ console.error("签名验证失败",e.message); return false; } } ``` 这段脚本展示了怎样创建一对新的钥匙组合，并演示了基本的消息签署和校验逻辑[^3]。 #### 4. 哈希摘要(SM3) 最后介绍一种用于生成固定大小散列值的方法——哈希函数。在这里选用国密标准里的SM3算法为例说明其具体应用场景之一就是用来计算文件指纹或是其他任意二进制对象的身份标识符： ```javascript import * as smCrypto from 'miniprogram-sm-crypto'; var hash = smCrypto.createHash('sm3'); hash.update('some data to be hashed'); console.log(hash.digest('hex')); ``` 以上便是有关于微信小程序中几种主要类型的SM系列加密技术及其对应的实践案例[^5]。