@sparta-utils/crypto-util

🚀 一个统一的加密解密工具库，支持常见加密算法（AES、RSA、SHA、MD5、HMAC、Base64、JWT）以及国密算法（SM2、SM3、SM4）。

• ✅ AES
• ✅ RSA
• ✅ SM2 / SM3 / SM4 (国密)
• ✅ SHA256 / SHA512
• ✅ HMAC
• ✅ MD5
• ✅ Base64 encode/decode
• ✅ JWT (sign/verify/decode)

📦 安装

npm install @sparta-utils/crypto-util

或者使用 yarn：

yarn add @sparta-utils/crypto-util

🔰 快速使用

import { CryptoUtil } from '@sparta-utils/crypto-util';

// ✅ AES 加密解密
import { CryptoUtil } from '@sparta-utils/crypto-util'

const key = '1234567890abcdef'
const iv = 'abcdef1234567890' // 可选，如果使用 ECB 模式可以不传

const encrypted = CryptoUtil.aes.encrypt('Hello AES', {
  key,
  iv,
  mode: 'cbc'
})
console.log('加密后:', encrypted)

const decrypted = CryptoUtil.aes.decrypt(encrypted, {
  key,
  iv,
  mode: 'cbc'
})

console.log('解密后:', decrypted)

// ✅ RSA 密钥生成、加密解密、签名验签
const { publicKey: rsaPub, privateKey: rsaPriv } = CryptoUtil.rsa.generateKeyPair();
const rsaEncrypted = CryptoUtil.rsa.encrypt('Hello RSA', rsaPub);
const rsaDecrypted = CryptoUtil.rsa.decrypt(rsaEncrypted, rsaPriv);
const rsaSignature = CryptoUtil.rsa.sign('RSA Message', rsaPriv);
const rsaVerified = CryptoUtil.rsa.verify('RSA Message', rsaSignature, rsaPub);
console.log('RSA验签:', rsaVerified);

// ✅ SM2 密钥生成、加密解密、签名验签
const { publicKey: rsaPub, privateKey: rsaPriv } = CryptoUtil.rsa.generateKeyPair()
console.log('RSA公钥:', rsaPub)
console.log('RSA私钥:', rsaPriv)
const rsaEncrypted = CryptoUtil.rsa.encrypt('Hello RSA', rsaPub)
console.log('RSA加密:', rsaEncrypted)
const rsaDecrypted = CryptoUtil.rsa.decrypt(rsaEncrypted, rsaPriv)
console.log('RSA解密:', rsaDecrypted)
const rsaSignature = CryptoUtil.rsa.sign('RSA Message', rsaPriv)
console.log('RSA签名:', rsaSignature)
const rsaVerified = CryptoUtil.rsa.verify('RSA Message', rsaSignature, rsaPub)
console.log('RSA验签结果:', rsaVerified)

// ✅ SM3 摘要
const sm3Hash = CryptoUtil.sm3('Hello SM3')
console.log('SM3摘要:', sm3Hash)

// ✅ SM4 加密解密
const sm4Key = '0123456789abcdef'; // 16字节密钥
const sm4Encrypted = CryptoUtil.sm4.encrypt('Hello SM4', sm4Key);
const sm4Decrypted = CryptoUtil.sm4.decrypt(sm4Encrypted, sm4Key);
console.log('SM4解密:', sm4Decrypted);

// ✅ SHA256 / SHA512
const sha256Hash = CryptoUtil.sha.sha256('Hello SHA256');
const sha512Hash = CryptoUtil.sha.sha512('Hello SHA512');
console.log('SHA256:', sha256Hash);
console.log('SHA512:', sha512Hash);

// ✅ HMAC-SHA
const hmac256 = CryptoUtil.hmac.hmac('sha256', 'hmacKey', 'HMAC Message')
const hmac512 = CryptoUtil.hmac.hmac('sha512', 'hmacKey', 'HMAC Message')

console.log('HMAC-SHA256:', hmac256)
console.log('HMAC-SHA512:', hmac512)

// ✅ MD5
const md5Hash = CryptoUtil.md5('Hello MD5');
console.log('MD5:', md5Hash);

// ✅ Base64
const base64Encoded = CryptoUtil.base64.encode('Hello Base64')
console.log('Base64编码:', base64Encoded)
const base64Decoded = CryptoUtil.base64.decode(base64Encoded)
console.log('Base64解码:', base64Decoded)

// ✅ JWT 签发与验证 浏览器不可使用 / 当前方法尚不完善
const jwtToken = CryptoUtil.jwt.sign({ uid: 1001 }, 'jwtSecretKey');
const jwtPayload = CryptoUtil.jwt.verify(jwtToken, 'jwtSecretKey');
console.log('JWT验证:', jwtPayload);

📚 支持功能

模块	功能	方法示例
AES	对称加密	encrypt, decrypt
RSA	非对称加密/签名	generateKeyPair, encrypt, decrypt, sign, verify
SM2	国密加密/签名	generateKeyPair, encrypt, decrypt, sign, verify
SM3	国密摘要算法	sm3(message)
SM4	国密对称加密	encrypt, decrypt
SHA	摘要（sha256、sha512）	sha256, sha512
HMAC	带密钥摘要（HMAC-SHA）	hmacSHA256, hmacSHA512
MD5	MD5 哈希	md5(message)
Base64	编码与解码	encode, decode
JWT	Token 生成与校验	sign, verify, decode

🧪 加密方法详解

🔐 AES (对称加密)

方法	说明	参数说明
encrypt	加密字符串	(text: string, key: string) => string
decrypt	解密字符串	(cipherText: string, key: string) => string

🔑 RSA (非对称加密)

方法	说明	参数说明
generateKeyPair	生成密钥对	() => { publicKey: string, privateKey: string }
encrypt	公钥加密	(text: string, publicKey: string) => string
decrypt	私钥解密	(cipherText: string, privateKey: string) => string
sign	私钥签名	(text: string, privateKey: string) => string
verify	公钥验证签名	(text: string, signature: string, publicKey: string) => boolean

🧧 SM2 (国密非对称加密)

方法	说明	参数说明
generateKeyPair	生成密钥对	() => { publicKey: string, privateKey: string }
encrypt	公钥加密	(text: string, publicKey: string) => string
decrypt	私钥解密	(cipherText: string, privateKey: string) => string
sign	签名	(text: string, privateKey: string) => string
verify	验签	(text: string, signature: string, publicKey: string) => boolean

🧮 SM3 (国密摘要)

方法	说明	参数说明
sm3	生成摘要	(text: string) => string

🔒 SM4 (对称加密)

方法	说明	参数说明
encrypt	加密	(text: string, key: string) => string
decrypt	解密	(cipherText: string, key: string) => string

📌 SHA 摘要算法

方法	说明	参数说明
sha256	SHA256 哈希	(text: string) => string
sha512	SHA512 哈希	(text: string) => string

🔐 HMAC 加密（带密钥的哈希）

方法	说明	参数说明
hmacSHA256	SHA256 HMAC	(text: string, key: string) => string
hmacSHA512	SHA512 HMAC	(text: string, key: string) => string

🧬 MD5

方法	说明	参数说明
md5	MD5 哈希	(text: string) => string

🔤 Base64

方法	说明	参数说明
encode	Base64 编码	(text: string) => string
decode	Base64 解码	(base64: string) => string

🔑 JWT (JSON Web Token)

方法	说明	参数说明
sign	生成 token	(payload: object, secret: string, options?: SignOptions) => string
verify	验证 token 有效性	(token: string, secret: string) => object | string
decode	解码 token	(token: string) => null | { [key: string]: any }

📄 License MIT License © 2025-present