Method

GioDtlsConnectionset_certificate

since: 2.48

Declaration

void
g_dtls_connection_set_certificate (
  GDtlsConnection* conn,
  GTlsCertificate* certificate
)

Description

This sets the certificate that conn will present to its peer during the TLS handshake. For a GDtlsServerConnection, it is mandatory to set this, and that will normally be done at construct time.

For a GDtlsClientConnection, this is optional. If a handshake fails with G_TLS_ERROR_CERTIFICATE_REQUIRED, that means that the server requires a certificate, and if you try connecting again, you should call this method first. You can call g_dtls_client_connection_get_accepted_cas() on the failed connection to get a list of Certificate Authorities that the server will accept certificates from.

(It is also possible that a server will allow the connection with or without a certificate; in that case, if you don’t provide a certificate, you can tell that the server requested one by the fact that g_dtls_client_connection_get_accepted_cas() will return non-NULL.)

Available since: 2.48

Sets property Gio.DtlsConnection:certificate

Parameters

certificate

Type: GTlsCertificate

The certificate to use for conn.

The data is owned by the caller of the function.