首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Golang语言情怀-第56期 Go 语言标准库翻译 crypto/cipher

Golang语言情怀-第56期 Go 语言标准库翻译 crypto/cipher

作者头像
李海彬
发布2021-03-09 11:02:37
5210
发布2021-03-09 11:02:37
举报
文章被收录于专栏:Golang语言社区Golang语言社区

import "crypto/cipher"

cipher包实现了多个标准的用于包装底层块加密算法的加密算法实现。

type Block
type BlockMode
func NewCBCDecrypter(b Block, iv []byte) BlockMode
func NewCBCEncrypter(b Block, iv []byte) BlockMode
type Stream
func NewCFBDecrypter(block Block, iv []byte) Stream
func NewCFBEncrypter(block Block, iv []byte) Stream
func NewCTR(block Block, iv []byte) Stream
func NewOFB(b Block, iv []byte) Stream
type StreamReader
func (r StreamReader) Read(dst []byte) (n int, err error)
type StreamWriter
func (w StreamWriter) Write(src []byte) (n int, err error)
func (w StreamWriter) Close() error
type AEAD
func NewGCM(cipher Block) (AEAD, error)
NewCBCDecrypter
NewCBCEncrypter
NewCFBDecrypter
NewCFBEncrypter
NewCTR
NewOFB
StreamReader
StreamWriter

type Block

type Block interface {
    // 返回加密字节块的大小
    BlockSize() int
    // 加密src的第一块数据并写入dst,src和dst可指向同一内存地址
    Encrypt(dst, src []byte)
    // 解密src的第一块数据并写入dst,src和dst可指向同一内存地址
    Decrypt(dst, src []byte)
}

Block接口代表一个使用特定密钥的底层块加/解密器。它提供了加密和解密独立数据块的能力。

type BlockMode

type BlockMode interface {
    // 返回加密字节块的大小
    BlockSize() int
    // 加密或解密连续的数据块,src的尺寸必须是块大小的整数倍,src和dst可指向同一内存地址
    CryptBlocks(dst, src []byte)
}

BlockMode接口代表一个工作在块模式(如CBC、ECB等)的加/解密器。

func NewCBCEncrypter
func NewCBCEncrypter(b Block, iv []byte) BlockMode

返回一个密码分组链接模式的、底层用b加密的BlockMode接口,初始向量iv的长度必须等于b的块尺寸。

func NewCBCDecrypter
func NewCBCDecrypter(b Block, iv []byte) BlockMode

返回一个密码分组链接模式的、底层用b解密的BlockMode接口,初始向量iv必须和加密时使用的iv相同。

type Stream

type Stream interface {
    // 从加密器的key流和src中依次取出字节二者xor后写入dst,src和dst可指向同一内存地址
    XORKeyStream(dst, src []byte)
}

Stream接口代表一个流模式的加/解密器。

func NewCFBEncrypter
func NewCFBEncrypter(block Block, iv []byte) Stream

返回一个密码反馈模式的、底层用block加密的Stream接口,初始向量iv的长度必须等于block的块尺寸。

func NewCFBDecrypter
func NewCFBDecrypter(block Block, iv []byte) Stream

返回一个密码反馈模式的、底层用block解密的Stream接口,初始向量iv必须和加密时使用的iv相同。

func NewOFB
func NewOFB(b Block, iv []byte) Stream

返回一个输出反馈模式的、底层采用b生成key流的Stream接口,初始向量iv的长度必须等于b的块尺寸。

func NewCTR
func NewCTR(block Block, iv []byte) Stream

返回一个计数器模式的、底层采用block生成key流的Stream接口,初始向量iv的长度必须等于block的块尺寸。

type StreamReader

type StreamReader struct {
    S   Stream
    R   io.Reader
}

将一个Stream与一个io.Reader接口关联起来,Read方法会调用XORKeyStream方法来处理获取的所有切片。

func (StreamReader) Read
func (r StreamReader) Read(dst []byte) (n int, err error)

type StreamWriter

type StreamWriter struct {
    S   Stream
    W   io.Writer
    Err error // unused
}

将一个Stream与一个io.Writer接口关联起来,Write方法会调用XORKeyStream方法来处理提供的所有切片。如果Write方法返回的n小于提供的切片的长度,则表示StreamWriter不同步,必须丢弃。StreamWriter没有内建的缓存,不需要调用Close方法去清空缓存。

func (StreamWriter) Write
func (w StreamWriter) Write(src []byte) (n int, err error)
func (StreamWriter) Close
func (w StreamWriter) Close() error

如果w.W字段实现了io.Closer接口,本方法会调用其Close方法并返回该方法的返回值;否则不做操作返回nil。

type AEAD

type AEAD interface {
    // 返回提供给Seal和Open方法的随机数nonce的字节长度
    NonceSize() int
    // 返回原始文本和加密文本的最大长度差异
    Overhead() int
    // 加密并认证明文,认证附加的data,将结果添加到dst,返回更新后的切片。
    // nonce的长度必须是NonceSize()字节,且对给定的key和时间都是独一无二的。
    // plaintext和dst可以是同一个切片,也可以不同。
    Seal(dst, nonce, plaintext, data []byte) []byte
    // 解密密文并认证,认证附加的data,如果认证成功,将明文添加到dst,返回更新后的切片。
    // nonce的长度必须是NonceSize()字节,nonce和data都必须和加密时使用的相同。
    // ciphertext和dst可以是同一个切片,也可以不同。
    Open(dst, nonce, ciphertext, data []byte) ([]byte, error)
}

AEAD接口是一种提供了使用关联数据进行认证加密的功能的加密模式。

func NewGCM
func NewGCM(cipher Block) (AEAD, error)

函数用迦洛瓦计数器模式包装提供的128位Block接口,并返回AEAD接口。


参考资料:

Go语言中文文档

http://www.golang.ltd/

Go语言官方文档

https://golang.google.cn/

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2021-02-25,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 Golang语言情怀 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • type Block
  • type BlockMode
    • func NewCBCEncrypter
      • func NewCBCDecrypter
      • type Stream
        • func NewCFBEncrypter
          • func NewCFBDecrypter
            • func NewOFB
              • func NewCTR
              • type StreamReader
                • func (StreamReader) Read
                • type StreamWriter
                  • func (StreamWriter) Write
                    • func (StreamWriter) Close
                    • type AEAD
                      • func NewGCM
                      领券
                      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档