Network.TLS.Server

the Server module contains the necessary calls to create a listening TLS socket aka. a server socket.

Documentation

data TLSServerParams

Constructors

TLSServerParams

Fields

spAllowedVersions :: [Version]

allowed versions that we can use

spSessions :: [[Word8]]

placeholder for futur known sessions

spCiphers :: [Cipher]

all ciphers that the server side support

spCertificate :: Maybe TLSServerCert

the certificate we serve to the client

spWantClientCert :: Bool

configure if we do a cert request to the client

spCallbacks :: TLSServerCallbacks

user callbacks

data TLSServerCallbacks

Constructors

TLSServerCallbacks

Fields

cbCertificates :: Maybe ([Certificate] -> IO Bool)

optional callback to verify certificates

Instances

Show TLSServerCallbacks

data TLSStateServer

Instances

Monad m => MonadState TLSStateServer (TLSServer m)

runTLSServer :: TLSServer m a -> TLSServerParams -> SRandomGen -> m (a, TLSStateServer)

low level packet sending receiving.

recvPacket :: Handle -> TLSServer IO (Either TLSError [Packet])

receive a single TLS packet or on error a TLSError

sendPacket :: Handle -> Packet -> TLSServer IO ()

send a single TLS packet

API, warning probably subject to change

listen :: Handle -> TLSServer IO ()

listen on a handle to a new TLS connection.

sendData :: Handle -> ByteString -> TLSServer IO ()

sendData sends a bunch of data

recvData :: Handle -> TLSServer IO ByteString

recvData get data out of Data packet, and automatically renegociate if - a Handshake ClientHello is received

close :: Handle -> TLSServer IO ()

close a TLS connection. - note that it doesn't close the handle, but just signal we're going to close - the connection to the other side