ModuleHsOpenSSL-0.11.7.11Haskell2010

OpenSSL.DSA

The Digital Signature Algorithm (FIPS 186-2). See http://www.openssl.org/docs/crypto/dsa.html

Contents

Type
Key and parameter generation
Signing and verification
Extracting fields of DSA objects

Synopsis

class DSAKey
newtype DSAPubKey
newtype DSAKeyPair
data DSA
value generateDSAParameters
value generateDSAKey
value generateDSAParametersAndKey
value signDigestedDataWithDSA
value verifyDigestedDataWithDSA
value dsaPrivate
value dsaPubKeyToTuple
value dsaKeyPairToTuple
value tupleToDSAPubKey
value tupleToDSAKeyPair

PackageHsOpenSSL-0.11.7.11
Exports14
LanguageHaskell2010
LicenceLicenseRef-PublicDomain
SourceDSA.hsc

Type

classclass DSAKey k where

Source#

DSAKey a is either DSAPubKey or DSAKeyPair.

Methods

dsaSize :: k -> Int
Return the length of key.
dsaP :: k -> Integer
Return the public prime number of the key.
dsaQ :: k -> Integer
Return the public 160-bit subprime, q | p - 1 of the key.
dsaG :: k -> Integer
Return the public generator of subgroup of the key.
dsaPublic :: k -> Integer
Return the public key y = g^x.
withDSAPtr :: k -> (Ptr DSA -> IO a) -> IO a
peekDSAPtr :: Ptr DSA -> IO (Maybe k)
absorbDSAPtr :: Ptr DSA -> IO (Maybe k)

Instances2DSAKey

DSAKey DSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
DSAKey DSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA

newtypenewtype DSAPubKey

Source#

The type of a DSA public key, includes parameters p, q, g and public.

Instances6Eq, Ord, Show, DSAKey, PKey, PublicKey

Eq DSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
Ord DSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
Show DSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
DSAKey DSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
PKey DSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey · orphan
PublicKey DSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey

newtypenewtype DSAKeyPair

Source#

The type of a DSA keypair, includes parameters p, q, g, public and private.

Instances7Eq, Ord, Show, DSAKey, PKey, KeyPair, …

Eq DSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
Ord DSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
Show DSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
DSAKey DSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.DSA
PKey DSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey · orphan
KeyPair DSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey
PublicKey DSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey

datadata DSA

Key and parameter generation

valuegenerateDSAParameters

:: Int
The number of bits in the generated prime: 512 <= x <= 1024
-> Maybe ByteString
optional seed, its length must be 20 bytes
-> IO (Int, Int, Integer, Integer, Integer)
(iteration count, generator count, p, q, g)

Source#

Generate DSA parameters (*not* a key, but required for a key). This is a compute intensive operation. See FIPS 186-2, app 2. This agrees with the test vectors given in FIP 186-2, app 5

valuegenerateDSAKey

:: Integer
p
-> Integer
q
-> Integer
g
-> IO DSAKeyPair

Source#

Generate a new DSA keypair, given valid parameters

valuegenerateDSAParametersAndKey

:: Int
The number of bits in the generated prime: 512 <= x <= 1024
-> Maybe ByteString
optional seed, its length must be 20 bytes
-> IO DSAKeyPair

Source#

A utility function to generate both the parameters and the key pair at the same time. Saves serialising and deserialising the parameters too

Signing and verification

valuesignDigestedDataWithDSA :: DSAKeyPair -> ByteString -> IO (Integer, Integer)

Source#

Sign pre-digested data. The DSA specs call for SHA1 to be used so, if you use anything else, YMMV. Returns a pair of Integers which, together, are the signature

valueverifyDigestedDataWithDSA