SSLContext

classin packageklyn.net.ssl

public class SSLContext extends Object

└ SSLContext

Immutable TLS client context.

The context stores TLS verification and certificate settings and can be reused for multiple HTTPS requests or TLS sockets.

import klyn.net.ssl

context = SSLContext.clientDefault().withTlsVersions("TLSv1.2", "TLSv1.3")
print(context.verifyPeer)

Fields

Modifier and Type	Member	Description
public readonly	caFile `caFile as String`	Optional CA certificate file in PEM format.
public readonly	caPath `caPath as String`	Optional CA certificate folder.
public readonly	clientCertificateFile `clientCertificateFile as String`	Optional client certificate file in PEM format.
public readonly	clientPrivateKeyFile `clientPrivateKeyFile as String`	Optional client private key file in PEM format.
public readonly	maxVersion `maxVersion as String`	Optional maximum TLS version, for example `TLSv1.3`.
public readonly	minVersion `minVersion as String`	Optional minimum TLS version, for example `TLSv1.2`.
public readonly	verifyPeer `verifyPeer as Boolean`	True when peer certificates and host names must be verified.

Inherited Properties

propertyInherited Properties from Object: type

Constructors

Modifier and Type	Member	Description
public	SSLContext `SSLContext(verifyPeer as Boolean = true, caFile as String = "", caPath as String = "", clientCertificateFile as String = "", clientPrivateKeyFile as String = "", minVersion as String = "", maxVersion as String = "")`	Creates a TLS context.

Methods

Modifier and Type	Member	Description
public static	clientDefault `clientDefault() as SSLContext`	Returns the default verified client context.
public	copy `copy() as SSLContext`	Returns a copy of this context.
public static	insecure `insecure() as SSLContext`	Returns an insecure context that disables peer verification.
public	openSocket `openSocket(host as String, port as Int) as SSLSocket throws SSLException`	Opens a TLS socket using this context.
public	trustAll `trustAll() as SSLContext`	Returns a copy that trusts all peers.
public	withCaFile `withCaFile(value as Object) as SSLContext throws SSLException`	Returns a copy with a custom CA certificate file.
public	withCaPath `withCaPath(value as Object) as SSLContext throws SSLException`	Returns a copy with a custom CA certificate directory.
public	withClientCertificate `withClientCertificate(certificatePath as Object, privateKeyPath as Object) as SSLContext throws SSLException`	Returns a copy with a client certificate and private key.
public	withTlsVersions `withTlsVersions(minVersion as String, maxVersion as String = "") as SSLContext`	Returns a copy with minimum and optional maximum TLS versions.

Inherited Methods

methodInherited Methods from Object: deepCopy, fromJson, hash, toDict, toJson, toMap, toString, toXml