接口数据加解密解决方案文档

接口数据加解密解决方案文档

目录

1. 方案概述
2. 核心架构设计
3. 前端实现详解
4. 后端实现详解
5. 密钥管理方案
6. 集成步骤
7. 示例代码
8. 附录

方案概述

设计目标

本方案旨在为前后端交互的接口数据提供安全、高效、透明的加解密机制，确保敏感数据在传输过程中的安全性。

核心特性

• 双重加密算法支持：同时支持 AES-CBC 和 SM4-CBC 国密算法
• 动态密钥选择：每次加密随机选择密钥和算法，提高破解难度
• 多存储模式：支持本地缓存和 Redis 缓存两种密钥存储方式
• 注解驱动：基于 Spring AOP + 注解，业务代码零侵入
• 完整性校验：内置 MD5 指纹验证，防止数据篡改

技术栈

核心架构设计

整体流程

┌──────────┐ ┌──────────┐ ┌──────────┐ │ 前端 │ │ 网络 │ │ 后端 │ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ │ │ 1. 请求数据加密 │ │ │ ─────────────────────> │ │ │ 2. 请求体解密 │ │ │ ────────────────────> │ │ │ 3. 业务处理 │ │ 4. 响应体加密 │ │ <──────────────────── │ │ 5. 响应数据解密 │ │ │ │ │

数据结构设计

加密后的数据包含完整的元信息和加密内容，采用二进制编码后通过 Base64 传输：

响应体结构

{"success":true,"message":"操作成功","data":"Base64编码的加密字符串","signature":"随机盐值字符串"}

前端实现详解

1. JavaScript 加密库实现

依赖准备

# 需要的加密库npminstallcrypto-js sm-crypto

核心加密工具类

importCryptoJSfrom'crypto-js';import{sm4}from'sm-crypto';/** * 动态加密工具类 */classDynamicEncryptUtil{// 密钥池（需要与后端保持一致，生产环境请自行替换）staticKEY_STRING_ARRAY=["a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6","f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1","1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d","d5c4b3a2f1e0d9c8b7a6f5e4d3c2b1a0","0f1e2d3c4b5a6f7e8d9c0b1a2f3e4d5c","c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8","9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d","4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a"// 生产环境建议配置 16-32 个密钥];/** * 十六进制字符串转字节数组 */statichexStringToBytes(hex){constbytes=[];for(leti=0;i<hex.length;i+=2){bytes.push(parseInt(hex.substr(i,2),16));}returnnewUint8Array(bytes);}/** * 获取随机整数 */staticgetRandInt(max){returnMath.floor(Math.random()*max);}/** * AES-CBC 加密 */staticaesEncryptCbc(keyBytes,ivBytes,plaintext){constkey=CryptoJS.lib.WordArray.create(keyBytes);constiv=CryptoJS.lib.WordArray.create(ivBytes);constencrypted=CryptoJS.AES.encrypt(plaintext,key,{iv:iv,mode:CryptoJS.mode.CBC,padding:CryptoJS.pad.Pkcs7});// 转换为字节数组constciphertext=encrypted.ciphertext;constbytes=newUint8Array(ciphertext.words.length*4);for(leti=0;i<ciphertext.words.length;i++){constword=ciphertext.words[i];bytes[i*4]=(word>>24)&0xFF;bytes[i*4+1]=(word>>16)&0xFF;bytes[i*4+2]=(word>>8)&0xFF;bytes[i*4+3]=word&0xFF;}returnbytes;}/** * SM4-CBC 加密 */staticsm4EncryptCbc(keyBytes,ivBytes,plaintext){constkeyHex=Array.from(keyBytes).map(b=>b.toString(16).padStart(2,'0')).join('');constivHex=Array.from(ivBytes).map(b=>b.toString(16).padStart(2,'0')).join('');// sm-crypto 库的 CBC 模式加密constencrypted=sm4.encrypt(plaintext,keyHex,{iv:ivHex,mode:'cbc'});returnthis.hexStringToBytes(encrypted);}/** * 计算 MD5 */staticmd5(dataBytes){constwordArray=CryptoJS.lib.WordArray.create(dataBytes);constmd5Hash=CryptoJS.MD5(wordArray);returnthis.hexStringToBytes(md5Hash.toString());}/** * 合并字节数组 */staticconcatByteArrays(...arrays){consttotalLength=arrays.reduce((sum,arr)=>sum+arr.length,0);constresult=newUint8Array(totalLength);letoffset=0;for(constarrofarrays){result.set(arr,offset);offset+=arr.length;}returnresult;}/** * 主加密方法 */staticencrypt(data,groupIndex=0){if(!data)returnnull;constkeyLength=this.KEY_STRING_ARRAY.length;// 1. 随机选择密钥constprivateKeyIndex=this.getRandInt(keyLength);constprivateKey=this.hexStringToBytes(this.KEY_STRING_ARRAY[privateKeyIndex]);// 2. 随机选择 IVconstivKeyIndex=this.getRandInt(keyLength);consttokenIv=this.hexStringToBytes(this.KEY_STRING_ARRAY[ivKeyIndex]);// 3. 随机选择算法 (0: AES, 1: SM4)constalgorithmIndex=this.getRandInt(2);// 4. 执行加密letencryptText;switch(algorithmIndex){case0:encryptText=this.aesEncryptCbc(privateKey,tokenIv,data);break;case1:encryptText=this.sm4EncryptCbc(privateKey,tokenIv,data);break;default:encryptText=this.aesEncryptCbc(privateKey,tokenIv,data);}// 5. 构建加密包结构constheader=newUint8Array(32);header[