common

Documentation

Overview

Package common provides encryption methods common across encryption types

Index

• func GetChecksumHash(b, key []byte, usage uint32, etype etype.EType) ([]byte, error)
• func GetHash(pt, key []byte, usage []byte, etype etype.EType) ([]byte, error)
• func GetIntegrityHash(b, key []byte, usage uint32, etype etype.EType) ([]byte, error)
• func GetUsageKc(un uint32) []byte
• func GetUsageKe(un uint32) []byte
• func GetUsageKi(un uint32) []byte
• func IterationsToS2Kparams(i int) string
• func PKCS7Pad(b []byte, m int) ([]byte, error)
• func PKCS7Unpad(b []byte, m int) ([]byte, error)
• func S2KparamsToItertions(s2kparams string) (int, error)
• func VerifyChecksum(key, chksum, msg []byte, usage uint32, etype etype.EType) bool
• func ZeroPad(b []byte, m int) ([]byte, error)

Functions

func GetChecksumHash

func GetChecksumHash(b, key []byte, usage uint32, etype etype.EType) ([]byte, error)

GetChecksumHash returns a keyed checksum hash of the bytes provided.

func GetHash

func GetHash(pt, key []byte, usage []byte, etype etype.EType) ([]byte, error)

GetHash generates the keyed hash value according to the etype's hash function.

func GetIntegrityHash

func GetIntegrityHash(b, key []byte, usage uint32, etype etype.EType) ([]byte, error)

GetIntegrityHash returns a keyed integrity hash of the bytes provided.

func GetUsageKc

func GetUsageKc(un uint32) []byte

GetUsageKc returns the checksum key usage value for the usage number un.

RFC 3961: The "well-known constant" used for the DK function is the key usage number, expressed as four octets in big-endian order, followed by one octet indicated below.

Kc = DK(base-key, usage | 0x99);

func GetUsageKe

func GetUsageKe(un uint32) []byte

GetUsageKe returns the encryption key usage value for the usage number un

RFC 3961: The "well-known constant" used for the DK function is the key usage number, expressed as four octets in big-endian order, followed by one octet indicated below.

Ke = DK(base-key, usage | 0xAA);

func GetUsageKi

func GetUsageKi(un uint32) []byte

GetUsageKi returns the integrity key usage value for the usage number un

RFC 3961: The "well-known constant" used for the DK function is the key usage number, expressed as four octets in big-endian order, followed by one octet indicated below.

Ki = DK(base-key, usage | 0x55);

func IterationsToS2Kparams

func IterationsToS2Kparams(i int) string

IterationsToS2Kparams converts the number of iterations as an integer to a string representation.

func PKCS7Pad

func PKCS7Pad(b []byte, m int) ([]byte, error)

PKCS7Pad pads bytes according to RFC 2315 to nearest multiple of message size m.

func PKCS7Unpad

func PKCS7Unpad(b []byte, m int) ([]byte, error)

PKCS7Unpad removes RFC 2315 padding from byes where message size is m.

func S2KparamsToItertions

func S2KparamsToItertions(s2kparams string) (int, error)

S2KparamsToItertions converts the string representation of iterations to an integer

func VerifyChecksum

func VerifyChecksum(key, chksum, msg []byte, usage uint32, etype etype.EType) bool

VerifyChecksum compares the checksum of the msg bytes is the same as the checksum provided.

func ZeroPad

func ZeroPad(b []byte, m int) ([]byte, error)

ZeroPad pads bytes with zeros to nearest multiple of message size m.