GLib.TlsDatabase – gio-2.0 – Vala Binding Reference

Description:

[ CCode ( type_id = "g_tls_database_get_type ()" ) ]
[ Version ( since = "2.30" ) ]
public abstract class TlsDatabase : Object

TlsDatabase is used to look up certificates and other information from a certificate or key store.

It is an abstract base class which TLS library specific subtypes override.

A TlsDatabase may be accessed from multiple threads by the TLS backend. All implementations are required to be fully thread-safe.

Most common client applications will not directly interact with TlsDatabase. It is used internally by TlsConnection.

Namespace: GLib

Package: gio-2.0

Content:

Constants:

public const string PURPOSE_AUTHENTICATE_CLIENT

The purpose used to verify the client certificate in a TLS connection.

public const string PURPOSE_AUTHENTICATE_SERVER

The purpose used to verify the server certificate in a TLS connection.

Creation methods:

protected TlsDatabase ()

Methods:

public virtual string? create_certificate_handle (TlsCertificate certificate)

Create a handle string for the certificate.

public virtual TlsCertificate? lookup_certificate_for_handle (string handle, TlsInteraction? interaction, TlsDatabaseLookupFlags flags, Cancellable? cancellable = null) throws Error

Look up a certificate by its handle.

public virtual async TlsCertificate lookup_certificate_for_handle_async (string handle, TlsInteraction? interaction, TlsDatabaseLookupFlags flags, Cancellable? cancellable = null) throws Error

Asynchronously look up a certificate by its handle in the database.

public virtual TlsCertificate lookup_certificate_issuer (TlsCertificate certificate, TlsInteraction? interaction, TlsDatabaseLookupFlags flags, Cancellable? cancellable = null) throws Error

Look up the issuer of certificate in the database.

public virtual async TlsCertificate lookup_certificate_issuer_async (TlsCertificate certificate, TlsInteraction? interaction, TlsDatabaseLookupFlags flags, Cancellable? cancellable = null) throws Error

Asynchronously look up the issuer of certificate in the database.

public virtual List<TlsCertificate> lookup_certificates_issued_by (ByteArray issuer_raw_dn, TlsInteraction? interaction, TlsDatabaseLookupFlags flags, Cancellable? cancellable = null) throws Error

Look up certificates issued by this issuer in the database.

public virtual async List<TlsCertificate> lookup_certificates_issued_by_async (ByteArray issuer_raw_dn, TlsInteraction? interaction, TlsDatabaseLookupFlags flags, Cancellable? cancellable = null) throws Error

Asynchronously look up certificates issued by this issuer in the database.

public virtual TlsCertificateFlags verify_chain (TlsCertificate chain, string purpose, SocketConnectable? identity, TlsInteraction? interaction, TlsDatabaseVerifyFlags flags, Cancellable? cancellable = null) throws Error

Determines the validity of a certificate chain, outside the context of a TLS session.

public virtual async TlsCertificateFlags verify_chain_async (TlsCertificate chain, string purpose, SocketConnectable? identity, TlsInteraction? interaction, TlsDatabaseVerifyFlags flags, Cancellable? cancellable = null) throws Error

Asynchronously determines the validity of a certificate chain after looking up and adding any missing certificates to the chain.

Inherited Members:

All known members inherited from class GLib.Object

TlsDatabase