:right-sidebar: True

Pkcs11Certificate
===================================================================

.. currentmodule:: gi.repository.Gcr





.. class:: Pkcs11Certificate(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gck.Object`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gcr.Certificate`



A certificate loaded from a PKCS``11`` storage.
It is also a valid :obj:`~gi.repository.Gck.Object` and can be used as such.

Use :func:`~gi.repository.Gcr.Pkcs11Certificate.lookup_issuer` to lookup the issuer of a given
certificate in the PKCS``11`` store.

Various common PKCS``11`` certificate attributes are automatically loaded and
are available via :func:`~gi.repository.Gcr.Pkcs11Certificate.get_attributes`.




Methods
-------

.. rst-class:: interim-class

.. class:: Pkcs11Certificate
   :no-index:


   .. method:: get_attributes() -> ~gi.repository.Gck.Attributes

      Access the automatically loaded attributes for this certificate.









   .. classmethod:: lookup_issuer(cancellable: ~gi.repository.Gio.Cancellable | None = None) -> ~gi.repository.Gcr.Certificate

      Lookup a the issuer of a ``certificate`` in the PKCS``11`` storage. The
      lookup is done using the issuer DN of the certificate. No certificate chain
      verification is done. Use a crypto library to make trust decisions.

      This call may block, see :func:`~gi.repository.Gcr.Pkcs11Certificate.lookup_issuer` for the
      non-blocking version.

      Will return :const:`None` if no issuer certificate is found. Use ``error`` to determine
      if an error occurred.






      :param cancellable: a :obj:`~gi.repository.Gio.Cancellable`




   .. classmethod:: lookup_issuer_async(cancellable: ~gi.repository.Gio.Cancellable | None = None, callback: ~typing.Callable[[~gi.repository.GObject.Object | None, ~gi.repository.Gio.AsyncResult, ~typing.Any], None] | None = None, user_data: ~typing.Any = None) -> None

      Lookup a the issuer of a ``certificate`` in the PKCS``11`` storage. The
      lookup is done using the issuer DN of the certificate. No certificate chain
      verification is done. Use a crypto library to make trust decisions.

      When the operation is finished, callback will be called. You can then call
      :func:`~gi.repository.Gcr.Pkcs11Certificate.lookup_issuer_finish` to get the result of the
      operation.






      :param cancellable: a :obj:`~gi.repository.Gio.Cancellable`

      :param callback: a :obj:`~gi.repository.Gio.AsyncReadyCallback` to call when the operation completes

      :param user_data: the data to pass to callback function




   .. classmethod:: lookup_issuer_finish() -> ~gi.repository.Gcr.Certificate

      Finishes an asynchronous operation started by
      :func:`~gi.repository.Gcr.Pkcs11Certificate.lookup_issuer_async`.

      Will return :const:`None` if no issuer certificate is found. Use ``error`` to determine
      if an error occurred.









   .. classmethod:: new_from_uri(cancellable: ~gi.repository.Gio.Cancellable | None = None) -> ~gi.repository.Gcr.Certificate | None

      Lookup a certificate in the PKCS``11`` storage by the given URI.

      This call may block, see :func:`~gi.repository.Gcr.Pkcs11Certificate.new_from_uri_async` for the
      non-blocking version.

      Will return :const:`None` if no certificate is found. Use ``error`` to determine
      if an error occurred.






      :param cancellable: a :obj:`~gi.repository.Gio.Cancellable`




   .. classmethod:: new_from_uri_async(cancellable: ~gi.repository.Gio.Cancellable | None = None, callback: ~typing.Callable[[~gi.repository.GObject.Object | None, ~gi.repository.Gio.AsyncResult, ~typing.Any], None] | None = None, user_data: ~typing.Any = None) -> None

      Lookup a certificate in the PKCS``11`` storage by the given URI.

      When the operation is finished, callback will be called. You can then call
      :func:`~gi.repository.Gcr.Pkcs11Certificate.new_from_uri_finish` to get the result of the
      operation.






      :param cancellable: a :obj:`~gi.repository.Gio.Cancellable`

      :param callback: a :obj:`~gi.repository.Gio.AsyncReadyCallback` to call when the operation completes

      :param user_data: the data to pass to callback function




   .. classmethod:: new_from_uri_finish() -> ~gi.repository.Gcr.Certificate | None

      Finishes an asynchronous operation started by
      :func:`~gi.repository.Gcr.Pkcs11Certificate.new_from_uri_async`.

      Will return :const:`None` if no certificate is found. Use ``error`` to determine
      if an error occurred.













Properties
----------

.. rst-class:: interim-class

.. class:: Pkcs11Certificate
   :no-index:
   

   .. attribute:: props.attributes
      :type: ~gi.repository.Gck.Attributes

      The type of the None singleton.















Fields
------

.. rst-class:: interim-class

.. class:: Pkcs11Certificate
   :no-index:
   

   .. attribute:: parent

      






   .. attribute:: pv