| 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:
hashInitto create a new contexthashUpdateto hash datahashFinalizeto 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 # | |