# 国密SM2实战：用JavaScript和Python实现前后端加密通信（附完整代码） 在当今数据安全日益重要的背景下，加密通信已成为现代应用开发的标配需求。而国密SM2算法作为我国自主研发的商用密码标准，正逐步成为企业级应用的首选加密方案。本文将带你从零开始，实现一个完整的JavaScript前端与Python后端的SM2加密通信系统。 ## 1. 环境准备与库选型 ### 1.1 前端JavaScript库选择 在前端实现SM2加密，我们有两个主流选择： - **sm-crypto**：纯JavaScript实现，支持浏览器和Node.js环境 - **sm-crypto-v2**：性能优化版本，支持TypeScript 安装方式： ```bash npm install sm-crypto # 或 npm install sm-crypto-v2 ``` ### 1.2 后端Python库选择 Python端推荐使用**gmssl**库，这是官方推荐的国密算法实现： ```bash pip install gmssl ``` ### 1.3 开发环境配置 建议配置： - Node.js 16+ - Python 3.8+ - 现代浏览器(Chrome 90+/Firefox 88+) ## 2. 密钥生成与管理 ### 2.1 生成SM2密钥对 JavaScript端密钥生成： ```javascript const sm2 = require('sm-crypto').sm2; // 生成密钥对 const keypair = sm2.generateKeyPairHex(); const publicKey = keypair.publicKey; // 130位十六进制 const privateKey = keypair.privateKey; // 64位十六进制 console.log('公钥:', publicKey); console.log('私钥:', privateKey); ``` Python端密钥生成： ```python from gmssl import sm2, func # 使用相同的曲线参数 curve = sm2.SM2_DEFAULT_PARAMS keypair = sm2.SM2KeyPair() keypair.generate_key() print(f"公钥: {keypair.public_key.hex()}") print(f"私钥: {keypair.private_key.hex()}") ``` ### 2.2 密钥格式统一 跨语言通信必须确保密钥格式一致： | 属性 | JavaScript格式 | Python格式 | 注意事项 | |------|----------------|------------|----------| | 公钥 | 130位十六进制(04开头) | 65字节二进制 | 需进行hex编解码 | | 私钥 | 64位十六进制 | 32字节二进制 | 不足64位需补0 | ## 3. 加密解密实现 ### 3.1 前端加密 → 后端解密 JavaScript加密代码： ```javascript const sm2 = require('sm-crypto').sm2; function encryptMessage(message, publicKey) { // 使用C1C3C2模式(国密标准) const encrypted = sm2.doEncrypt(message, publicKey, 1); return encrypted; } // 示例使用 const message = '敏感数据123'; const encryptedData = encryptMessage(message, '04B9C9...20207'); console.log('加密结果:', encryptedData); ``` Python解密代码： ```python from gmssl import sm2 def decrypt_message(encrypted_hex, private_key): sm2_crypt = sm2.SM2Crypt( private_key=bytes.fromhex(private_key), mode=sm2.SM2_MODE_C1C3C2 ) decrypted = sm2_crypt.decrypt(bytes.fromhex(encrypted_hex)) return decrypted.decode('utf-8') # 示例使用 decrypted = decrypt_message('04a3b2...ef12', '00B9AB...ED83D5') print('解密结果:', decrypted) ``` ### 3.2 后端加密 → 前端解密 Python加密代码： ```python from gmssl import sm2 def encrypt_message(message, public_key): sm2_crypt = sm2.SM2Crypt( public_key=bytes.fromhex(public_key), mode=sm2.SM2_MODE_C1C3C2 ) encrypted = sm2_crypt.encrypt(message.encode('utf-8')) return encrypted.hex() # 示例使用 encrypted = encrypt_message('服务器响应数据', '04B9C9...20207') ``` JavaScript解密代码： ```javascript function decryptMessage(encryptedHex, privateKey) { return sm2.doDecrypt(encryptedHex, privateKey, 1); } // 示例使用 const decrypted = decryptMessage('04c2d3...fe45', '00B9AB...ED83D5'); console.log('解密结果:', decrypted); ``` ## 4. 实战中的关键问题与解决方案 ### 4.1 常见兼容性问题 1. **加密模式不一致** - 解决方案：统一使用C1C3C2模式(模式1) 2. **公钥格式问题** - 现象：Python报"invalid public key" - 解决：确保公钥为130位十六进制(04开头) 3. **编码混乱** - 现象：解密结果乱码 - 解决：统一使用UTF-8编码 ### 4.2 性能优化技巧 1. **前端加密优化** ```javascript // 启用sm-crypto-v2的性能模式 const sm2 = require('sm-crypto-v2').sm2; sm2.setPerformanceMode(true); ``` 2. **Python后端批处理** ```python # 重用SM2Crypt实例 sm2_crypt = sm2.SM2Crypt(private_key=private_key) # 多次解密使用同一个实例 ``` ### 4.3 安全最佳实践 1. **密钥存储方案** - 前端：避免硬编码，使用环境变量 - 后端：使用HSM或密钥管理服务 2. **传输安全** - 始终使用HTTPS - 对加密结果进行Base64编码再传输 ## 5. 完整示例：Node.js + Flask实现API加密通信 ### 5.1 前端服务(Node.js) ```javascript const express = require('express'); const sm2 = require('sm-crypto').sm2; const axios = require('axios'); const app = express(); app.use(express.json()); // 配置密钥 const config = { serverPublicKey: '04B9C9...20207', clientPrivateKey: '00B9AB...ED83D5' }; // 加密API app.post('/api/encrypt', (req, res) => { const { data } = req.body; const encrypted = sm2.doEncrypt(JSON.stringify(data), config.serverPublicKey, 1); res.json({ encrypted }); }); // 解密API app.post('/api/decrypt', (req, res) => { const { encrypted } = req.body; try { const decrypted = sm2.doDecrypt(encrypted, config.clientPrivateKey, 1); res.json({ data: JSON.parse(decrypted) }); } catch (error) { res.status(400).json({ error: '解密失败' }); } }); // 启动服务 app.listen(3000, () => { console.log('前端服务运行在 http://localhost:3000'); }); ``` ### 5.2 后端服务(Python Flask) ```python from flask import Flask, request, jsonify from gmssl import sm2 import json app = Flask(__name__) # 配置密钥 CONFIG = { 'server_private_key': '00B9AB...ED83D5', 'client_public_key': '04B9C9...20207' } @app.route('/api/process', methods=['POST']) def process_data(): # 解密客户端数据 encrypted = request.json.get('encrypted') sm2_crypt = sm2.SM2Crypt( private_key=bytes.fromhex(CONFIG['server_private_key']), mode=sm2.SM2_MODE_C1C3C2 ) decrypted = sm2_crypt.decrypt(bytes.fromhex(encrypted)).decode('utf-8') # 处理业务逻辑 data = json.loads(decrypted) response_data = { 'status': 'success', 'processed': data.get('value', 0) * 2 } # 加密响应 sm2_crypt = sm2.SM2Crypt( public_key=bytes.fromhex(CONFIG['client_public_key']), mode=sm2.SM2_MODE_C1C3C2 ) encrypted_resp = sm2_crypt.encrypt(json.dumps(response_data).encode('utf-8')).hex() return jsonify({'encrypted': encrypted_resp}) if __name__ == '__main__': app.run(port=5000, debug=True) ``` ## 6. 高级应用场景 ### 6.1 结合SM3哈希验证 在传输加密数据的同时，可以附加SM3哈希值进行完整性验证： ```javascript // 前端生成哈希 const sm3 = require('sm-crypto').sm3; const dataHash = sm3(originalData); ``` ```python # 后端验证哈希 from gmssl import sm3 def verify_hash(data, received_hash): m = sm3.SM3() m.update(data.encode('utf-8')) return m.hexdigest() == received_hash ``` ### 6.2 混合加密方案 对于大数据量传输，可以采用SM2+SM4混合加密： 1. 使用SM2加密随机生成的SM4密钥 2. 使用SM4加密实际数据 3. 将加密后的SM4密钥和加密数据一起传输 ### 6.3 WebAssembly加速 对于性能敏感场景，可以考虑使用WebAssembly版本： ```javascript import { SM2 } from 'sm-crypto-wasm'; const sm2 = new SM2(); const encrypted = sm2.encrypt(data, publicKey); ``` 在实际项目中，SM2算法的正确实现需要考虑密钥管理、性能优化和错误处理等多个方面。建议在关键业务系统上线前进行充分的兼容性测试和安全审计。