Skip to content

HORIZON HASKELL Docs lts/ghc-10.0.x8fef28d2026-11-02Search packagesCtrl K

Theme: |

GHC 10.0.0.20260917 · lts/ghc-10.0.x · 8fef28d · 2026-11-02

ModuleHsOpenSSL-0.11.7.11Haskell2010

OpenSSL.RSA

An interface to RSA public key generator.

Contents

Type
Generating keypair
Exploring keypair

Synopsis

class RSAKey
newtype RSAPubKey
newtype RSAKeyPair
data RSA
type RSAGenKeyCallback
value generateRSAKey
value generateRSAKey'
value rsaD
value rsaP
value rsaQ
value rsaDMP1
value rsaDMQ1
value rsaIQMP
value rsaCopyPublic
value rsaKeyPairFinalize

PackageHsOpenSSL-0.11.7.11
Exports15
LanguageHaskell2010
LicenceLicenseRef-PublicDomain
SourceRSA.hsc

Type

classclass RSAKey k where

RSAKey a is either RSAPubKey or RSAKeyPair.

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)

Instances2RSAKey

RSAKey RSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
RSAKey RSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA

newtypenewtype RSAPubKey

RSAPubKey is an opaque object that represents RSA public key.

Instances6Eq, Ord, Show, RSAKey, PKey, PublicKey

Eq RSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
Ord RSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
Show RSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
RSAKey RSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
PKey RSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey · orphan
PublicKey RSAPubKeyDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey

newtypenewtype RSAKeyPair

RSAKeyPair is an opaque object that represents RSA keypair.

Instances7Eq, Ord, Show, RSAKey, PKey, KeyPair, …

Eq RSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
Ord RSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
Show RSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
RSAKey RSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.RSA
PKey RSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey · orphan
KeyPair RSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey
PublicKey RSAKeyPairDefined in HsOpenSSL-0.11.7.11 · OpenSSL.EVP.PKey

datadata RSA

Generating keypair

typetype 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.

valuegenerateRSAKey

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

valuegenerateRSAKey'

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

valuersaD :: RSAKeyPair -> Integer

rsaD privKey returns the private exponent of the key.

valuersaP :: RSAKeyPair -> Integer

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

valuersaQ :: RSAKeyPair -> Integer

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

valuersaDMP1 :: RSAKeyPair -> Maybe Integer

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

valuersaDMQ1 :: RSAKeyPair -> Maybe Integer

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

valuersaIQMP :: RSAKeyPair -> Maybe Integer

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

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

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

valuersaKeyPairFinalize :: RSAKeyPair -> IO ()