Safe Haskell	None

OpenSSL.RSA

Contents

Type
Generating keypair
Exploring keypair

Description

An interface to RSA public key generator.

Synopsis

Type

class RSAKey k whereSource

RSAKey a is either RSAPubKey or RSAKeyPair.

Methods

rsaSize :: k -> Int Source

rsaSize key returns the length of key.

rsaN :: k -> Integer Source

rsaN key returns the public modulus of the key.

rsaE :: k -> Integer Source

rsaE key returns the public exponent of the key.

withRSAPtr :: k -> (Ptr RSA -> IO a) -> IO aSource

peekRSAPtr :: Ptr RSA -> IO (Maybe k)Source

absorbRSAPtr :: Ptr RSA -> IO (Maybe k)Source

Instances

RSAKey RSAKeyPair
RSAKey RSAPubKey

data RSAPubKey Source

RSAPubKey is an opaque object that represents RSA public key.

Instances

Eq RSAPubKey
Ord RSAPubKey
Show RSAPubKey
Typeable RSAPubKey
PKey RSAPubKey
RSAKey RSAPubKey
PublicKey RSAPubKey

data RSAKeyPair Source

RSAKeyPair is an opaque object that represents RSA keypair.

Instances

Eq RSAKeyPair
Ord RSAKeyPair
Show RSAKeyPair
Typeable RSAKeyPair
PKey RSAKeyPair
RSAKey RSAKeyPair
KeyPair RSAKeyPair
PublicKey RSAKeyPair

Generating keypair

type RSAGenKeyCallback = Int -> Int -> IO ()Source

RSAGenKeyCallback represents a callback function to get informed the progress of RSA key generation.

callback 0 i is called after generating the i-th potential prime number.
While the number is being tested for primality, callback 1 j is called after the j-th iteration (j = 0, 1, ...).
When the n-th randomly generated prime is rejected as not suitable for the key, callback 2 n is called.
When a random p has been found with p-1 relatively prime to e, it is called as callback 3 0.
The process is then repeated for prime q with callback 3 1.

generateRSAKey Source

Arguments

:: Int	The number of bits of the public modulus (i.e. key size). Key sizes with `n < 1024` should be considered insecure.
-> Int	The public exponent. It is an odd number, typically 3, 17 or 65537.
-> Maybe RSAGenKeyCallback	A callback function.
-> IO RSAKeyPair	The generated keypair.

generateRSAKey generates an RSA keypair.

generateRSAKey'Source

Arguments

:: Int	The number of bits of the public modulus (i.e. key size). Key sizes with `n < 1024` should be considered insecure.
-> Int	The public exponent. It is an odd number, typically 3, 17 or 65537.
-> IO RSAKeyPair	The generated keypair.

A simplified alternative to generateRSAKey

Exploring keypair

rsaD :: RSAKeyPair -> Integer Source

rsaD privKey returns the private exponent of the key.

rsaP :: RSAKeyPair -> Integer Source

rsaP privkey returns the secret prime factor p of the key.

rsaQ :: RSAKeyPair -> Integer Source

rsaQ privkey returns the secret prime factor q of the key.

rsaDMP1 :: RSAKeyPair -> Maybe Integer Source

rsaDMP1 privkey returns d mod (p-1) of the key.

rsaDMQ1 :: RSAKeyPair -> Maybe Integer Source

rsaDMQ1 privkey returns d mod (q-1) of the key.

rsaIQMP :: RSAKeyPair -> Maybe Integer Source

rsaIQMP privkey returns q^-1 mod p of the key.

rsaCopyPublic :: RSAKey key => key -> IO RSAPubKey Source

Make a copy of the public parameters of the given key.