TLSOptions abstracts the configuration options for the StreamPeerTLS and PacketPeerDTLS classes.
Objects of this class cannot be instantiated directly, and one of the static methods client(), client_unsafe(), or server() should be used instead.
Creates a TLS client configuration which validates certificates and their common names (fully qualified domain names).
You can specify a custom trusted_chain
of certification authorities (the default CA list will be used if null
), and optionally provide a common_name_override
if you expect the certificate to have a common name other than the server FQDN.
Note: On the Web platform, TLS verification is always enforced against the CA list of the web browser. This is considered a security feature.
Creates an unsafe TLS client configuration where certificate validation is optional. You can optionally provide a valid trusted_chain
, but the common name of the certificates will never be checked. Using this configuration for purposes other than testing is not recommended.
Note: On the Web platform, TLS verification is always enforced against the CA list of the web browser. This is considered a security feature.
Returns the common name (domain name) override specified when creating with client().
Returns the X509Certificate specified when creating with server().
Returns the CryptoKey specified when creating with server().
Returns the CA X509Certificate chain specified when creating with client() or client_unsafe().
Returns true
if created with server(), false
otherwise.
Returns true
if created with client_unsafe(), false
otherwise.
Creates a TLS server configuration using the provided key
and certificate
.
Note: The certificate
should include the full certificate chain up to the signing CA (certificates file can be concatenated using a general purpose text editor).