SSLContext

An SSL context is used to create SSL sessions.

class val SSLContext

Constructors

create

new ref create()
: SSLContext ref^

Returns


Public Functions

client

Create a client-side SSL session. If a hostname is supplied, the server side certificate must be valid for that hostname.

fun box client(
  hostname: String val = seq)
: SSL iso^ ?

Parameters

Returns


server

Create a server-side SSL session.

fun box server()
: SSL iso^ ?

Returns


set_cert

The cert file is a PEM certificate chain. The key file is a private key. Servers must set this. For clients, it is optional.

fun ref set_cert(
  cert: FilePath val,
  key: FilePath val)
: None val ?

Parameters

Returns


set_authority

Use a PEM file and/or a directory of PEM files to specify certificate authorities. Clients must set this. For servers, it is optional. Use None to indicate no file or no path. Raises an error if these verify locations aren't valid, or if both are None.

fun ref set_authority(
  file: (FilePath val | None val),
  path: (FilePath val | None val) = seq)
: None val ?

Parameters

Returns


set_ciphers

Set the accepted ciphers. This replaces the existing list. Raises an error if the cipher list is invalid.

fun ref set_ciphers(
  ciphers: String val)
: None val ?

Parameters

Returns


set_client_verify

Set to true to require verification. Defaults to true.

fun ref set_client_verify(
  state: Bool val)
: None val

Parameters

Returns


set_server_verify

Set to true to require verification. Defaults to false.

fun ref set_server_verify(
  state: Bool val)
: None val

Parameters

Returns


set_verify_depth

Set the verify depth. Defaults to 6.

fun ref set_verify_depth(
  depth: U32 val)
: None val

Parameters

  • depth: U32 val

Returns


allow_tls_v1

Allow TLS v1. Defaults to false.

fun ref allow_tls_v1(
  state: Bool val)
: None val

Parameters

Returns


allow_tls_v1_1

Allow TLS v1.1. Defaults to false.

fun ref allow_tls_v1_1(
  state: Bool val)
: None val

Parameters

Returns


allow_tls_v1_2

Allow TLS v1.2. Defaults to true.

fun ref allow_tls_v1_2(
  state: Bool val)
: None val

Parameters

Returns


dispose

Free the SSL context.

fun ref dispose()
: None val

Returns


Private Functions

_final

Free the SSL context.

fun box _final()
: None val

Returns