HsOpenSSL-0.10.1.2: (Incomplete) OpenSSL binding for Haskell

OpenSSL.PEM

Contents

Description

An interface to PEM routines.

Synopsis

Password supply

type PemPasswordCallback = Int -> PemPasswordRWState -> IO StringSource

PemPasswordCallback represents a callback function to supply a password.

Int
The maximum length of the password to be accepted.
PemPasswordRWState
The context.
IO String
The resulting password.

data PemPasswordRWState Source

PemPasswordRWState represents a context of PemPasswordCallback.

Constructors

PwRead

The callback was called to get a password to read something encrypted.

PwWrite

The callback was called to get a password to encrypt something.

data PemPasswordSupply Source

PemPasswordSupply represents a way to supply password.

FIXME: using PwTTY causes an error but I don't know why: "error:0906406D:PEM routines:DEF_CALLBACK:problems getting password"

Constructors

PwNone

no password

PwStr String

password in a static string

PwBS ByteString

password in a static bytestring.

PwCallback PemPasswordCallback

get a password by a callback

PwTTY

read a password from TTY

Private key

writePKCS8PrivateKeySource

Arguments

:: KeyPair key 
=> key

private key to write

-> Maybe (Cipher, PemPasswordSupply)

Either (symmetric cipher algorithm, password supply) or Nothing. If Nothing is given the private key is not encrypted.

-> IO String

the result PEM string

writePKCS8PrivateKey writes a private key to PEM string in PKCS#8 format.

readPrivateKey :: String -> PemPasswordSupply -> IO SomeKeyPairSource

readPrivateKey pem supply reads a private key in PEM string.

Public key

writePublicKey :: PublicKey key => key -> IO StringSource

writePublicKey pubkey writes a public to PEM string.

readPublicKey :: String -> IO SomePublicKeySource

readPublicKey pem reads a public key in PEM string.

X.509 certificate

writeX509 :: X509 -> IO StringSource

writeX509 cert writes an X.509 certificate to PEM string.

readX509 :: String -> IO X509Source

readX509 pem reads an X.509 certificate in PEM string.

PKCS#10 certificate request

data PemX509ReqFormat Source

PemX509ReqFormat represents format of PKCS#10 certificate request.

Constructors

ReqNewFormat

The new format, whose header is "NEW CERTIFICATE REQUEST".

ReqOldFormat

The old format, whose header is "CERTIFICATE REQUEST".

writeX509ReqSource

Arguments

:: X509Req

request

-> PemX509ReqFormat

format

-> IO String

the result PEM string

writeX509Req writes a PKCS#10 certificate request to PEM string.

readX509Req :: String -> IO X509ReqSource

readX509Req reads a PKCS#10 certificate request in PEM string.

Certificate Revocation List

writeCRL :: CRL -> IO StringSource

writeCRL crl writes a Certificate Revocation List to PEM string.

readCRL :: String -> IO CRLSource

readCRL pem reads a Certificate Revocation List in PEM string.

PKCS#7 structure

writePkcs7 :: Pkcs7 -> IO StringSource

writePkcs7 p7 writes a PKCS#7 structure to PEM string.

readPkcs7 :: String -> IO Pkcs7Source

readPkcs7 pem reads a PKCS#7 structure in PEM string.

DH parameters

writeDHParams :: DHP -> IO StringSource

writeDHParams dh writes DH parameters to PEM string.

readDHParams :: String -> IO DHPSource

readDHParams pem reads DH parameters in PEM string.