TlsClientConnectionT

#GTlsClientConnection is the client-side subclass of #GTlsConnection, representing a client-side TLS connection.

Members

Functions

copySessionState
void copySessionState(TlsClientConnectionIF source)

Copies session state from one connection to another. 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. @source should have already completed a handshake, and @conn should not have completed a handshake.

getAcceptedCas
ListG getAcceptedCas()

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.

getServerIdentity
SocketConnectableIF getServerIdentity()

Gets @conn's expected server identity

getTlsClientConnectionStruct
GTlsClientConnection* getTlsClientConnectionStruct(bool transferOwnership)

Get the main Gtk struct

getUseSsl3
bool getUseSsl3()

Gets whether @conn will force the lowest-supported TLS protocol version rather than attempt to negotiate the highest mutually- supported version of TLS; see g_tls_client_connection_set_use_ssl3().

getValidationFlags
GTlsCertificateFlags getValidationFlags()

Gets @conn's validation flags

setServerIdentity
void setServerIdentity(SocketConnectableIF identity)

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.

setUseSsl3
void setUseSsl3(bool useSsl3)

Since 2.42.1, if @use_ssl3 is %TRUE, this forces @conn to use the lowest-supported TLS protocol version rather than trying to properly negotiate the highest mutually-supported protocol version with the peer. Be aware that SSL 3.0 is generally disabled by the #GTlsBackend, so the lowest-supported protocol version is probably not SSL 3.0.

setValidationFlags
void setValidationFlags(GTlsCertificateFlags flags)

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.

Meta

Since

2.28