metro-transport-tls-0.1.0.0: TLS transport for metro

Safe HaskellNone
LanguageHaskell2010

Metro.TP.TLSSetting

Contents

Description

Helpers for setting up a tls connection with tls package, for further customization, please refer to tls package.

Note, functions in this module will throw error if can't load certificates or CA store.

Synopsis

Make TLS settings

makeClientParams Source #

Arguments

:: FilePath

trusted certificates.

-> ServiceID 
-> IO ClientParams 

make a simple tls ClientParams that will validate server and use tls connection without providing client's own certificate. suitable for connecting server which don't validate clients.

we defer setting of clientServerIdentification to connecting phase.

Note, tls's default validating method require server has v3 certificate. you can use openssl's V3 extension to issue such a certificate. or change ClientParams before connecting.

makeClientParams' Source #

Arguments

:: FilePath

public certificate (X.509 format).

-> [FilePath]

chain certificates (X.509 format). the root of your certificate chain should be already trusted by server, or tls will fail.

-> FilePath

private key associated.

-> FilePath

trusted certificates.

-> ServiceID 
-> IO ClientParams 

make a simple tls ClientParams that will validate server and use tls connection while providing client's own certificate as well. suitable for connecting server which validate clients.

Also only accept v3 certificate.

makeServerParams Source #

Arguments

:: FilePath

public certificate (X.509 format).

-> [FilePath]

chain certificates (X.509 format). the root of your certificate chain should be already trusted by client, or tls will fail.

-> FilePath

private key associated.

-> IO ServerParams 

make a simple tls ServerParams without validating client's certificate.

makeServerParams' Source #

Arguments

:: FilePath

public certificate (X.509 format).

-> [FilePath]

chain certificates (X.509 format).

-> FilePath

private key associated.

-> FilePath

server will use these certificates to validate clients.

-> IO ServerParams 

make a tls ServerParams that also validating client's certificate.