HsOpenSSL-0.11.7.7: Partial OpenSSL binding for Haskell

Safe Haskell	Safe-Inferred
Language	Haskell2010

OpenSSL.PEM

Contents

Password supply
Private key
Public key
X.509 certificate
PKCS#10 certificate request
Certificate Revocation List
PKCS#7 structure
DH parameters

Description

An interface to PEM routines.

Synopsis

type PemPasswordCallback = Int -> PemPasswordRWState -> IO String
data PemPasswordRWState
- = PwRead
- | PwWrite
data PemPasswordSupply
- = PwNone
- | PwStr String
- | PwBS ByteString
- | PwCallback PemPasswordCallback
- | PwTTY
writePKCS8PrivateKey :: KeyPair key => key -> Maybe (Cipher, PemPasswordSupply) -> IO String
readPrivateKey :: String -> PemPasswordSupply -> IO SomeKeyPair
writePublicKey :: PublicKey key => key -> IO String
readPublicKey :: String -> IO SomePublicKey
writeX509 :: X509 -> IO String
readX509 :: String -> IO X509
data PemX509ReqFormat
- = ReqNewFormat
- | ReqOldFormat
writeX509Req :: X509Req -> PemX509ReqFormat -> IO String
readX509Req :: String -> IO X509Req
writeCRL :: CRL -> IO String
readCRL :: String -> IO CRL
writePkcs7 :: Pkcs7 -> IO String
readPkcs7 :: String -> IO Pkcs7
writeDHParams :: DHP -> IO String
readDHParams :: String -> IO DHP

Password supply

type PemPasswordCallback = Int -> PemPasswordRWState -> IO String Source #

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

writePKCS8PrivateKey Source #

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 SomeKeyPair Source #

readPrivateKey pem supply reads a private key in PEM string.

Public key

writePublicKey :: PublicKey key => key -> IO String Source #

writePublicKey pubkey writes a public to PEM string.

readPublicKey :: String -> IO SomePublicKey Source #

readPublicKey pem reads a public key in PEM string.

X.509 certificate

writeX509 :: X509 -> IO String Source #

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

readX509 :: String -> IO X509 Source #

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

writeX509Req Source #

Arguments

:: X509Req	request
-> PemX509ReqFormat	format
-> IO String	the result PEM string

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

readX509Req :: String -> IO X509Req Source #

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

Certificate Revocation List

writeCRL :: CRL -> IO String Source #

writeCRL crl writes a Certificate Revocation List to PEM string.

readCRL :: String -> IO CRL Source #

readCRL pem reads a Certificate Revocation List in PEM string.

PKCS#7 structure

writePkcs7 :: Pkcs7 -> IO String Source #

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

readPkcs7 :: String -> IO Pkcs7 Source #

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

DH parameters

writeDHParams :: DHP -> IO String Source #

writeDHParams dh writes DH parameters to PEM string.

readDHParams :: String -> IO DHP Source #

readDHParams pem reads DH parameters in PEM string.