HsOpenSSL-0.11.7.4: Partial OpenSSL binding for Haskell
Safe HaskellSafe-Inferred
LanguageHaskell2010

OpenSSL.DSA

Description

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

Synopsis

Type

class DSAKey k where Source #

DSAKey a is either DSAPubKey or DSAKeyPair.

Minimal complete definition

withDSAPtr, peekDSAPtr, absorbDSAPtr

Methods

dsaSize :: k -> Int Source #

Return the length of key.

dsaP :: k -> Integer Source #

Return the public prime number of the key.

dsaQ :: k -> Integer Source #

Return the public 160-bit subprime, q | p - 1 of the key.

dsaG :: k -> Integer Source #

Return the public generator of subgroup of the key.

dsaPublic :: k -> Integer Source #

Return the public key y = g^x.

withDSAPtr :: k -> (Ptr DSA -> IO a) -> IO a Source #

peekDSAPtr :: Ptr DSA -> IO (Maybe k) Source #

absorbDSAPtr :: Ptr DSA -> IO (Maybe k) Source #

Instances

Instances details
DSAKey DSAKeyPair Source # 
Instance details

Defined in OpenSSL.DSA

Methods

dsaSize :: DSAKeyPair -> Int Source #

dsaP :: DSAKeyPair -> Integer Source #

dsaQ :: DSAKeyPair -> Integer Source #

dsaG :: DSAKeyPair -> Integer Source #

dsaPublic :: DSAKeyPair -> Integer Source #

withDSAPtr :: DSAKeyPair -> (Ptr DSA -> IO a) -> IO a Source #

peekDSAPtr :: Ptr DSA -> IO (Maybe DSAKeyPair) Source #

absorbDSAPtr :: Ptr DSA -> IO (Maybe DSAKeyPair) Source #

DSAKey DSAPubKey Source # 
Instance details

Defined in OpenSSL.DSA

Methods

dsaSize :: DSAPubKey -> Int Source #

dsaP :: DSAPubKey -> Integer Source #

dsaQ :: DSAPubKey -> Integer Source #

dsaG :: DSAPubKey -> Integer Source #

dsaPublic :: DSAPubKey -> Integer Source #

withDSAPtr :: DSAPubKey -> (Ptr DSA -> IO a) -> IO a Source #

peekDSAPtr :: Ptr DSA -> IO (Maybe DSAPubKey) Source #

absorbDSAPtr :: Ptr DSA -> IO (Maybe DSAPubKey) Source #

data DSAPubKey Source #

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

Instances

Instances details
DSAKey DSAPubKey Source # 
Instance details

Defined in OpenSSL.DSA

Methods

dsaSize :: DSAPubKey -> Int Source #

dsaP :: DSAPubKey -> Integer Source #

dsaQ :: DSAPubKey -> Integer Source #

dsaG :: DSAPubKey -> Integer Source #

dsaPublic :: DSAPubKey -> Integer Source #

withDSAPtr :: DSAPubKey -> (Ptr DSA -> IO a) -> IO a Source #

peekDSAPtr :: Ptr DSA -> IO (Maybe DSAPubKey) Source #

absorbDSAPtr :: Ptr DSA -> IO (Maybe DSAPubKey) Source #

PKey DSAPubKey Source # 
Instance details

Defined in OpenSSL.EVP.PKey

PublicKey DSAPubKey Source # 
Instance details

Defined in OpenSSL.EVP.PKey

Show DSAPubKey Source # 
Instance details

Defined in OpenSSL.DSA

Methods

showsPrec :: Int -> DSAPubKey -> ShowS

show :: DSAPubKey -> String

showList :: [DSAPubKey] -> ShowS

Eq DSAPubKey Source # 
Instance details

Defined in OpenSSL.DSA

Methods

(==) :: DSAPubKey -> DSAPubKey -> Bool

(/=) :: DSAPubKey -> DSAPubKey -> Bool

Ord DSAPubKey Source # 
Instance details

Defined in OpenSSL.DSA

Methods

compare :: DSAPubKey -> DSAPubKey -> Ordering

(<) :: DSAPubKey -> DSAPubKey -> Bool

(<=) :: DSAPubKey -> DSAPubKey -> Bool

(>) :: DSAPubKey -> DSAPubKey -> Bool

(>=) :: DSAPubKey -> DSAPubKey -> Bool

max :: DSAPubKey -> DSAPubKey -> DSAPubKey

min :: DSAPubKey -> DSAPubKey -> DSAPubKey

data DSAKeyPair Source #

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

Instances

Instances details
DSAKey DSAKeyPair Source # 
Instance details

Defined in OpenSSL.DSA

Methods

dsaSize :: DSAKeyPair -> Int Source #

dsaP :: DSAKeyPair -> Integer Source #

dsaQ :: DSAKeyPair -> Integer Source #

dsaG :: DSAKeyPair -> Integer Source #

dsaPublic :: DSAKeyPair -> Integer Source #

withDSAPtr :: DSAKeyPair -> (Ptr DSA -> IO a) -> IO a Source #

peekDSAPtr :: Ptr DSA -> IO (Maybe DSAKeyPair) Source #

absorbDSAPtr :: Ptr DSA -> IO (Maybe DSAKeyPair) Source #

PKey DSAKeyPair Source # 
Instance details

Defined in OpenSSL.EVP.PKey

KeyPair DSAKeyPair Source # 
Instance details

Defined in OpenSSL.EVP.PKey

PublicKey DSAKeyPair Source # 
Instance details

Defined in OpenSSL.EVP.PKey

Show DSAKeyPair Source # 
Instance details

Defined in OpenSSL.DSA

Methods

showsPrec :: Int -> DSAKeyPair -> ShowS

show :: DSAKeyPair -> String

showList :: [DSAKeyPair] -> ShowS

Eq DSAKeyPair Source # 
Instance details

Defined in OpenSSL.DSA

Methods

(==) :: DSAKeyPair -> DSAKeyPair -> Bool

(/=) :: DSAKeyPair -> DSAKeyPair -> Bool

Ord DSAKeyPair Source # 
Instance details

Defined in OpenSSL.DSA

Key and parameter generation

generateDSAParameters Source #

Arguments

:: 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)

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

generateDSAKey Source #

Arguments

:: Integer

p

-> Integer

q

-> Integer

g

-> IO DSAKeyPair 

Generate a new DSA keypair, given valid parameters

generateDSAParametersAndKey Source #

Arguments

:: Int

The number of bits in the generated prime: 512 <= x <= 1024

-> Maybe ByteString

optional seed, its length must be 20 bytes

-> IO DSAKeyPair 

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

signDigestedDataWithDSA :: 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

verifyDigestedDataWithDSA :: DSAKey k => k -> ByteString -> (Integer, Integer) -> IO Bool Source #

Verify pre-digested data given a signature.

Extracting fields of DSA objects

dsaPrivate :: DSAKeyPair -> Integer Source #

Return the private key x.

dsaPubKeyToTuple :: DSAKeyPair -> (Integer, Integer, Integer, Integer) Source #

Convert a DSAPubKey object to a tuple of its members in the order p, q, g, and public.

dsaKeyPairToTuple :: DSAKeyPair -> (Integer, Integer, Integer, Integer, Integer) Source #

Convert a DSAKeyPair object to a tuple of its members in the order p, q, g, public and private.

tupleToDSAPubKey :: (Integer, Integer, Integer, Integer) -> DSAPubKey Source #

Convert a tuple of members (in the same format as from dsaPubKeyToTuple) into a DSAPubKey object

tupleToDSAKeyPair :: (Integer, Integer, Integer, Integer, Integer) -> DSAKeyPair Source #

Convert a tuple of members (in the same format as from dsaPubKeyToTuple) into a DSAPubKey object