zencrypt

Overview ¶

Package zencrypt Package enctypt 提供各种加密算法实现

AES-CBC加密示例（传统模式）:

cipher := enctypt.NewAesEncrypt("your-secret-key")

// 加密
encrypted, err := cipher.Encrypt([]byte("secret data"))
if err != nil {
    log.Fatal(err)
}

// 解密
decrypted, err := cipher.Decrypt(encrypted)
if err != nil {
    log.Fatal(err)
}

AES-GCM加密示例（推荐，现代标准）:

cipher := enctypt.NewAesGcmEncrypt("your-secret-key")

// 加密（自动提供完整性校验）
encrypted, err := cipher.Encrypt([]byte("secret data"))
if err != nil {
    log.Fatal(err)
}

// 解密（自动验证完整性）
decrypted, err := cipher.Decrypt(encrypted)
if err != nil {
    log.Fatal(err)  // 如果数据被篡改，这里会报错
}

注意事项:

• 密钥会通过SHA256派生为32字节
• CBC模式：IV随机生成并附加在密文前16字节，使用PKCS7填充
• GCM模式：Nonce随机生成并附加在密文前12字节，自带认证标签，无需填充
• 推荐使用GCM模式（更安全，更快，防篡改）

Package zencrypt Package encrypt 提供RSA加密和签名工具。

安全建议 ¶

对于加密，请使用OAEP模式（EncryptOAEP/DecryptOAEP）而不是PKCS1v15。 PKCS1v15已被弃用，因为容易受到选择密文攻击。

使用示例 ¶

基础加密（推荐 - OAEP）：

privKey, _ := encrypt.GenerateSecretKey()
pubKey := &privKey.PublicKey
ciphertext, _ := encrypt.EncryptOAEP(pubKey, plaintext)
decrypted, _ := encrypt.DecryptOAEP(privKey, ciphertext)

带Label的加密（防重放）：

label := []byte("user:12345")  // 绑定到特定用户
ciphertext, _ := encrypt.EncryptOAEPWithLabel(pubKey, plaintext, label)
decrypted, _ := encrypt.DecryptOAEPWithLabel(privKey, ciphertext, label)

自定义哈希函数（大密钥）：

// ⚠️ 每次调用必须创建新的Hash实例，不能复用
ciphertext, _ := encrypt.EncryptOAEPWithHash(pubKey, sha512.New(), plaintext)
decrypted, _ := encrypt.DecryptOAEPWithHash(privKey, sha512.New(), ciphertext)

数字签名：

privKey, _ := encrypt.GenerateSecretKey()
signature, _ := encrypt.Sign(privKey, data)
err := encrypt.Verify(&privKey.PublicKey, data, signature)

Package zencrypt Package encrypt 提供SM2国密非对称加密和签名实现。

SM2是中国国家密码管理局发布的椭圆曲线公钥密码算法标准（GM/T 0003-2012）， 基于256位素数域椭圆曲线，安全强度等同于ECC P-256。

加密示例:

privKey, _ := encrypt.GenerateSM2Key()
pubKey := privKey.PublicKey()

ciphertext, _ := encrypt.SM2Encrypt(pubKey, []byte("secret data"))
plaintext, _ := encrypt.SM2Decrypt(privKey, ciphertext)

签名示例:

privKey, _ := encrypt.GenerateSM2Key()
signature, _ := encrypt.SM2Sign(privKey, []byte("data"))
err := encrypt.SM2Verify(privKey.PublicKey(), []byte("data"), signature)

密钥PEM序列化:

privPem := encrypt.SM2MarshalPrivateKey(privKey)
pubPem := encrypt.SM2MarshalPublicKey(privKey.PublicKey())

privKey2, _ := encrypt.SM2ParsePrivateKey(privPem)
pubKey2, _ := encrypt.SM2ParsePublicKey(pubPem)

Package encrypt 提供SM3国密哈希实现。

SM3是中国国家密码管理局发布的密码杂凑算法标准（GM/T 0004-2012）， 输出256位（32字节）摘要，安全强度等同于SHA-256。

示例:

hash := encrypt.SM3("my-data")
// hash 为32字节摘要

hashHex := encrypt.SM3Hex("my-data")
// hashHex 为64字符十六进制字符串

hashBytes := encrypt.SM3Bytes([]byte("my-data"))
// 直接对字节切片计算哈希

Package zencrypt Package encrypt 提供基于 SM3 的密码哈希实现（信创默认）。

使用 SM3-HMAC + 随机 salt + 多轮迭代，安全强度等同于 PBKDF2-SHA256。 符合 GM/T 0004-2012 标准。

示例:

hasher := encrypt.NewSM3Password()

hash, _ := hasher.Encrypt("my-password")
ok := hasher.CompareHashAndPassword("my-password", hash) // true
ok = hasher.CompareHashAndPassword("wrong", hash)        // false

与 Argon2/Bcrypt 接口一致，可直接替换。

Package zencrypt Package encrypt 提供SM4国密对称加密实现。

SM4-GCM加密示例（推荐）:

cipher := encrypt.NewSM4GcmEncrypt("your-secret-key")

encrypted, err := cipher.Encrypt([]byte("secret data"))
if err != nil {
    log.Fatal(err)
}

decrypted, err := cipher.Decrypt(encrypted)
if err != nil {
    log.Fatal(err)
}

SM4-CBC加密示例:

cipher := encrypt.NewSM4Encrypt("your-secret-key")

encrypted, err := cipher.Encrypt([]byte("secret data"))
if err != nil {
    log.Fatal(err)
}

decrypted, err := cipher.Decrypt(encrypted)
if err != nil {
    log.Fatal(err)
}

注意事项:

• 密钥通过SM3派生为16字节（SM4密钥长度固定128位）
• CBC模式：IV随机生成并附加在密文前16字节，使用PKCS7填充
• GCM模式：Nonce随机生成并附加在密文前12字节，自带认证标签，无需填充
• 推荐使用GCM模式（更安全，更快，防篡改）
• 符合 GM/T 0002-2012 标准

cipher := NewAesEncrypt("test-key")
plaintext := []byte("Hello, World!")

// 加密
encrypted, _ := cipher.Encrypt(plaintext)

// 解密
decrypted, _ := cipher.Decrypt(encrypted)

fmt.Println(string(decrypted))

Output:
Hello, World!