| Safe Haskell | Safe-Inferred |
|---|
Data.Digest.Pure.SHA
Contents
Description
Pure implementations of the SHA suite of hash functions. The implementation is basically an unoptimized translation of FIPS 180-2 into Haskell. If you're looking for performance, you probably won't find it here.
- data Digest t
- data SHA1State
- data SHA256State
- data SHA512State
- showDigest :: Digest t -> String
- integerDigest :: Digest t -> Integer
- bytestringDigest :: Digest t -> ByteString
- sha1 :: ByteString -> Digest SHA1State
- sha224 :: ByteString -> Digest SHA256State
- sha256 :: ByteString -> Digest SHA256State
- sha384 :: ByteString -> Digest SHA512State
- sha512 :: ByteString -> Digest SHA512State
- hmacSha1 :: ByteString -> ByteString -> Digest SHA1State
- hmacSha224 :: ByteString -> ByteString -> Digest SHA256State
- hmacSha256 :: ByteString -> ByteString -> Digest SHA256State
- hmacSha384 :: ByteString -> ByteString -> Digest SHA512State
- hmacSha512 :: ByteString -> ByteString -> Digest SHA512State
Digest and related functions
An abstract datatype for digests.
data SHA256State Source
Instances
data SHA512State Source
Instances
showDigest :: Digest t -> StringSource
Convert a digest to a string. The digest is rendered as fixed with hexadecimal number.
integerDigest :: Digest t -> IntegerSource
Convert a digest to an Integer.
bytestringDigest :: Digest t -> ByteStringSource
Convert a digest to a ByteString.
Calculating hashes
sha1 :: ByteString -> Digest SHA1StateSource
Compute the SHA-1 hash of the given ByteString. The output is guaranteed to be exactly 160 bits, or 20 bytes, long. This is a good default for programs that need a good, but not necessarily hyper-secure, hash function.
sha224 :: ByteString -> Digest SHA256StateSource
Compute the SHA-224 hash of the given ByteString. Note that SHA-224 and SHA-384 differ only slightly from SHA-256 and SHA-512, and use truncated versions of the resulting hashes. So using 224/384 may not, in fact, save you very much ...
sha256 :: ByteString -> Digest SHA256StateSource
Compute the SHA-256 hash of the given ByteString. The output is guaranteed to be exactly 256 bits, or 32 bytes, long. If your security requirements are pretty serious, this is a good choice. For truly significant security concerns, however, you might try one of the bigger options.
sha384 :: ByteString -> Digest SHA512StateSource
Compute the SHA-384 hash of the given ByteString. Yup, you guessed it, the output will be exactly 384 bits, or 48 bytes, long.
sha512 :: ByteString -> Digest SHA512StateSource
For those for whom only the biggest hashes will do, this computes the SHA-512 hash of the given ByteString. The output will be 64 bytes, or 512 bits, long.
Calculating message authentication codes (MACs)
Arguments
| :: ByteString | secret key |
| -> ByteString | message |
| -> Digest SHA1State | SHA-1 MAC |
Compute an HMAC using SHA-1.
Arguments
| :: ByteString | secret key |
| -> ByteString | message |
| -> Digest SHA256State | SHA-224 MAC |
Compute an HMAC using SHA-224.
Arguments
| :: ByteString | secret key |
| -> ByteString | message |
| -> Digest SHA256State | SHA-256 MAC |
Compute an HMAC using SHA-256.
Arguments
| :: ByteString | secret key |
| -> ByteString | message |
| -> Digest SHA512State | SHA-384 MAC |
Compute an HMAC using SHA-384.
Arguments
| :: ByteString | secret key |
| -> ByteString | message |
| -> Digest SHA512State | SHA-512 MAC |
Compute an HMAC using SHA-512.