DES
DES(Data Encryption Standard)是一种对称加密算法,使用 8
字节密钥。dongle
支持标准 DES
加密,提供多种分组模式、填充模式和输出格式。
支持以下分组模式:
- CBC(Cipher Block Chaining):密码分组链接模式,需要设置密钥
Key
、初始化向量IV
(8 字节)和填充模式Padding
- CTR(Counter):计数器模式,需要设置密钥
Key
和初始化向量IV
(8 字节) - GCM(Galois/Counter Mode):伽罗瓦/计数器模式,需要设置密钥
Key
、随机数Nonce
(8 字节)和附加认证数据AAD
- ECB(Electronic Codebook):电子密码本模式,需要设置密钥
Key
和填充模式Padding
- CFB(Cipher Feedback):密码反馈模式,需要设置密钥
Key
和初始化向量IV
(8 字节) - OFB(Output Feedback):输出反馈模式,需要设置密钥
Key
和初始化向量IV
(8 字节)
支持以下填充模式:
- No:无填充,明文长度必须是 8 的整数倍
- Zero:零填充,用零字节填充到块边界,如果明文长度不是 8 的倍数,则用 0x00 字节填充
- PKCS7:PKCS#7 填充,最常用的填充方式,用 N 个值为 N 的字节填充,其中 N 是填充的字节数
- PKCS5:PKCS#5 填充,适用于 8 字节块大小,用 N 个值为 N 的字节填充,其中 N 是填充的字节数
- AnsiX923:ANSI X.923 填充,除最后一个字节外都用 0x00 填充,最后一个字节表示填充的字节数
- ISO97971:ISO/IEC 9797-1 填充,第一个字节为 0x80,其余用 0x00 填充
- ISO10126:ISO/IEC 10126 填充,除最后一个字节外都用随机字节填充,最后一个字节表示填充的字节数
- ISO78164:ISO/IEC 7816-4 填充,第一个字节为 0x80,其余用 0x00 填充
- Bit:位填充,在明文末尾添加一个 1 位,然后用 0 位填充到块边界
CBC 模式
创建 Cipher
go
import "github.com/dromara/dongle/crypto/cipher"
c := cipher.NewDesCipher(cipher.CBC)
// 设置密钥(8 字节)
c.SetKey([]byte("12345678"))
// 设置初始化向量(8 字节)
c.SetIV([]byte("87654321"))
// 设置填充模式(可选,默认为 PKCS7)
c.SetPadding(cipher.PKCS7)
加密数据
输入数据
go
// 输入字符串
encrypter := dongle.Encrypt.FromString("hello world").ByDes(c)
// 输入字节切片
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByDes(c)
// 输入文件流
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByDes(c)
// 检查加密错误
if encrypter.Error != nil {
fmt.Printf("加密错误: %v\n", encrypter.Error)
return
}
输出数据
go
// 输出 Hex 编码字符串
encrypter.ToHexString() // 7fae94fd1a8b880d8d5454dd8df30c40
// 输出 Hex 编码字节切片
encrypter.ToHexBytes() // []byte("7fae94fd1a8b880d8d5454dd8df30c40")
// 输出 Base64 编码字符串
encrypter.ToBase64String() // f66U/RqLiA2NVFTdjfMMQA==
// 输出 Base64 编码字节切片
encrypter.ToBase64Bytes() // []byte("f66U/RqLiA2NVFTdjfMMQA==")
// 输出 原始 字符串
encrypter.ToRawString()
// 输出 原始 字节切片
encrypter.ToRawBytes()
解密数据
输入数据
go
// 输入 Hex 编码字符串
decrypter := dongle.Decrypt.FromHexString(hexString).ByDes(c)
// 输入 Hex 编码字节切片
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByDes(c)
// 输入 Hex 编码文件流
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByDes(c)
// 输入 Base64 编码字符串
decrypter := dongle.Decrypt.FromBase64String(base64String).ByDes(c)
// 输入 Base64 编码字节切片
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByDes(c)
// 输入 Base64 编码文件流
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByDes(c)
// 输入原始字符串
decrypter := dongle.Decrypt.FromRawString(rawString).ByDes(c)
// 输入原始字节切片
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByDes(c)
// 输入原始文件流
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByDes(c)
// 检查解密错误
if decrypter.Error != nil {
fmt.Printf("解密错误: %v\n", decrypter.Error)
return
}
输出数据
go
// 输出字符串
decrypter.ToString() // hello world
// 输出字节切片
decrypter.ToBytes() // []byte("hello world")
CTR 模式
创建 Cipher
go
import "github.com/dromara/dongle/crypto/cipher"
c := cipher.NewDesCipher(cipher.CTR)
// 设置密钥(8 字节)
c.SetKey([]byte("12345678"))
// 设置初始化向量(8 字节)
c.SetIV([]byte("87654321"))
加密数据
输入数据
go
// 输入字符串
encrypter := dongle.Encrypt.FromString("hello world").ByDes(c)
// 输入字节切片
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByDes(c)
// 输入文件流
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByDes(c)
// 检查加密错误
if encrypter.Error != nil {
fmt.Printf("加密错误: %v\n", encrypter.Error)
return
}
输出数据
go
// 输出 Hex 编码字符串
encrypter.ToHexString() // 7fae94fd1a8b880d8d5454dd8df30c40
// 输出 Hex 编码字节切片
encrypter.ToHexBytes() // []byte("7fae94fd1a8b880d8d5454dd8df30c40")
// 输出 Base64 编码字符串
encrypter.ToBase64String() // f66U/RqLiA2NVFTdjfMMQA==
// 输出 Base64 编码字节切片
encrypter.ToBase64Bytes() // []byte("f66U/RqLiA2NVFTdjfMMQA==")
// 输出 原始 字符串
encrypter.ToRawString()
// 输出 原始 字节切片
encrypter.ToRawBytes()
解密数据
输入数据
go
// 输入 Hex 编码字符串
decrypter := dongle.Decrypt.FromHexString(hexString).ByDes(c)
// 输入 Hex 编码字节切片
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByDes(c)
// 输入 Hex 编码文件流
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByDes(c)
// 输入 Base64 编码字符串
decrypter := dongle.Decrypt.FromBase64String(base64String).ByDes(c)
// 输入 Base64 编码字节切片
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByDes(c)
// 输入 Base64 编码文件流
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByDes(c)
// 输入原始字符串
decrypter := dongle.Decrypt.FromRawString(rawString).ByDes(c)
// 输入原始字节切片
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByDes(c)
// 输入原始文件流
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByDes(c)
// 检查解密错误
if decrypter.Error != nil {
fmt.Printf("解密错误: %v\n", decrypter.Error)
return
}
输出数据
go
// 输出字符串
decrypter.ToString() // hello world
// 输出字节切片
decrypter.ToBytes() // []byte("hello world")
GCM 模式
GCM 模式提供认证加密功能,支持额外的认证数据(AAD)。
创建 Cipher
go
import "github.com/dromara/dongle/crypto/cipher"
c := cipher.NewDesCipher(cipher.GCM)
// 设置密钥(8 字节)
c.SetKey([]byte("12345678"))
// 设置随机数(8 字节)
c.SetNonce([]byte("87654321"))
// 设置额外的认证数据(可选)
c.SetAAD([]byte("additional data"))
加密数据
输入数据
go
// 输入字符串
encrypter := dongle.Encrypt.FromString("hello world").ByDes(c)
// 输入字节切片
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByDes(c)
// 输入文件流
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByDes(c)
// 检查加密错误
if encrypter.Error != nil {
fmt.Printf("加密错误: %v\n", encrypter.Error)
return
}
输出数据
go
// 输出 Hex 编码字符串
encrypter.ToHexString() // 7fae94fd1a8b880d8d5454dd8df30c40
// 输出 Hex 编码字节切片
encrypter.ToHexBytes() // []byte("7fae94fd1a8b880d8d5454dd8df30c40")
// 输出 Base64 编码字符串
encrypter.ToBase64String() // f66U/RqLiA2NVFTdjfMMQA==
// 输出 Base64 编码字节切片
encrypter.ToBase64Bytes() // []byte("f66U/RqLiA2NVFTdjfMMQA==")
// 输出 原始 字符串
encrypter.ToRawString()
// 输出 原始 字节切片
encrypter.ToRawBytes()
解密数据
输入数据
go
// 输入 Hex 编码字符串
decrypter := dongle.Decrypt.FromHexString(hexString).ByDes(c)
// 输入 Hex 编码字节切片
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByDes(c)
// 输入 Hex 编码文件流
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByDes(c)
// 输入 Base64 编码字符串
decrypter := dongle.Decrypt.FromBase64String(base64String).ByDes(c)
// 输入 Base64 编码字节切片
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByDes(c)
// 输入 Base64 编码文件流
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByDes(c)
// 输入原始字符串
decrypter := dongle.Decrypt.FromRawString(rawString).ByDes(c)
// 输入原始字节切片
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByDes(c)
// 输入原始文件流
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByDes(c)
// 检查解密错误
if decrypter.Error != nil {
fmt.Printf("解密错误: %v\n", decrypter.Error)
return
}
输出数据
go
// 输出字符串
decrypter.ToString() // hello world
// 输出字节切片
decrypter.ToBytes() // []byte("hello world")
ECB 模式
创建 Cipher
go
import "github.com/dromara/dongle/crypto/cipher"
c := cipher.NewDesCipher(cipher.ECB)
// 设置密钥(8 字节)
c.SetKey([]byte("12345678"))
// 设置填充模式(可选,默认为 PKCS7)
c.SetPadding(cipher.PKCS7)
加密数据
输入数据
go
// 输入字符串
encrypter := dongle.Encrypt.FromString("hello world").ByDes(c)
// 输入字节切片
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByDes(c)
// 输入文件流
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByDes(c)
// 检查加密错误
if encrypter.Error != nil {
fmt.Printf("加密错误: %v\n", encrypter.Error)
return
}
输出数据
go
// 输出 Hex 编码字符串
encrypter.ToHexString() // 7fae94fd1a8b880d8d5454dd8df30c40
// 输出 Hex 编码字节切片
encrypter.ToHexBytes() // []byte("7fae94fd1a8b880d8d5454dd8df30c40")
// 输出 Base64 编码字符串
encrypter.ToBase64String() // f66U/RqLiA2NVFTdjfMMQA==
// 输出 Base64 编码字节切片
encrypter.ToBase64Bytes() // []byte("f66U/RqLiA2NVFTdjfMMQA==")
// 输出 原始 字符串
encrypter.ToRawString()
// 输出 原始 字节切片
encrypter.ToRawBytes()
解密数据
输入数据
go
// 输入 Hex 编码字符串
decrypter := dongle.Decrypt.FromHexString(hexString).ByDes(c)
// 输入 Hex 编码字节切片
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByDes(c)
// 输入 Hex 编码文件流
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByDes(c)
// 输入 Base64 编码字符串
decrypter := dongle.Decrypt.FromBase64String(base64String).ByDes(c)
// 输入 Base64 编码字节切片
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByDes(c)
// 输入 Base64 编码文件流
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByDes(c)
// 输入原始字符串
decrypter := dongle.Decrypt.FromRawString(rawString).ByDes(c)
// 输入原始字节切片
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByDes(c)
// 输入原始文件流
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByDes(c)
// 检查解密错误
if decrypter.Error != nil {
fmt.Printf("解密错误: %v\n", decrypter.Error)
return
}
输出数据
go
// 输出字符串
decrypter.ToString() // hello world
// 输出字节切片
decrypter.ToBytes() // []byte("hello world")
CFB 模式
创建 Cipher
go
import "github.com/dromara/dongle/crypto/cipher"
c := cipher.NewDesCipher(cipher.CFB)
// 设置密钥(8 字节)
c.SetKey([]byte("12345678"))
// 设置初始化向量(8 字节)
c.SetIV([]byte("87654321"))
加密数据
输入数据
go
// 输入字符串
encrypter := dongle.Encrypt.FromString("hello world").ByDes(c)
// 输入字节切片
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByDes(c)
// 输入文件流
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByDes(c)
// 检查加密错误
if encrypter.Error != nil {
fmt.Printf("加密错误: %v\n", encrypter.Error)
return
}
输出数据
go
// 输出 Hex 编码字符串
encrypter.ToHexString() // 7fae94fd1a8b880d8d5454dd8df30c40
// 输出 Hex 编码字节切片
encrypter.ToHexBytes() // []byte("7fae94fd1a8b880d8d5454dd8df30c40")
// 输出 Base64 编码字符串
encrypter.ToBase64String() // f66U/RqLiA2NVFTdjfMMQA==
// 输出 Base64 编码字节切片
encrypter.ToBase64Bytes() // []byte("f66U/RqLiA2NVFTdjfMMQA==")
// 输出 原始 字符串
encrypter.ToRawString()
// 输出 原始 字节切片
encrypter.ToRawBytes()
解密数据
输入数据
go
// 输入 Hex 编码字符串
decrypter := dongle.Decrypt.FromHexString(hexString).ByDes(c)
// 输入 Hex 编码字节切片
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByDes(c)
// 输入 Hex 编码文件流
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByDes(c)
// 输入 Base64 编码字符串
decrypter := dongle.Decrypt.FromBase64String(base64String).ByDes(c)
// 输入 Base64 编码字节切片
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByDes(c)
// 输入 Base64 编码文件流
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByDes(c)
// 输入原始字符串
decrypter := dongle.Decrypt.FromRawString(rawString).ByDes(c)
// 输入原始字节切片
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByDes(c)
// 输入原始文件流
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByDes(c)
// 检查解密错误
if decrypter.Error != nil {
fmt.Printf("解密错误: %v\n", decrypter.Error)
return
}
输出数据
go
// 输出字符串
decrypter.ToString() // hello world
// 输出字节切片
decrypter.ToBytes() // []byte("hello world")
OFB 模式
创建 Cipher
go
import "github.com/dromara/dongle/crypto/cipher"
c := cipher.NewDesCipher(cipher.OFB)
// 设置密钥(8 字节)
c.SetKey([]byte("12345678"))
// 设置初始化向量(8 字节)
c.SetIV([]byte("87654321"))
加密数据
输入数据
go
// 输入字符串
encrypter := dongle.Encrypt.FromString("hello world").ByDes(c)
// 输入字节切片
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByDes(c)
// 输入文件流
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByDes(c)
// 检查加密错误
if encrypter.Error != nil {
fmt.Printf("加密错误: %v\n", encrypter.Error)
return
}
输出数据
go
// 输出 Hex 编码字符串
encrypter.ToHexString() // 7fae94fd1a8b880d8d5454dd8df30c40
// 输出 Hex 编码字节切片
encrypter.ToHexBytes() // []byte("7fae94fd1a8b880d8d5454dd8df30c40")
// 输出 Base64 编码字符串
encrypter.ToBase64String() // f66U/RqLiA2NVFTdjfMMQA==
// 输出 Base64 编码字节切片
encrypter.ToBase64Bytes() // []byte("f66U/RqLiA2NVFTdjfMMQA==")
// 输出 原始 字符串
encrypter.ToRawString()
// 输出 原始 字节切片
encrypter.ToRawBytes()
解密数据
输入数据
go
// 输入 Hex 编码字符串
decrypter := dongle.Decrypt.FromHexString(hexString).ByDes(c)
// 输入 Hex 编码字节切片
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByDes(c)
// 输入 Hex 编码文件流
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByDes(c)
// 输入 Base64 编码字符串
decrypter := dongle.Decrypt.FromBase64String(base64String).ByDes(c)
// 输入 Base64 编码字节切片
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByDes(c)
// 输入 Base64 编码文件流
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByDes(c)
// 输入原始字符串
decrypter := dongle.Decrypt.FromRawString(rawString).ByDes(c)
// 输入原始字节切片
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByDes(c)
// 输入原始文件流
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByDes(c)
// 检查解密错误
if decrypter.Error != nil {
fmt.Printf("解密错误: %v\n", decrypter.Error)
return
}
输出数据
go
// 输出字符串
decrypter.ToString() // hello world
// 输出字节切片
decrypter.ToBytes() // []byte("hello world")