Crypto.Nettle.HMAC

Generic HMAC implementation based on the HashAlgorithm class, implementing the KeyedHashAlgorithm class.

Documentation

data HMAC a

HMAC is a generic KeyedHashAlgorithm instance to calculate the HMAC based on a HashAlgorithm

Instances

HashAlgorithm a => KeyedHashAlgorithm (HMAC a)

hmacInit

Arguments

:: HashAlgorithm a

=> ByteString

key argument

-> Tagged a KeyedHash

hmacInit is the default implementation for hashHMAC and initializes a KeyedHash to calculate the HMAC for a message with the given key.

Example:

 let c = untag (hmacInit (fromString "secretkey") :: Tagged SHA256 KeyedHash) in keyedHashFinalize $ keyedHashUpdate c (fromString "secret message")

hmacInit' :: HashAlgorithm a => a -> ByteString -> KeyedHash

Untagged variant of hmacInit; takes a (possible undefined) typed HashAlgorithm context as parameter.

Example:

 keyedHashFinalize $ flip keyedHashUpdate (fromString "secret message") $ hmacInit' (undefined :: SHA256) (fromString "secretkey")

hmac

Arguments

:: HashAlgorithm a

=> ByteString

key argument

-> ByteString

message argument

-> Tagged a ByteString

calculate HMAC with a HashAlgorithm for a key and message

Example:

 untag (hmac (fromString "secretkey") (fromString "secret message") :: Tagged SHA256 B.ByteString)

hmac' :: HashAlgorithm a => a -> ByteString -> ByteString -> ByteString

Untagged variant of hmac; takes a (possible undefined) typed HashAlgorithm context as parameter.

Example:

 hmac' (undefined :: SHA256) (fromString "secretkey") (fromString "secret message")

hmacLazy

Arguments

:: HashAlgorithm a

=> ByteString

key argument

-> ByteString

message argument

-> Tagged a ByteString

calculate HMAC with a HashAlgorithm for a key and lazy message

Example:

 untag (hmacLazy (fromString "secretkey") (fromString "secret message") :: Tagged SHA256 B.ByteString)

hmacLazy' :: HashAlgorithm a => a -> ByteString -> ByteString -> ByteString

Untagged variant of hmacLazy; takes a (possible undefined) typed HashAlgorithm context as parameter.

Example:

 hmacLazy' (undefined :: SHA256) (fromString "secretkey") (fromString "secret message")