TlsClientConnectionIF

#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

getStruct
void* getStruct()

the main Gtk struct as a void*

getTlsClientConnectionStruct
GTlsClientConnection* getTlsClientConnectionStruct(bool transferOwnership)

Get the main Gtk struct

getUseSsl3
bool getUseSsl3()

Gets whether @conn will use SSL 3.0 rather than the highest-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)

If @use_ssl3 is %TRUE, this forces @conn to use SSL 3.0 rather than trying to properly negotiate the right version of TLS or SSL to use. This can be used when talking to servers that do not implement the fallbacks correctly and which will therefore fail to handshake with a "modern" TLS handshake attempt.

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.

Static functions

getType
GType getType()

Meta

Since

2.28