http-client-openssl-0.3.3: http-client backend using the OpenSSL library.
Safe HaskellNone
LanguageHaskell2010

Network.HTTP.Client.OpenSSL

Description

Support for making connections via the OpenSSL library.

Synopsis

Documentation

withOpenSSL :: IO a -> IO a #

Computation of withOpenSSL action initializes the OpenSSL library as necessary, and computes action. Every application that uses HsOpenSSL must wrap any operations involving OpenSSL with withOpenSSL, or they might crash:

module Main where
import OpenSSL

main :: IO ()
main = withOpenSSL $
       do ...

Since 0.10.3.5, withOpenSSL is safe to be applied redundantly. Library authors may wish to wrap their functions not to force their users to think about initialization:

get :: URI -> IO Response
get uri = withOpenSSL $ internalImplementationOfGet uri

opensslManagerSettings :: IO SSLContext -> ManagerSettings Source #

Note that it is the caller's responsibility to pass in an appropriate context.

defaultOpenSSLSettings :: OpenSSLSettings Source #

Default OpenSSL settings. In particular:

  • SSLv2 and SSLv3 are disabled
  • Hostname validation
  • DEFAULT cipher list
  • Certificates loaded from OS-specific store

Note that these settings might change in the future.