InfGtkCertificateManager

InfGtkCertificateManager

Synopsis

                    InfGtkCertificateManager;
InfGtkCertificateManager * inf_gtk_certificate_manager_new
                                                        (GtkWindow *parent_window,
                                                         InfXmppManager *xmpp_manager,
                                                         const gchar *trust_file,
                                                         const gchar *known_hosts_file);

Object Hierarchy

  GObject
   +----InfGtkCertificateManager

Properties

  "known-hosts-file"         gchar*                : Read / Write
  "parent-window"            GtkWindow*            : Read / Write / Construct Only
  "trust-file"               gchar*                : Read / Write
  "xmpp-manager"             InfXmppManager*       : Read / Write / Construct Only

Description

Details

InfGtkCertificateManager

typedef struct _InfGtkCertificateManager InfGtkCertificateManager;


inf_gtk_certificate_manager_new ()

InfGtkCertificateManager * inf_gtk_certificate_manager_new
                                                        (GtkWindow *parent_window,
                                                         InfXmppManager *xmpp_manager,
                                                         const gchar *trust_file,
                                                         const gchar *known_hosts_file);

Creates a new InfGtkCertificateManager. For each new client-side InfXmppConnection in xmpp_manager, the certificate manager will verify the server's certificate.

If the root CA of that certificate is contained in trust_file, or the server certificate itself is known already (meaning it is contained in known_hosts_file), then the certificate is accepted automatically. Otherwise, the user is asked for approval. If the user approves the certificate, then it is inserted into the known_hosts_file.

parent_window :

The GtkWindow to which to make certificate approval dialogs transient to.

xmpp_manager :

The InfXmppManager whose InfXmppConnections to manage the certificates for.

trust_file :

Path pointing to a file that contains trusted root CAs, or NULL.

known_hosts_file :

Path pointing to a file that contains certificates of known hosts, or NULL.

Returns :

A new InfGtkCertificateManager.

Property Details

The "known-hosts-file" property

  "known-hosts-file"         gchar*                : Read / Write

File containing certificates of known hosts.

Default value: NULL


The "parent-window" property

  "parent-window"            GtkWindow*            : Read / Write / Construct Only

The parent window for certificate approval dialogs.


The "trust-file" property

  "trust-file"               gchar*                : Read / Write

File containing trusted root CAs.

Default value: NULL


The "xmpp-manager" property

  "xmpp-manager"             InfXmppManager*       : Read / Write / Construct Only

The XMPP manager of registered connections.