Module: Gio::DtlsClientConnection

Defined in:

(unknown)

Overview

GDtls::ClientConnection is the client-side subclass of GDtls::Connection, representing a client-side DTLS connection.

Instance Method Summary

• #accepted_cas ⇒ GLib::List

  Gets the list of distinguished names of the Certificate Authorities that the server will accept certificates from.

• #server_identity ⇒ Gio::SocketConnectable

  Gets conn’s expected server identity expected server identity, or nil if the expected identity is not known.

• #server_identity=(identity) ⇒ nil

  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.

• #validation_flags ⇒ Gio::TlsCertificateFlags

  Gets conn’s validation flags.

• #validation_flags=(flags) ⇒ nil

  Sets conn’s validation flags, to override the default set of checks performed when validating a server certificate.

Instance Method Details

#accepted_cas ⇒ GLib::List

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 nil.

Each item in the list is a GByte::Array which contains the complete subject DN of the certificate authority. CA DNs. You should unref each element with g_byte_array_unref() and then the free the list with g_list_free().

Returns:

• (GLib::List) —

  the list of

#server_identity ⇒ Gio::SocketConnectable

Gets conn’s expected server identity expected server identity, or nil if the expected identity is not known.

Returns:

• (Gio::SocketConnectable) —

  a GSocket::Connectable describing the

#server_identity=(identity) ⇒ nil

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.

Parameters:

• identity (Gio::SocketConnectable) —

  a GSocket::Connectable describing the expected server identity

Returns:

• (nil)

#validation_flags ⇒ Gio::TlsCertificateFlags

Gets conn’s validation flags

Returns:

• (Gio::TlsCertificateFlags) —

  the validation flags

#validation_flags=(flags) ⇒ nil

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.

Parameters:

• flags (Gio::TlsCertificateFlags) —

  the GTls::CertificateFlags to use

Returns:

• (nil)