GcrUi.CertificateRenderer
Description: Reference for GcrUi.CertificateRenderer

### Class

# GcrUi CertificateRenderer

#### Description [src]

    class GcrUi.CertificateRenderer : GObject.Object
      implements Gcr.Certificate, Gcr.Comparable, GcrUi.Renderer {
      /* No available fields */
    }

An implementation of `GcrRenderer` which renders certificates.

#### Hierarchy

#### Ancestors

- GObject

#### Implements

- GcrCertificate
- GcrComparable
- GcrRenderer

#### Constructors

###### gcr_certificate_renderer_new

Create a new certificate renderer to display the certificate.

###### gcr_certificate_renderer_new_for_attributes

Create a new certificate renderer to display the label and attributes. One of the attributes should be a CKA_VALUE type attribute containing a DER encoded certificate.

#### Instance methods

###### gcr_certificate_renderer_get_certificate

Get the certificate displayed in the renderer. If no certificate was explicitly set, then the renderer will return itself since it acts as a valid certificate.

###### gcr_certificate_renderer_set_certificate

Set a certificate to display in the renderer.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

##### Methods inherited from GcrCertificate (23)

###### gcr_certificate_get_basic_constraints

Get the basic constraints for the certificate if present. If `FALSE` is returned then no basic constraints are present and the `is_ca` and `path_len` arguments are not changed.

###### gcr_certificate_get_der_data

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

###### gcr_certificate_get_expiry_date

Get the expiry date of this certificate.

###### gcr_certificate_get_fingerprint

Calculate the fingerprint for this certificate.

###### gcr_certificate_get_fingerprint_hex

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

###### gcr_certificate_get_icon

Get the icon for a certificate.

###### gcr_certificate_get_issued_date

Get the issued date of this certificate.

###### gcr_certificate_get_issuer_cn

Get the common name of the issuer of this certificate.

###### gcr_certificate_get_issuer_dn

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

###### gcr_certificate_get_issuer_name

Get a name to represent the issuer of this certificate.

###### gcr_certificate_get_issuer_part

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

###### gcr_certificate_get_issuer_raw

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

###### gcr_certificate_get_key_size

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

###### gcr_certificate_get_markup_text

Calculate a GMarkup string for displaying this certificate.

###### gcr_certificate_get_serial_number

Get the raw binary serial number of the certificate.

###### gcr_certificate_get_serial_number_hex

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

###### gcr_certificate_get_subject_cn

Get the common name of the subject of this certificate.

###### gcr_certificate_get_subject_dn

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

###### gcr_certificate_get_subject_name

Get a name to represent the subject of this certificate.

###### gcr_certificate_get_subject_part

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

###### gcr_certificate_get_subject_raw

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

###### gcr_certificate_is_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_mixin_emit_notify

Implementers of the `GcrCertificate` mixin should call this function to notify when the certificate has changed to emit notifications on the various properties.

##### Methods inherited from GcrComparable (1)

###### gcr_comparable_compare

Compare whether two objects represent the same thing. The return value can also be used to sort the objects.

##### Methods inherited from GcrRenderer (5)

###### gcr_renderer_emit_data_changed

Emit the `GcrRenderer::data-changed` signal on the renderer. This is used by renderer implementations.

###### gcr_renderer_get_attributes

Get the PKCS#11 attributes, if any, set for this renderer to display.

###### gcr_renderer_popuplate_popup

Called by `GcrViewer` when about to display a popup menu for the content displayed by the renderer. The renderer can add a menu item if desired.

###### gcr_renderer_render_view

Render the contents of the renderer to the given viewer.

###### gcr_renderer_set_attributes

Set the PKCS#11 attributes for this renderer to display.

#### Properties

###### GcrUi.CertificateRenderer:attributes

The certificate attributes to display. One of the attributes must be a CKA_VALUE type attribute which contains a DER encoded certificate.

###### GcrUi.CertificateRenderer:certificate

The certificate to display. May be `NULL`.

###### GcrUi.CertificateRenderer:label

The label to display.

##### Properties inherited from GcrCertificate (7)

###### Gcr.Certificate:description

A readable description for this certificate.

###### Gcr.Certificate:expiry

The expiry date of the certificate.

###### Gcr.Certificate:icon

An icon representing the certificate.

###### Gcr.Certificate:issuer

Common name part of the certificate issuer.

###### Gcr.Certificate:label

A readable label for this certificate.

###### Gcr.Certificate:markup

GLib markup to describe the certificate.

###### Gcr.Certificate:subject

Common name part of the certificate subject.

##### Properties inherited from GcrRenderer (2)

###### GcrRenderer:attributes

The attributes to display.

###### GcrRenderer:label

The label to display.

#### Signals

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

##### Signals inherited from GcrRenderer (1)

###### GcrRenderer::data-changed

A signal that is emitted by the renderer when it’s data changed and should be rerendered.

#### Class structure

    struct GcrUiCertificateRendererClass {
      GObjectClass parent_class;

    }

The class for `GcrCertificateRenderer`.

###### Class members

`parent_class: GObjectClass`

  The parent class.