Copyright | (c) 2013 Stefan Bühler |
---|---|
License | MIT-style (see the file COPYING) |
Maintainer | stbuehler@web.de |
Stability | experimental |
Portability | portable |
Safe Haskell | None |
Language | Haskell98 |
Crypto.Nettle.Hash
Description
This module exports hash algorithms supported by nettle: http://www.lysator.liu.se/~nisse/nettle/
Synopsis
- class HashAlgorithm a where
- hashBlockSize :: Tagged a Int
- hashDigestSize :: Tagged a Int
- hashName :: Tagged a String
- hashInit :: a
- hashUpdate :: a -> ByteString -> a
- hashUpdateLazy :: a -> ByteString -> a
- hashFinalize :: a -> ByteString
- hashHMAC :: ByteString -> Tagged a KeyedHash
- hash :: HashAlgorithm a => ByteString -> Tagged a ByteString
- hash' :: HashAlgorithm a => a -> ByteString -> ByteString
- hashLazy :: HashAlgorithm a => ByteString -> Tagged a ByteString
- hashLazy' :: HashAlgorithm a => a -> ByteString -> ByteString
- data GOSTHASH94
- data MD2
- data MD4
- data MD5
- data RIPEMD160
- data SHA1
- data SHA224
- data SHA256
- data SHA384
- data SHA512
- data SHA3_224
- data SHA3_256
- data SHA3_384
- data SHA3_512
HashAlgorithm class
class HashAlgorithm a where Source #
HashAlgorithm
is a class that hash algorithms will implement. generating a digest is a 3 step procedure:
hashInit
to create a new contexthashUpdate
to hash datahashFinalize
to extract the final digest
The final digest has hashDigestSize
bytes, and the algorithm uses hashBlockSize
as internal block size.
Minimal complete definition
hashBlockSize, hashDigestSize, hashName, hashInit, hashUpdate, hashFinalize
Methods
hashBlockSize :: Tagged a Int Source #
Block size in bytes the hash algorithm operates on
hashDigestSize :: Tagged a Int Source #
Digest size in bytes the hash algorithm returns
hashName :: Tagged a String Source #
Name of the hash algorithm
Initialize a new context for this hash algorithm
hashUpdate :: a -> ByteString -> a Source #
Update the context with bytestring, and return a new context with the updates.
hashUpdateLazy :: a -> ByteString -> a Source #
Update the context with a lazy bytestring, and return a new context with the updates.
hashFinalize :: a -> ByteString Source #
Finalize a context and return a digest.
hashHMAC :: ByteString -> Tagged a KeyedHash Source #
Use HashAlgorithm
for HMAC; can use a optimized variant or the default hmacInit
one
Instances
hash :: HashAlgorithm a => ByteString -> Tagged a ByteString Source #
Helper to hash a single (strict) ByteString
in one step.
Example:
untag (hash (fromString "abc") :: Tagged SHA256 B.ByteString)
hash' :: HashAlgorithm a => a -> ByteString -> ByteString Source #
Untagged variant of hash
; takes a (possible undefined
) typed HashAlgorithm
context as parameter.
Example:
hash' (undefined :: SHA256) $ fromString "abc"
hashLazy :: HashAlgorithm a => ByteString -> Tagged a ByteString Source #
Helper to hash a single (lazy) ByteString
in one step.
Example:
untag (hashLazy (fromString "abc") :: Tagged SHA256 L.ByteString)
hashLazy' :: HashAlgorithm a => a -> ByteString -> ByteString Source #
Untagged variant of hashLazy
; takes a (possible undefined
) typed HashAlgorithm
context as parameter.
Example:
hashLazy' (undefined :: SHA256) $ fromString "abc"
hash algorithms
Only members of the SHA2 and SHA3 family have no known weaknesses (according to http://www.lysator.liu.se/~nisse/nettle/nettle.html#Hash-functions)
GOSTHASH94
data GOSTHASH94 Source #
The GOST94 or GOST R 34.11-94 hash algorithm is a Soviet-era algorithm used in Russian government standards (see RFC 4357). It outputs message digests of 32 bytes (256 bits).
Instances
HashAlgorithm GOSTHASH94 Source # | |
Defined in Crypto.Nettle.Hash Methods hashBlockSize :: Tagged GOSTHASH94 Int Source # hashDigestSize :: Tagged GOSTHASH94 Int Source # hashName :: Tagged GOSTHASH94 String Source # hashInit :: GOSTHASH94 Source # hashUpdate :: GOSTHASH94 -> ByteString -> GOSTHASH94 Source # hashUpdateLazy :: GOSTHASH94 -> ByteString -> GOSTHASH94 Source # hashFinalize :: GOSTHASH94 -> ByteString Source # hashHMAC :: ByteString -> Tagged GOSTHASH94 KeyedHash Source # |
MD family
MD2
is a hash function of Ronald Rivest's, described in RFC 1319. It outputs message digests of 16 bytes (128 bits).
Instances
HashAlgorithm MD2 Source # | |
Defined in Crypto.Nettle.Hash |
MD4
is a hash function of Ronald Rivest's, described in RFC 1320. It outputs message digests of 16 bytes (128 bits).
Instances
HashAlgorithm MD4 Source # | |
Defined in Crypto.Nettle.Hash |
MD5
is a hash function of Ronald Rivest's, described in RFC 1321. It outputs message digests of 16 bytes (128 bits).
Instances
HashAlgorithm MD5 Source # | |
Defined in Crypto.Nettle.Hash |
RIPEMD160
RIPEMD160
is a hash function designed by Hans Dobbertin, Antoon Bosselaers, and Bart Preneel, as a strengthened version of RIPEMD.
It produces message digests of 20 bytes (160 bits).
Instances
HashAlgorithm RIPEMD160 Source # | |
Defined in Crypto.Nettle.Hash Methods hashBlockSize :: Tagged RIPEMD160 Int Source # hashDigestSize :: Tagged RIPEMD160 Int Source # hashName :: Tagged RIPEMD160 String Source # hashInit :: RIPEMD160 Source # hashUpdate :: RIPEMD160 -> ByteString -> RIPEMD160 Source # hashUpdateLazy :: RIPEMD160 -> ByteString -> RIPEMD160 Source # hashFinalize :: RIPEMD160 -> ByteString Source # hashHMAC :: ByteString -> Tagged RIPEMD160 KeyedHash Source # |
SHA1
SHA1
is a hash function specified by NIST (The U.S. National Institute for Standards and Technology).
It produces message digests of 20 bytes (160 bits).
Instances
HashAlgorithm SHA1 Source # | |
Defined in Crypto.Nettle.Hash |
SHA2 family
The SHA2 family supports digests lengths of 28, 32, 48 or 64 bytes (224, 256, 384, 512 bits), and the variants are named after the bit length.
The SHA2 family of hash functions were specified by NIST, intended as a replacement for SHA1
.
SHA224
is a member of the SHA2 family which outputs messages digests of 28 bytes (224 bits).
Instances
HashAlgorithm SHA224 Source # | |
Defined in Crypto.Nettle.Hash |
SHA256
is a member of the SHA2 family which outputs messages digests of 32 bytes (256 bits).
Instances
HashAlgorithm SHA256 Source # | |
Defined in Crypto.Nettle.Hash |
SHA384
is a member of the SHA2 family which outputs messages digests of 48 bytes (384 bits).
Instances
HashAlgorithm SHA384 Source # | |
Defined in Crypto.Nettle.Hash |
SHA512
is a member of the SHA2 family which outputs messages digests of 64 bytes (512 bits).
Instances
HashAlgorithm SHA512 Source # | |
Defined in Crypto.Nettle.Hash |
SHA3 family
The SHA3 family supports (like SHA2) digests lengths of 28, 32, 48 or 64 bytes (224, 256, 384, 512 bits), and the variants are named after the bit length.
The SHA3 hash functions were specified by NIST in response to weaknesses in SHA1, and doubts about SHA2 hash functions which structurally are very similar to SHA1. The standard is a result of a competition, where the winner, also known as Keccak, was designed by Guido Bertoni, Joan Daemen, Michaël Peeters and Gilles Van Assche. It is structurally very different from all widely used earlier hash functions.
SHA3_224
is a member of the SHA3 family which outputs messages digests of 28 bytes (224 bits).
Instances
HashAlgorithm SHA3_224 Source # | |
Defined in Crypto.Nettle.Hash Methods hashBlockSize :: Tagged SHA3_224 Int Source # hashDigestSize :: Tagged SHA3_224 Int Source # hashName :: Tagged SHA3_224 String Source # hashUpdate :: SHA3_224 -> ByteString -> SHA3_224 Source # hashUpdateLazy :: SHA3_224 -> ByteString -> SHA3_224 Source # hashFinalize :: SHA3_224 -> ByteString Source # hashHMAC :: ByteString -> Tagged SHA3_224 KeyedHash Source # |
SHA3_256
is a member of the SHA3 family which outputs messages digests of 32 bytes (256 bits).
Instances
HashAlgorithm SHA3_256 Source # | |
Defined in Crypto.Nettle.Hash Methods hashBlockSize :: Tagged SHA3_256 Int Source # hashDigestSize :: Tagged SHA3_256 Int Source # hashName :: Tagged SHA3_256 String Source # hashUpdate :: SHA3_256 -> ByteString -> SHA3_256 Source # hashUpdateLazy :: SHA3_256 -> ByteString -> SHA3_256 Source # hashFinalize :: SHA3_256 -> ByteString Source # hashHMAC :: ByteString -> Tagged SHA3_256 KeyedHash Source # |
SHA3_384
is a member of the SHA3 family which outputs messages digests of 48 bytes (384 bits).
Instances
HashAlgorithm SHA3_384 Source # | |
Defined in Crypto.Nettle.Hash Methods hashBlockSize :: Tagged SHA3_384 Int Source # hashDigestSize :: Tagged SHA3_384 Int Source # hashName :: Tagged SHA3_384 String Source # hashUpdate :: SHA3_384 -> ByteString -> SHA3_384 Source # hashUpdateLazy :: SHA3_384 -> ByteString -> SHA3_384 Source # hashFinalize :: SHA3_384 -> ByteString Source # hashHMAC :: ByteString -> Tagged SHA3_384 KeyedHash Source # |
SHA3_512
is a member of the SHA3 family which outputs messages digests of 64 bytes (512 bits).
Instances
HashAlgorithm SHA3_512 Source # | |
Defined in Crypto.Nettle.Hash Methods hashBlockSize :: Tagged SHA3_512 Int Source # hashDigestSize :: Tagged SHA3_512 Int Source # hashName :: Tagged SHA3_512 String Source # hashUpdate :: SHA3_512 -> ByteString -> SHA3_512 Source # hashUpdateLazy :: SHA3_512 -> ByteString -> SHA3_512 Source # hashFinalize :: SHA3_512 -> ByteString Source # hashHMAC :: ByteString -> Tagged SHA3_512 KeyedHash Source # |