?
This document uses PHP Chinese website manual Release
import "crypto/dsa"
概述
索引
概述
軟件包dsa 實(shí)現(xiàn)了 FIPS 186-3 中定義的數(shù)字簽名算法。
此包中的 DSA 操作不是使用恒定時(shí)間算法實(shí)現(xiàn)的。
索引
Variables
func GenerateKey(priv *PrivateKey, rand io.Reader) error
func GenerateParameters(params *Parameters, rand io.Reader, sizes ParameterSizes) 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
type ParameterSizes
type Parameters
type PrivateKey
type PublicKey
文件包
dsa.go
變量
ErrInvalidPublicKey 結(jié)果是公鑰不可用于此代碼。FIPS 對(duì) DSA 密鑰的格式非常嚴(yán)格，但其他代碼可能不那么重要。因此，當(dāng)使用可能由其他代碼生成的密鑰時(shí)，必須處理該錯(cuò)誤。
var ErrInvalidPublicKey = errors.New("crypto/dsa: invalid public key")func GenerateKey
func GenerateKey(priv *PrivateKey, rand io.Reader) error
GenerateKey 生成公鑰和私鑰對(duì)。PrivateKey 的參數(shù)必須已經(jīng)有效（請(qǐng)參閱 GenerateParameters）。
func GenerateParameters
func GenerateParameters(params *Parameters, rand io.Reader, sizes ParameterSizes) error
GenerateParameters 將一組隨機(jī)有效的 DSA 參數(shù)放入?yún)?shù)中。即使在快速機(jī)器上，此功能也可能需要幾秒鐘的時(shí)間。
func Sign
func Sign(rand io.Reader, priv *PrivateKey, hash []byte) (r, s *big.Int, err error)
Sign 使用私鑰 priv 來(lái)簽名任意長(zhǎng)度的散列（這應(yīng)該是散列較大的消息的結(jié)果）。它將簽名作為一對(duì)整數(shù)返回。私鑰的安全性取決于 rand 的熵。
請(qǐng)注意，F(xiàn)IPS 186-3 第4.6節(jié)指定散列應(yīng)該被截?cái)酁樽咏M的字節(jié)長(zhǎng)度。該函數(shù)本身不執(zhí)行截?cái)唷?/p>
請(qǐng)注意，使用 attacker-controlled 的 PrivateKey 調(diào)用 Sign 可能需要任意數(shù)量的 CPU。
func Verify
func Verify(pub *PublicKey, hash []byte, r, s *big.Int) bool
驗(yàn)證使用公共密鑰 pub，驗(yàn)證散列 r，s 中的簽名。它報(bào)告簽名是否有效。
請(qǐng)注意，F(xiàn)IPS 186-3 第4.6節(jié)指定散列應(yīng)該被截?cái)酁樽咏M的字節(jié)長(zhǎng)度。該函數(shù)本身不執(zhí)行截?cái)唷?/p>
type ParameterSizes
ParameterSizes 是一組 DSA 參數(shù)中素?cái)?shù)的可接受比特長(zhǎng)度的枚舉。參見(jiàn) FIPS 186-3，第4.2節(jié)。
type ParameterSizes int
const ( L1024N160 ParameterSizes = iota L2048N224 L2048N256 L3072N256)
type Parameters
參數(shù)表示密鑰的域參數(shù)。這些參數(shù)可以通過(guò)許多密鑰共享。Q 的位長(zhǎng)度必須是8的倍數(shù)。
type Parameters struct {
P, Q, G *big.Int}type PrivateKey
PrivateKey 代表 DSA 私鑰。
type PrivateKey struct {
PublicKey
X *big.Int}type PublicKey
PublicKey 代表 DSA 公鑰。
type PublicKey struct {
Parameters
Y *big.Int}