Skip to content

encrypt.md

Latest commit

 

History

History
249 lines (216 loc) · 4.69 KB

encrypt.md

File metadata and controls

249 lines (216 loc) · 4.69 KB
Raw

对称加密使用文档

package main

import (
    "fmt"

    "github.com/deatil/go-cryptobin/cryptobin/crypto"
)

func main() {
    // 加密
    cypt := crypto.
        FromString("useData").
        SetKey("dfertf12dfertf12").
        Aes().
        ECB().
        PKCS7Padding().
        Encrypt().
        ToBase64String()

    // 解密
    cyptde := crypto.
        FromBase64String("i3FhtTp5v6aPJx0wTbarwg==").
        SetKey("dfertf12dfertf12").
        Aes().
        ECB().
        PKCS7Padding().
        Decrypt().
        ToString()

    // i3FhtTp5v6aPJx0wTbarwg==
    fmt.Println("加密结果：", cypt)
    fmt.Println("解密结果：", cyptde)
}

结构说明

  • 默认方式 Aes, ECB, NoPadding
// 加密数据
cypt := crypto.
    FromString("useData").
    SetKey("dfertf12dfertf12").
    Encrypt().
    ToBase64String()
// 解密数据
cyptde := crypto.
    FromBase64String("i3FhtTp5v6aPJx0wTbarwg==").
    SetKey("dfertf12dfertf12").
    Decrypt().
    ToString()
  • 完整方式
// 注意: 设置密码,加密类型,加密模式,补码方式 在 操作类型 之前, 可以调换顺序
var ret string = crypto.
    FromString("string"). // 数据来源, 待加密数据/待解密数据
    SetKey("key").        // 设置密码
    SetIv("iv_string").   // 设置向量
    Aes().                // 加密类型
    CBC().                // 加密模式
    PKCS7Padding().       // 补码方式
    Encrypt().            // 操作类型, 加密或者解密
    ToBase64String()      // 返回结果数据类型

可用方法

  • 数据来源: FromBytes(data []byte), FromString(data string), FromBase64String(data string), FromHexString(data string)
  • 设置密码: SetKey(data string), WithKey(key []byte)
  • 设置向量: SetIv(data string), WithIv(iv []byte)
  • 加密类型: Aes(), Des(), TripleDes(), Twofish(), Blowfish(), Tea(rounds ...int), Xtea(), Cast5(), RC4(), Idea(), SM4(), Chacha20(counter ...[]byte), Chacha20poly1305(additional ...[]byte), Xts(cipher string, sectorNum uint64)
  • 加密模式: ECB(), CBC(), PCBC(), CFB(), OFB(), CTR(), GCM(additional ...[]byte), CCM(additional ...[]byte)
  • 补码方式: NoPadding(), ZeroPadding(), PKCS5Padding(), PKCS7Padding(), X923Padding(), ISO10126Padding(), ISO7816_4Padding(),ISO97971Padding(),PBOC2Padding(), TBCPadding(), PKCS1Padding(bt ...string)
  • 操作类型: Encrypt(), Decrypt(), FuncEncrypt(f func(Cryptobin) Cryptobin), FuncDecrypt(f func(Cryptobin) Cryptobin)
  • 返回数据类型: ToBytes(), ToString(), ToBase64String(), ToHexString()

IV 向量

ECB() 模式不需要设置 IV 向量，其他的已知模式都需要设置 IV 向量

支持的加密类型, 加密模式及补码方式

支持的加密类型

Aes
Des
TwoDes
TripleDes
Twofish
Blowfish
Tea(rounds ...int)
Xtea
Cast5
RC2
RC4
RC4MD5
RC5
RC6
Idea
SM4
Chacha20(counter ...uint32)
Chacha20poly1305(additional ...[]byte)
Chacha20poly1305X(additional ...[]byte)
Xts(cipher string, sectorNum uint64)
Seed
Aria
Camellia
Gost(sbox any)
Kuznyechik
Serpent
Saferplus
Hight
Lea
Kasumi
Safer(typ string, rounds int32)
Multi2(rounds int32)
Kseed
Khazad
Present
Trivium
Rijndael(blockSize int)
Rijndael128
Rijndael192
Rijndael256

支持的加密模式

ECB
CBC
PCBC
CFB
CFB1
CFB8
CFB16
CFB32
CFB64
CFB128
OCFB(resync bool)
OFB
OFB8
NCFB
NOFB
CTR
GCM(additional ...[]byte)
CCM(additional ...[]byte)
OCB(additional ...[]byte)
EAX(additional ...[]byte)
BC
HCTR(tweak, hkey []byte)
MGM(additional ...[]byte)

支持的补码方式

NoPadding
ZeroPadding
PKCS5Padding
PKCS7Padding
X923Padding
ISO10126Padding
ISO7816_4Padding
ISO97971Padding
PBOC2Padding
TBCPadding
PKCS1Padding(bt ...string)

支持的懒加载加密类型

懒加载加密类型

AesECB
AesCFB
Loki97
Wake
Panama
Square
Magenta
E2
Crypton1
Clefia
Threeway
Cast256
Skipjack
Mars
Mars2
Enigma
Noekeon
Anubis
Salsa20

使用示例

package main

import (
    "fmt"

    "github.com/deatil/go-cryptobin/cryptobin/crypto"
    "github.com/deatil/go-cryptobin/cryptobin/crypto/encrypt/threeway"
)

func main() {
    data := "test-pass"

    cypt := crypto.FromString(data).
        SetKey("dfertf12dfyy").
        SetIv("dfertf12dfer").
        MultipleBy(threeway.Threeway).
        CFB().
        PKCS7Padding().
        Encrypt().
        ToBase64String()

    cyptde := crypto.FromBase64String(cypt).
        SetKey("dfertf12dfyy").
        SetIv("dfertf12dfer").
        MultipleBy(threeway.Threeway).
        CFB().
        PKCS7Padding().
        Decrypt().
        ToString()

    fmt.Println("加密结果：", cypt)
    fmt.Println("解密结果：", cyptde)
}