Network.HTTP.Client.OpenSSL

Support for making connections via the OpenSSL library.

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

newOpenSSLManager :: MonadIO m => m Manager

Create a new Manager using opensslManagerSettings and defaultMakeContext with defaultOpenSSLSettings.

opensslManagerSettings :: IO SSLContext -> ManagerSettings

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

defaultMakeContext :: OpenSSLSettings -> IO SSLContext

data OpenSSLSettings

Constructors

OpenSSLSettings

Fields

• osslSettingsOptions :: [SSLOption]
• osslSettingsVerifyMode :: VerificationMode
• osslSettingsCiphers :: String
• osslSettingsLoadCerts :: SSLContext -> IO ()

defaultOpenSSLSettings :: OpenSSLSettings

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.