TlsClientConnection

GTlsClientConnection is the client-side subclass of class@Gio.TlsConnection, representing a client-side TLS connection.

Skipped during bindings generation

  • method server-identity: Property TypeInfo of getter and setter do not match

Since

2.28

Types

Link copied to clipboard
object Companion

Properties

Link copied to clipboard
open val acceptedCas: <Error class: unknown class>

A list of the distinguished names of the Certificate Authorities that the server will accept client certificates signed by. If the server requests a client certificate during the handshake, then this property will be set after the handshake completes.

Link copied to clipboard
abstract val gioTlsClientConnectionPointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
open var useSsl3: Boolean

SSL 3.0 is no longer supported. See g_tls_client_connection_set_use_ssl3() for details.

Link copied to clipboard

What steps to perform when validating a certificate received from a server. Server certificates that fail to validate in any of the ways indicated here will be rejected unless the application overrides the default via #GTlsConnection::accept-certificate.

Functions

Link copied to clipboard

Possibly copies session state from one connection to another, for use in TLS session resumption. This is not normally needed, but may be used when the same session needs to be used between different endpoints, as is required by some protocols, such as FTP over TLS.

Link copied to clipboard
open fun getAcceptedCas(): <Error class: unknown class>

Gets the list of distinguished names of the Certificate Authorities that the server will accept certificates from. This will be set during the TLS handshake if the server requests a certificate. Otherwise, it will be null.

Link copied to clipboard

Gets @conn's expected server identity

Link copied to clipboard
open fun getUseSsl3(): Boolean

SSL 3.0 is no longer supported. See g_tls_client_connection_set_use_ssl3() for details.

Link copied to clipboard

Gets @conn's validation flags

Link copied to clipboard

Sets @conn's expected server identity, which is used both to tell servers on virtual hosts which certificate to present, and also to let @conn know what name to look for in the certificate when performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.

Link copied to clipboard
open fun setUseSsl3(useSsl3: Boolean)

Since GLib 2.42.1, SSL 3.0 is no longer supported.

Link copied to clipboard

Sets @conn's validation flags, to override the default set of checks performed when validating a server certificate. By default, %G_TLS_CERTIFICATE_VALIDATE_ALL is used.