Пакет crypto

• import "crypto"
• Обзор
• Индекс
• Подкаталоги

Обзор

Пакет crypto собирает общие криптографические константы.

Индекс

• func RegisterHash(h Hash, f func() hash.Hash)
• тип Decrypter
• тип DecrypterOpts
• тип Hash
• func (h Hash) Available() bool
• func (h Hash) HashFunc() Hash
• func (h Hash) New() hash.Hash
• func (h Hash) Size() int
• func (h Hash) String() string
• тип PrivateKey
• тип PublicKey
• тип Signer
• тип SignerOpts

Файлы пакета

crypto.go

func RegisterHash

func RegisterHash(h Hash, f func() hash.Hash)

RegisterHash регистрирует функцию, возвращающую новый экземпляр заданной хеш-функции. Это предназначено для вызова из функции init в пакетах, реализующих хеш-функции.

тип Decrypter 1.5

Decrypter — интерфейс для неявного закрытого ключа, который можно использовать для асимметричных операций дешифрования. Примером может служить ключ RSA, хранящийся в аппаратном модуле.

type Decrypter interface {
    // Public returns the public key corresponding to the opaque,
    // private key.
    Public() PublicKey

    // Decrypt decrypts msg. The opts argument should be appropriate for
    // the primitive used. See the documentation in each implementation for
    // details.
    Decrypt(rand io.Reader, msg []byte, opts DecrypterOpts) (plaintext []byte, err error)
}

тип DecrypterOpts 1.5

type DecrypterOpts any

тип Hash

Hash идентифицирует криптографическую хеш-функцию, реализованную в другом пакете.

type Hash uint

const (
    MD4         Hash = 1 + iota // import golang.org/x/crypto/md4
    MD5                         // import crypto/md5
    SHA1                        // import crypto/sha1
    SHA224                      // import crypto/sha256
    SHA256                      // import crypto/sha256
    SHA384                      // import crypto/sha512
    SHA512                      // import crypto/sha512
    MD5SHA1                     // no implementation; MD5+SHA1 used for TLS RSA
    RIPEMD160                   // import golang.org/x/crypto/ripemd160
    SHA3_224                    // import golang.org/x/crypto/sha3
    SHA3_256                    // import golang.org/x/crypto/sha3
    SHA3_384                    // import golang.org/x/crypto/sha3
    SHA3_512                    // import golang.org/x/crypto/sha3
    SHA512_224                  // import crypto/sha512
    SHA512_256                  // import crypto/sha512
    BLAKE2s_256                 // import golang.org/x/crypto/blake2s
    BLAKE2b_256                 // import golang.org/x/crypto/blake2b
    BLAKE2b_384                 // import golang.org/x/crypto/blake2b
    BLAKE2b_512                 // import golang.org/x/crypto/blake2b

)

func (Hash) Available

func (h Hash) Available() bool

Available сообщает, подключена ли заданная хеш-функция к бинарному файлу.

func (Hash) HashFunc 1.4

func (h Hash) HashFunc() Hash

HashFunc просто возвращает значение h, чтобы Hash реализовывал SignerOpts.

func (Hash) New

func (h Hash) New() hash.Hash

New возвращает новый hash.Hash, вычисляющий заданную хеш-функцию. New генерирует ошибку, если хеш-функция не подключена к бинарному файлу.

func (Hash) Size

func (h Hash) Size() int

Size возвращает длину в байтах дайджеста, полученного от заданной хеш-функции. Она не требует, чтобы хеш-функция была подключена к программе.

func (Hash) String 1.15

func (h Hash) String() string

тип PrivateKey

PrivateKey представляет закрытый ключ, использующий неопределённый алгоритм.

Хотя этот тип является пустым интерфейсом по соображениям обратной совместимости, все типы закрытых ключей в стандартной библиотеке реализуют следующий интерфейс

interface{
    Public() crypto.PublicKey
    Equal(x crypto.PrivateKey) bool
}

а также интерфейсы, специфичные для цели, такие как Signer и Decrypter, которые могут быть использованы для повышения типа безопасности в приложениях.

type PrivateKey any

тип PublicKey 1.2

PublicKey представляет открытый ключ, использующий неопределённый алгоритм.

Хотя этот тип является пустым интерфейсом по соображениям обратной совместимости, все типы открытых ключей в стандартной библиотеке реализуют следующий интерфейс

interface{
    Equal(x crypto.PublicKey) bool
}

который может быть использован для повышения типа безопасности в приложениях.

type PublicKey any

тип Signer 1.4

Signer — интерфейс для неявного закрытого ключа, который может быть использован для операций подписи. Например, ключ RSA, хранящийся в аппаратном модуле.

type Signer interface {
    // Public returns the public key corresponding to the opaque,
    // private key.
    Public() PublicKey

    // Sign signs digest with the private key, possibly using entropy from
    // rand. For an RSA key, the resulting signature should be either a
    // PKCS #1 v1.5 or PSS signature (as indicated by opts). For an (EC)DSA
    // key, it should be a DER-serialised, ASN.1 signature structure.
    //
    // Hash implements the SignerOpts interface and, in most cases, one can
    // simply pass in the hash function used as opts. Sign may also attempt
    // to type assert opts to other types in order to obtain algorithm
    // specific values. See the documentation in each package for details.
    //
    // Note that when a signature of a hash of a larger message is needed,
    // the caller is responsible for hashing the larger message and passing
    // the hash (as digest) and the hash function (as opts) to Sign.
    Sign(rand io.Reader, digest []byte, opts SignerOpts) (signature []byte, err error)
}

тип SignerOpts 1.4

SignerOpts содержит параметры для подписи с помощью Signer.

type SignerOpts interface {
    // HashFunc returns an identifier for the hash function used to produce
    // the message passed to Signer.Sign, or else zero to indicate that no
    // hashing was done.
    HashFunc() Hash
}

Подкаталоги