README
¶
🔒 Cryptox
Cryptox 是使用 Go 开发的安全套件，包括了常用的对称加密和非对称加密算法，还有散列算法、编解码常用算法等，主要是为了方便相关场景使用。
💡 功能特性
- 支持 HEX/BASE64 等编解码算法。
- 支持 MD5/SHA1/SHA256/SHA512/HMAC 等散列算法。
- 支持 CRC/FNV 等散列算法。
- 支持 DES/3DES/AES 等对称加密算法。
- 支持 RSA/ECC 等非对称加密算法。
- 支持 ECB/CBC/OFB/CFB/CTR 等分组模式。
- 支持 PKCS5/PKCS7/ZERO/NO 等填充方式。
历史版本的特性请查看 HISTORY.md。未来版本的新特性和计划请查看 FUTURE.md。
⚙ 使用方式
$ go get -u github.com/FishGoddess/cryptox
🚴🏻 性能测试
$ go test -v -bench=. -benchtime=1s _examples/*_test.go
注：数据为 128 字节，ecb/cbc 为 pkcs7 填充，cfb/ofb/ctr 为不填充。
goos: darwin
goarch: amd64
cpu: Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz
BenchmarkMD5-12 7447408 156.3 ns/op 112 B/op 2 allocs/op
BenchmarkSHA1-12 6629499 184.2 ns/op 136 B/op 2 allocs/op
BenchmarkSHA224-12 4768708 249.6 ns/op 160 B/op 2 allocs/op
BenchmarkSHA256-12 4755806 256.2 ns/op 160 B/op 2 allocs/op
BenchmarkSHA384-12 3717706 329.8 ns/op 272 B/op 2 allocs/op
BenchmarkSHA512-12 3679125 325.5 ns/op 288 B/op 2 allocs/op
BenchmarkHMAC-12 1215033 988.4 ns/op 512 B/op 6 allocs/op
BenchmarkCRC32IEEE-12 17037747 70.4 ns/op 24 B/op 2 allocs/op
BenchmarkCRC64ISO-12 26904604 44.8 ns/op 8 B/op 1 allocs/op
BenchmarkCRC64ECMA-12 26632101 44.4 ns/op 8 B/op 1 allocs/op
BenchmarkFnv32-12 41738200 28.2 ns/op 8 B/op 1 allocs/op
BenchmarkFnv32a-12 42062208 29.0 ns/op 8 B/op 1 allocs/op
BenchmarkFnv64-12 39065052 29.9 ns/op 8 B/op 1 allocs/op
BenchmarkFnv64a-12 39740802 29.9 ns/op 8 B/op 1 allocs/op
BenchmarkFnv128-12 23474830 50.2 ns/op 16 B/op 1 allocs/op
BenchmarkFnv128a-12 24201123 50.3 ns/op 16 B/op 1 allocs/op
BenchmarkDESEncryptWithECB-12 351558 3444 ns/op 512 B/op 3 allocs/op
BenchmarkDESEncryptWithCBC-12 334164 3668 ns/op 608 B/op 6 allocs/op
BenchmarkDESEncryptWithCFB-12 352360 3566 ns/op 352 B/op 5 allocs/op
BenchmarkDESEncryptWithOFB-12 148867 8146 ns/op 856 B/op 5 allocs/op
BenchmarkDESEncryptWithCTR-12 138829 8547 ns/op 856 B/op 5 allocs/op
BenchmarkDESDecryptWithECB-12 356511 3427 ns/op 272 B/op 2 allocs/op
BenchmarkDESDecryptWithCBC-12 327507 3664 ns/op 368 B/op 5 allocs/op
BenchmarkDESDecryptWithCFB-12 345454 3552 ns/op 352 B/op 5 allocs/op
BenchmarkDESDecryptWithOFB-12 145267 8183 ns/op 856 B/op 5 allocs/op
BenchmarkDESDecryptWithCTR-12 144640 8451 ns/op 856 B/op 5 allocs/op
BenchmarkTripleDESEncryptWithECB-12 131902 9259 ns/op 768 B/op 3 allocs/op
BenchmarkTripleDESEncryptWithCBC-12 126849 9468 ns/op 864 B/op 6 allocs/op
BenchmarkTripleDESEncryptWithCFB-12 130987 9276 ns/op 608 B/op 5 allocs/op
BenchmarkTripleDESEncryptWithOFB-12 57150 20805 ns/op 1112 B/op 5 allocs/op
BenchmarkTripleDESEncryptWithCTR-12 55443 21344 ns/op 1112 B/op 5 allocs/op
BenchmarkTripleDESDecryptWithECB-12 132991 9236 ns/op 528 B/op 2 allocs/op
BenchmarkTripleDESDecryptWithCBC-12 117877 9483 ns/op 624 B/op 5 allocs/op
BenchmarkTripleDESDecryptWithCFB-12 129415 9064 ns/op 608 B/op 5 allocs/op
BenchmarkTripleDESDecryptWithOFB-12 56397 20979 ns/op 1112 B/op 5 allocs/op
BenchmarkTripleDESDecryptWithCTR-12 56103 21694 ns/op 1112 B/op 5 allocs/op
BenchmarkAESEncryptWithECB-12 2376924 506 ns/op 960 B/op 6 allocs/op
BenchmarkAESEncryptWithCBC-12 1704799 699 ns/op 1072 B/op 9 allocs/op
BenchmarkAESEncryptWithCFB-12 1890339 632 ns/op 816 B/op 8 allocs/op
BenchmarkAESEncryptWithOFB-12 1000000 1029 ns/op 1312 B/op 8 allocs/op
BenchmarkAESEncryptWithCTR-12 979789 1186 ns/op 1312 B/op 8 allocs/op
BenchmarkAESDecryptWithECB-12 2811610 429 ns/op 720 B/op 5 allocs/op
BenchmarkAESDecryptWithCBC-12 2013831 613 ns/op 832 B/op 8 allocs/op
BenchmarkAESDecryptWithCFB-12 1935090 625 ns/op 816 B/op 8 allocs/op
BenchmarkAESDecryptWithOFB-12 1000000 1025 ns/op 1312 B/op 8 allocs/op
BenchmarkAESDecryptWithCTR-12 1000000 1173 ns/op 1312 B/op 8 allocs/op
BenchmarkRSAEncryptPKCS1v15-12 23575 51665 ns/op 5119 B/op 12 allocs/op
BenchmarkRSAEncryptOAEP-12 23125 54832 ns/op 5475 B/op 18 allocs/op
BenchmarkRSADecryptPKCS1v15-12 806 1388847 ns/op 26180 B/op 102 allocs/op
BenchmarkRSADecryptPKCS1v15SessionKey-12 856 1367107 ns/op 26179 B/op 102 allocs/op
BenchmarkRSADecryptOAEP-12 812 1377677 ns/op 26284 B/op 107 allocs/op
🎨 贡献者
如果您觉得 cryptox 缺少您需要的功能，请不要犹豫，马上参与进来，发起一个 issue。
💪 使用 cryptox 的项目
| 项目 | 作者 | 描述 | 链接 |
|---|---|---|---|
| Github / 码云 |
最后，我想感谢 JetBrains 公司的 free JetBrains Open Source license(s)，因为 cryptox 是用该计划下的 Idea / GoLand 完成开发的。
Documentation
¶
Index ¶
- Variables
- type Bytes
- func FromBase64(base64String string) (Bytes, error)
- func FromBytes(bs []byte) Bytes
- func FromHex(hexString string) (Bytes, error)
- func FromString(str string) Bytes
- func GenerateBytes(n int) (Bytes, error)
- func PaddingNone(bs Bytes, blockSize int) Bytes
- func PaddingPKCS5(bs Bytes, blockSize int) Bytes
- func PaddingPKCS7(bs Bytes, blockSize int) Bytes
- func PaddingZero(bs Bytes, blockSize int) Bytes
- func UnPaddingNone(bs Bytes, blockSize int) (Bytes, error)
- func UnPaddingPKCS5(bs Bytes, blockSize int) (Bytes, error)
- func UnPaddingPKCS7(bs Bytes, blockSize int) (Bytes, error)
- func UnPaddingZero(bs Bytes, blockSize int) (Bytes, error)
- type Padding
- type UnPadding
Constants ¶
This section is empty.
Variables ¶
var ( // FileFlag is the flag of file. FileFlag = os.O_CREATE | os.O_APPEND | os.O_WRONLY // FileMode is the mode of file. FileMode os.FileMode = 0644 )
var ( // Base64 is the encoding of base64. Base64 = base64.StdEncoding )
Functions ¶
This section is empty.
Types ¶
type Bytes ¶
type Bytes []byte
Bytes is an alias of []byte.
func FromBase64 ¶ added in v0.3.2
FromBase64 creates a new Bytes from base64 string.
func FromString ¶ added in v0.3.2
FromString creates a new Bytes from string.
func GenerateBytes ¶ added in v0.3.2
GenerateBytes generates a byte slice filled with random byte. It usually used to generate an iv and install iv to crypted data. For example, you use this method to generate a byte slice and pass it to encrypter as iv. After encrypting, you append this iv slice encoded to hex or base64 to crypted slice as they are one part. When you need to decrypt data, parse iv from the "crypted" slice including raw-crypted slice and iv slice first. Then you can pass this iv to decrypter and decrypt data as usual. However, you should know that the crypted data of the same plain data will be different every time because of different ivs.
func PaddingNone ¶
PaddingNone won't padding anything to bs.
func PaddingPKCS5 ¶
PaddingPKCS5 paddings bs using pkcs5.
func PaddingPKCS7 ¶
PaddingPKCS7 paddings bs using pkcs7.
func UnPaddingNone ¶
UnPaddingNone won't unPadding anything from bs.
func UnPaddingPKCS5 ¶
UnPaddingPKCS5 unPaddings bs using pkcs5.
func UnPaddingPKCS7 ¶
UnPaddingPKCS7 unPaddings bs using pkcs7.
func UnPaddingZero ¶
UnPaddingZero unPaddings zero from bs.
Source Files
Directories