GcrCertificate

typedef struct _GcrCertificate GcrCertificate;

An object which holds a certificate.

struct GcrCertificateIface

struct GcrCertificateIface;

The interface that implementors of GcrCertificate must implement.

gcr_certificate_get_der_data ()

gconstpointer       gcr_certificate_get_der_data        (GcrCertificate *self,
                                                         gsize *n_data);

Gets the raw DER data for an X.509 certificate.

gcr_certificate_get_issuer_cn ()

gchar *             gcr_certificate_get_issuer_cn       (GcrCertificate *self);

Get the common name of the issuer of this certificate.

The string returned should be freed by the caller when no longer required.

gcr_certificate_get_issuer_dn ()

gchar *             gcr_certificate_get_issuer_dn       (GcrCertificate *self);

Get the full issuer DN of the certificate as a (mostly) readable string.

The string returned should be freed by the caller when no longer required.

gcr_certificate_get_issuer_part ()

gchar *             gcr_certificate_get_issuer_part     (GcrCertificate *self,
                                                         const gchar *part);

Get a part of the DN of the issuer of this certificate.

Examples of a part might be the 'OU' (organizational unit) or the 'CN' (common name). Only the value of that part of the DN is returned.

The string returned should be freed by the caller when no longer required.

gcr_certificate_get_issuer_raw ()

gpointer            gcr_certificate_get_issuer_raw      (GcrCertificate *self,
                                                         gsize *n_data);

Get the raw DER data for the issuer DN of the certificate.

The data should be freed by using g_free() when no longer required.

gcr_certificate_is_issuer ()

gboolean            gcr_certificate_is_issuer           (GcrCertificate *self,
                                                         GcrCertificate *issuer);

Check if issuer could be the issuer of this certificate. This is done by comparing the relevant subject and issuer fields. No signature check is done. Proper verification of certificates must be done via a crypto library.

gcr_certificate_get_subject_cn ()

gchar *             gcr_certificate_get_subject_cn      (GcrCertificate *self);

Get the common name of the subject of this certificate.

The string returned should be freed by the caller when no longer required.

gcr_certificate_get_subject_dn ()

gchar *             gcr_certificate_get_subject_dn      (GcrCertificate *self);

Get the full subject DN of the certificate as a (mostly) readable string.

The string returned should be freed by the caller when no longer required.

gcr_certificate_get_subject_part ()

gchar *             gcr_certificate_get_subject_part    (GcrCertificate *self,
                                                         const gchar *part);

Get a part of the DN of the subject of this certificate.

Examples of a part might be the 'OU' (organizational unit) or the 'CN' (common name). Only the value of that part of the DN is returned.

The string returned should be freed by the caller when no longer required.

gcr_certificate_get_subject_raw ()

gpointer            gcr_certificate_get_subject_raw     (GcrCertificate *self,
                                                         gsize *n_data);

Get the raw DER data for the subject DN of the certificate.

The data should be freed by using g_free() when no longer required.

gcr_certificate_get_issued_date ()

GDate *             gcr_certificate_get_issued_date     (GcrCertificate *self);

Get the issued date of this certificate.

The GDate returned should be freed by the caller using g_date_free() when no longer required.

gcr_certificate_get_expiry_date ()

GDate *             gcr_certificate_get_expiry_date     (GcrCertificate *self);

Get the expiry date of this certificate.

The GDate returned should be freed by the caller using g_date_free() when no longer required.

gcr_certificate_get_serial_number ()

guchar *            gcr_certificate_get_serial_number   (GcrCertificate *self,
                                                         gsize *n_length);

Get the raw binary serial number of the certificate.

The caller should free the returned data using g_free() when it is no longer required.

gcr_certificate_get_serial_number_hex ()

gchar *             gcr_certificate_get_serial_number_hex
                                                        (GcrCertificate *self);

Get the serial number of the certificate as a hex string.

The caller should free the returned data using g_free() when it is no longer required.

gcr_certificate_get_key_size ()

guint               gcr_certificate_get_key_size        (GcrCertificate *self);

Get the key size in bits of the public key represented by this certificate.

gcr_certificate_get_fingerprint ()

guchar *            gcr_certificate_get_fingerprint     (GcrCertificate *self,
                                                         GChecksumType type,
                                                         gsize *n_length);

Calculate the fingerprint for this certificate.

You can pass G_CHECKSUM_SHA1 or G_CHECKSUM_MD5 as the type parameter.

The caller should free the returned data using g_free() when it is no longer required.

gcr_certificate_get_fingerprint_hex ()

gchar *             gcr_certificate_get_fingerprint_hex (GcrCertificate *self,
                                                         GChecksumType type);

Calculate the fingerprint for this certificate, and return it as a hex string.

You can pass G_CHECKSUM_SHA1 or G_CHECKSUM_MD5 as the type parameter.

The caller should free the returned data using g_free() when it is no longer required.

gcr_certificate_mixin_class_init ()

void                gcr_certificate_mixin_class_init    (GObjectClass *object_class);

Initialize the certificate mixin for the class. This mixin implements the various required properties for the certificate.

Call this function near the end of your derived class_init function. The derived class must implement the GcrCertificate interface.

gcr_certificate_mixin_get_property ()

void                gcr_certificate_mixin_get_property  (GObject *obj,
                                                         guint prop_id,
                                                         GValue *value,
                                                         GParamSpec *pspec);

Implementation to get various required certificate properties. This should be called from your derived class get_property function, or used as a get_property virtual function.

Example of use as called from derived class get_property function:

1
2
3
4
5
6
7
8
9
10
11
12

static void
my_get_property (GObject *obj, guint prop_id, GValue *value, GParamSpec *pspec)
{
    switch (prop_id) {

    ...

    default:
        gcr_certificate_mixin_get_property (obj, prop_id, value, pspec);
        break;
    }
}

Example of use as get_property function:

1
2
3
4
5
6
7
8

static void
my_class_init (MyClass *klass)
{
    GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
    gobject_class->get_property = gcr_certificate_mixin_get_property;

    ...
}

GCR_CERTIFICATE_MIXIN_IMPLEMENT_COMPARABLE

#define             GCR_CERTIFICATE_MIXIN_IMPLEMENT_COMPARABLE()

Implement the GcrComparable interface. Use this macro like this:

1
2
3
4

G_DEFINE_TYPE_WITH_CODE (MyCertificate, my_certificate, G_TYPE_OBJECT,
GCR_CERTIFICATE_MIXIN_IMPLEMENT_COMPARABLE ();
G_IMPLEMENT_INTERFACE (GCR_TYPE_CERTIFICATE, my_certificate_iface_init);
);

gcr_certificate_mixin_comparable_init ()

void                gcr_certificate_mixin_comparable_init
                                                        (GcrComparableIface *iface);

Initialize a GcrComparableIface to compare the current certificate. In general it's easier to use the GCR_CERTIFICATE_MIXIN_IMPLEMENT_COMPARABLE() macro instead of this function.

gcr_certificate_compare ()

gint                gcr_certificate_compare             (GcrComparable *first,
                                                         GcrComparable *other);

Compare one certificate against another. If the certificates are equal then zero is returned. If one certificate is NULL or not a certificate, then a non-zero value is returned.

The return value is useful in a stable sort, but has no user logical meaning.

gcr_certificate_get_icon ()

GIcon *             gcr_certificate_get_icon            (GcrCertificate *self);

Get the icon for a certificate.

The "description" property

  "description"              gchar*                : Read

Description of object being rendered.

Default value: ""

The "expiry" property

  "expiry"                   GDate*                : Read

Certificate expiry.

The "icon" property

  "icon"                     GIcon*                : Read

Icon for the object being rendered.

The "issuer" property

  "issuer"                   gchar*                : Read

Common name of issuer.

Default value: ""

The "label" property

  "label"                    gchar*                : Read

Certificate label.

Default value: ""

The "markup" property

  "markup"                   gchar*                : Read

Markup which describes object being rendered.

Default value: ""

The "subject" property

  "subject"                  gchar*                : Read

Common name of subject.

Default value: ""