OpenSSL.RSA

An interface to RSA public key generator.

Type

class RSAKey k where

RSAKey a is either RSAPubKey or RSAKeyPair.

Minimal complete definition

withRSAPtr, peekRSAPtr, absorbRSAPtr

Methods

rsaSize :: k -> Int

rsaSize key returns the length of key.

rsaN :: k -> Integer

rsaN key returns the public modulus of the key.

rsaE :: k -> Integer

rsaE key returns the public exponent of the key.

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

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

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

Instances

RSAKey RSAKeyPair

RSAKey RSAPubKey

data RSAPubKey

RSAPubKey is an opaque object that represents RSA public key.

Instances

Eq RSAPubKey

Ord RSAPubKey

Show RSAPubKey

PKey RSAPubKey

RSAKey RSAPubKey

PublicKey RSAPubKey

Typeable * RSAPubKey

data RSAKeyPair

RSAKeyPair is an opaque object that represents RSA keypair.

Instances

Eq RSAKeyPair

Ord RSAKeyPair

Show RSAKeyPair

PKey RSAKeyPair

RSAKey RSAKeyPair

KeyPair RSAKeyPair

PublicKey RSAKeyPair

Typeable * RSAKeyPair

Generating keypair

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

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

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'

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

rsaD privKey returns the private exponent of the key.

rsaP :: RSAKeyPair -> Integer

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

rsaQ :: RSAKeyPair -> Integer

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

rsaDMP1 :: RSAKeyPair -> Maybe Integer

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

rsaDMQ1 :: RSAKeyPair -> Maybe Integer

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

rsaIQMP :: RSAKeyPair -> Maybe Integer

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

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

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