all encrypted ciphers supported ordered from strong to weak. this choice of ciphersuite should satisfy most normal need

list of medium ciphers.

the strongest ciphers supported.

all unencrypted ciphers, do not use on insecure network.

this is not stricly a usable cipher; it's the initial cipher of a TLS connection

unencrypted cipher using RSA for key exchange and SHA1 for digest

unencrypted cipher using RSA for key exchange and MD5 for digest

RC4 cipher, RSA key exchange and MD5 for digest

RC4 cipher, RSA key exchange and SHA1 for digest

AES cipher (128 bit key), RSA key exchange and SHA1 for digest

AES cipher (256 bit key), RSA key exchange and SHA1 for digest

AES cipher (128 bit key), RSA key exchange and SHA256 for digest

AES cipher (256 bit key), RSA key exchange and SHA256 for digest

Returns CertificateUsageAccept if all the checks pass, or the first failure.

verify a certificates chain using the system certificates available.

each certificate of the list is verified against the next certificate, until it can be verified against a system certificate (system certificates are assumed as trusted)

This helper only check that the chain of certificate is valid, which means that each items received are signed by the next one, or by a system certificate. Some extra checks need to be done at the user level so that the certificate chain received make sense in the context.

for example for HTTP, the user should typically verify the certificate subject match the URL of connection.

TODO: verify validity, check revocation list if any, add optional user output to know the rejection reason.

verify a certificate against another one. the first certificate need to be signed by the second one for this function to succeed.

Is this certificate self signed?

Verify that the given certificate chain is application to the given fully qualified host name.

Verify certificate validity period that need to between the bounds of the certificate. TODO: maybe should verify whole chain.

hash the certificate signing data using the supplied hash function.

connectionClient host port param rng opens a TCP client connection to a destination host and port description (number or name). For example:

 import Network.TLS.Extra
 import Crypto.Random
 ...
   conn (newGenIO::IO SystemRandom)>= connectionClient 192.168.2.2 7777 defaultParams g

will make a new RNG (using system entropy) and connect to IP 192.168.2.2 on port 7777.

read one X509 certificate from a file.

the certificate must be in the usual PEM format with the TRUSTED CERTIFICATE or CERTIFICATE pem name.

If no valid PEM encoded certificate is found in the file this function will raise an error.

read one private key from a file.

the private key must be in the usual PEM format and at the moment only RSA PRIVATE KEY are supported.

If no valid PEM encoded private key is found in the file this function will raise an error.