Golang语言情怀-第58期 Go 语言标准库翻译 crypto/dsa
Golang语言情怀-第58期 Go 语言标准库翻译 crypto/dsa
李海彬
发布于 2021-03-09 11:03:08
发布于 2021-03-09 11:03:08
import "crypto/dsa"
dsa包实现FIPS 186-3定义的数字签名算法（Digital Signature Algorithm），即DSA算法。
Variables
type ParameterSizes
type Parameters
type PublicKey
type PrivateKey
func GenerateParameters(params *Parameters, rand io.Reader, sizes ParameterSizes) (err error)
func GenerateKey(priv *PrivateKey, rand io.Reader) error
func Sign(rand io.Reader, priv *PrivateKey, hash []byte) (r, s *big.Int, err error)
func Verify(pub *PublicKey, hash []byte, r, s *big.Int) bool
Variables
var ErrInvalidPublicKey = errors.New("crypto/dsa: invalid public key")
非法公钥，FIPS标准的公钥格式是很严格的，但有些实现没这么严格，使用这些实现的公钥时，就会导致这个错误。
type ParameterSizes
type ParameterSizes int
是DSA参数中的质数可以接受的字位长度的枚举，参见FIPS 186-3 section 4.2。
const (
L1024N160 ParameterSizes = iota
L2048N224
L2048N256
L3072N256
)
type Parameters
type Parameters struct {
P, Q, G *big.Int
}
Parameters代表密钥的域参数，这些参数可以被一组密钥共享，Q的字位长度必须是8的倍数。
type PublicKey
type PublicKey struct {
Parameters
Y *big.Int
}
PublicKey代表一个DSA公钥。
type PrivateKey
type PrivateKey struct {
PublicKey
X *big.Int
}
PrivateKey代表一个DSA私钥。
func GenerateKey
func GenerateParameters
func GenerateParameters(params *Parameters, rand io.Reader, sizes ParameterSizes) (err error)
GenerateParameters函数随机设置合法的参数到params。即使机器很快，函数也可能会花费很多时间来生成参数。
func GenerateKey(priv *PrivateKey, rand io.Reader) error
GenerateKey生成一对公钥和私钥；priv.PublicKey.Parameters字段必须已经（被GenerateParameters函数）设置了合法的参数。
func Sign
func Sign(rand io.Reader, priv *PrivateKey, hash []byte) (r, s *big.Int, err error)
使用私钥对任意长度的hash值（必须是较大信息的hash结果）进行签名，返回签名结果（一对大整数）。私钥的安全性取决于密码读取器的熵度（随机程度）。
注意根据FIPS 186-3 section 4.6的规定，hash必须被截断到亚组的长度，本函数是不会自己截断的。
func Verify
func Verify(pub *PublicKey, hash []byte, r, s *big.Int) bool
使用公钥认证hash和两个大整数r、s构成的签名，报告签名是否合法。
注意根据FIPS 186-3 section 4.6的规定，hash必须被截断到亚组的长度，本函数是不会自己截断的。
参考资料：
Go语言中文文档
http://www.golang.ltd/
Go语言官方文档
https://golang.google.cn/
本文参与 腾讯云自媒体分享计划，分享自微信公众号。
原始发表：2021-02-27，如有侵权请联系 cloudcommunity@tencent.com 删除
评论
登录后参与评论
推荐阅读