Gio.SocketClient:tls-validation-flags (original) (raw)

Property

GioSocketClient:tls-validation-flags

deprecated: 2.72

Declaration

property tls-validation-flags: Gio.TlsCertificateFlags [ read, write, construct ]

Description [src]

The TLS validation flags used when creating TLS connections. The default value is G_TLS_CERTIFICATE_VALIDATE_ALL.

GLib guarantees that if certificate verification fails, at least one flag will be set, but it does not guarantee that all possible flags will be set. Accordingly, you may not safely decide to ignore any particular type of error. For example, it would be incorrect to maskG_TLS_CERTIFICATE_EXPIRED if you want to allow expired certificates, because this could potentially be the only error flag set even if other problems exist with the certificate. Therefore, there is no safe way to use this property. This is not a horrible problem, though, because you should not be attempting to ignore validation errors anyway. If you really must ignore TLS certificate errors, connect to the GSocketClient::event signal, wait for it to be emitted with G_SOCKET_CLIENT_TLS_HANDSHAKING, and use that to connect to GTlsConnection::accept-certificate.

Flags