Skip to content

Latest commit

 

History

History
184 lines (152 loc) · 4.41 KB

API使用说明.md

File metadata and controls

184 lines (152 loc) · 4.41 KB
Raw

国密GM/T Go API使用说明

国密gmsm包安装

go get -u github.com/tjfoc/gmsm

SM3密码杂凑算法 - SM3 cryptographic hash algorithm

遵循的SM3标准号为： GM/T 0004-2012

导入包

import github.com/tjfoc/gmsm/sm3

代码示例

    data := "test"
    h := sm3.New()
    h.Write([]byte(data))
    sum := h.Sum(nil)
    fmt.Printf("digest value is: %x\n",sum)

方法列表

New

创建哈希计算实例

func New() hash.Hash

Sum

返回SM3哈希算法摘要值

func Sum() []byte

SM4分组密码算法 - SM4 block cipher algorithm

遵循的SM4标准号为: GM/T 0002-2012

导入包

import github.com/tjfoc/gmsm/sm4

代码示例

    import  "crypto/cipher"
    import  "github.com/tjfoc/gmsm/sm4"

    func main(){
        // 128比特密钥
        key := []byte("1234567890abcdef")
        // 128比特iv
        iv := make([]byte, sm4.BlockSize)
        data := []byte("Tongji Fintech Research Institute")
        ciphertxt,err := sm4Encrypt(key,iv, data)
        if err != nil{
            log.Fatal(err)
        }
        fmt.Printf("加密结果: %x\n", ciphertxt)
    }

    func sm4Encrypt(key, iv, plainText []byte) ([]byte, error) {
        block, err := sm4.NewCipher(key)
        if err != nil {
            return nil, err
        }
        blockSize := block.BlockSize()
        origData := pkcs5Padding(plainText, blockSize)
        blockMode := cipher.NewCBCEncrypter(block, iv)
        cryted := make([]byte, len(origData))
        blockMode.CryptBlocks(cryted, origData)
        return cryted, nil
    }

    func sm4Decrypt(key, iv, cipherText []byte) ([]byte, error) {
        block, err := sm4.NewCipher(key)
    	if err != nil {
        	return nil, err
    	}
    	blockMode := cipher.NewCBCDecrypter(block, iv)
    	origData := make([]byte, len(cipherText))
    	blockMode.CryptBlocks(origData, cipherText)
    	origData = pkcs5UnPadding(origData)
    	return origData, nil
    }
    // pkcs5填充
    func pkcs5Padding(src []byte, blockSize int) []byte {
        padding := blockSize - len(src)%blockSize
    	padtext := bytes.Repeat([]byte{byte(padding)}, padding)
    	return append(src, padtext...)
    }

    func pkcs5UnPadding(src []byte) []byte {
        length := len(src)
    	unpadding := int(src[length-1])
    	return src[:(length - unpadding)]
    }

方法列表

NewCipher

创建SM4密码分组算法模型，参数key长度只支持128比特。

func NewCipher(key []byte) (cipher.Block, error)

SM2椭圆曲线公钥密码算法 - Public key cryptographic algorithm SM2 based on elliptic curves

遵循的SM2标准号为： GM/T 0003.1-2012、GM/T 0003.2-2012、GM/T 0003.3-2012、GM/T 0003.4-2012、GM/T 0003.5-2012、GM/T 0009-2012、GM/T 0010-2012

导入包

import github.com/tjfoc/gmsm/sm2

代码示例

    priv, err := sm2.GenerateKey() // 生成密钥对
    if err != nil {
    	log.Fatal(err)
    }
    msg := []byte("Tongji Fintech Research Institute")
    pub := &priv.PublicKey
    ciphertxt, err := pub.Encrypt(msg)
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Printf("加密结果:%x\n",ciphertxt)
    plaintxt,err :=  priv.Decrypt(ciphertxt)
    if err != nil {
    	log.Fatal(err)
    }
    if !bytes.Equal(msg,plaintxt){
        log.Fatal("原文不匹配")
    }

    r,s,err := sm2.Sign(priv, msg)
    if err != nil {
    	log.Fatal(err)
    }
    isok := sm2.Verify(pub,msg,r,s)
    fmt.Printf("Verified: %v\n", isok)

方法列表

GenerateKey

生成随机秘钥。

func GenerateKey() (*PrivateKey, error)

Sign

用私钥签名数据，成功返回以两个大数表示的签名结果，否则返回错误。

func Sign(priv *PrivateKey, hash []byte) (r, s *big.Int, err error)

Verify

用公钥验证数据签名, 验证成功返回True，否则返回False。

func Verify(pub *PublicKey, hash []byte, r, s *big.Int) bool

Encrypt

用公钥加密数据,成功返回密文错误，否则返回错误。

func Encrypt(pub *PublicKey, data []byte) ([]byte, error)

Decrypt

用私钥解密数据，成功返回原始明文数据，否则返回错误。

func Decrypt(priv *PrivateKey, data []byte) ([]byte, error)