gcr-4

---

Description:

A library for bits of crypto UI and parsing

• C-Documentation: https://gnome.pages.gitlab.gnome.org/gcr/gcr-4/
• Devhelp-Package download

Content:

Namespaces:

• Gcr

Interfaces:

• Certificate - An interface that represents an X.509 certificate.
• ImportInteraction - This is an interface implemented by a caller performing an import.
• Importer - An interface which allows importing of certificates and keys.
• Prompt - A prompt displayed to the user.

Classes:

• CertificateChain - Represents a chain of certificates, normally used to validate the trust in a certificate.
• CertificateField
• CertificateRequest - An object that allows creation of certificate requests.
• CertificateSection
• Parsed - A parsed item parsed by a Parser.
• Parser - A parser for parsing various types of files or data.
• Pkcs11Certificate - A certificate loaded from a PKCS#11 storage.
• SecretExchange - Allows exchange of secrets between two processes on the same system without exposing those secrets to things like loggers, non-pageable memory etc.
• SimpleCertificate - An implementation of [ iface@Certificate] which loads a certificate from DER data already located in memory.
• SshAskpass - When used as the setup function while spawning an ssh command like ssh-add or ssh, this allows callbacks for passwords on the provided interaction.
• SystemPrompt - A [iface@Prompt] implementation which calls to the system prompter to display prompts in a system modal fashion.
• SystemPrompter - A prompter used by implementations of system prompts.

Enums:

• CertificateChainFlags - Flags to be used with the build operation.
• CertificateChainStatus - The status of a built certificate chain.
• CertificateRequestFormat - The format of a certificate request.
• CertificateSectionFlags
• DataError - Values responding to error codes for parsing and serializing data.
• DataFormat - The various format identifiers.
• PromptReply - Various replies returned by [ method@Prompt.
• SystemPromptError - No error returned by the SystemPrompt is suitable for display or to the user.
• SystemPrompterMode - The mode for the system prompter.

Constants:

• public const int MAJOR_VERSION
  The major version number of the Gcr library.
• public const int MICRO_VERSION
  The micro version number of the Gcr library.
• public const int MINOR_VERSION
  The minor version number of the Gcr library.
• public const string PURPOSE_CLIENT_AUTH
  The purpose used to verify the client certificate in a TLS connection.
• public const string PURPOSE_CODE_SIGNING
  The purpose used to verify certificate used for the signature on signed code.
• public const string PURPOSE_EMAIL
  The purpose used to verify certificates that are used in email communication such as S/MIME.
• public const string PURPOSE_SERVER_AUTH
  The purpose used to verify the server certificate in a TLS connection.
• public const string SECRET_EXCHANGE_PROTOCOL_1
  The current secret exchange protocol.
• public const string UNLOCK_OPTION_ALWAYS
• public const string UNLOCK_OPTION_IDLE
• public const string UNLOCK_OPTION_SESSION
• public const string UNLOCK_OPTION_TIMEOUT

Methods:

• public uint8[]? fingerprint_from_attributes (Attributes attrs, ChecksumType checksum_type)
  Create a key fingerprint for a certificate, public key or private key.
• public uint8[]? fingerprint_from_subject_public_key_info (uint8[] key_info, ChecksumType checksum_type)
  Create a key fingerprint for a DER encoded subjectPublicKeyInfo.
• public List<Importer> importer_create_for_parsed (Parsed parsed)
• public List<Importer> importer_queue_and_filter_for_parsed (List<Importer> importers, Parsed parsed)
• public void importer_register (Type importer_type, owned Attributes attrs)
• public void importer_register_well_known ()
• public void mock_prompter_disconnect ()
  Disconnect the mock prompter
• public void mock_prompter_expect_close ()
  Queue an expected response on the mock prompter.
• public void mock_prompter_expect_confirm_cancel ()
  Queue an expected response on the mock prompter.
• public void mock_prompter_expect_password_cancel ()
  Queue an expected response on the mock prompter.
• public uint mock_prompter_get_delay_msec ()
  Get the delay in milliseconds before the mock prompter completes an expected prompt.
• public bool mock_prompter_is_expecting ()
  Check if the mock prompter is expecting a response.
• public bool mock_prompter_is_prompting ()
  Check if the mock prompter is showing any prompts.
• public void mock_prompter_set_delay_msec (uint delay_msec)
  Set the delay in milliseconds before the mock prompter completes an expected prompt.
• public unowned string mock_prompter_start ()
  Start the mock prompter.
• public void mock_prompter_stop ()
  Stop the mock prompter.
• public void parsed_unref (void* parsed)
  Unreferences a parsed item which was referenced with @ref
• public void pkcs11_add_module (Module module)
  Add a Module to the list of PKCS#11 modules that are used by the GCR library.
• public bool pkcs11_add_module_from_file (string module_path, void* unused) throws Error
  Initialize a PKCS#11 module and add it to the modules that are used by the GCR library.
• public List<Module> pkcs11_get_modules ()
  List all the PKCS#11 modules that are used by the GCR library.
• public List<Slot> pkcs11_get_trust_lookup_slots ()
  List all the PKCS#11 slots that are used by the GCR library for lookup of trust assertions.
• public unowned string[]? pkcs11_get_trust_lookup_uris ()
  Get the PKCS#11 URIs that are used to identify which slots to use for lookup trust assertions.
• public Slot? pkcs11_get_trust_store_slot ()
  Selects an appropriate PKCS#11 slot to store trust assertions.
• public unowned string? pkcs11_get_trust_store_uri ()
  Get the PKCS#11 URI that is used to identify which slot to use for storing trust storage.
• public bool pkcs11_initialize (Cancellable? cancellable = null) throws Error
  Asynchronously initialize the registered PKCS#11 modules.
• public async bool pkcs11_initialize_async (Cancellable? cancellable) throws Error
  Asynchronously initialize the registered PKCS#11 modules.
• public void pkcs11_set_modules (List<Module> modules)
  Set the list of PKCS#11 modules that are used by the GCR library.
• public void pkcs11_set_trust_lookup_uris (string? pkcs11_uris)
  Set the PKCS#11 URIs that are used to identify which slots to use for lookup of trust assertions.
• public void pkcs11_set_trust_store_uri (string? pkcs11_uri)
  Set the PKCS#11 URI that is used to identify which slot to use for storing trust assertions.
• public bool trust_add_pinned_certificate (Certificate certificate, string purpose, string peer, Cancellable? cancellable = null) throws Error
  Add a pinned certificate for connections to peer for purpose.
• public async bool trust_add_pinned_certificate_async (Certificate certificate, string purpose, string peer, Cancellable? cancellable) throws Error
  Add a pinned certificate for communication with peer for purpose.
• public bool trust_is_certificate_anchored (Certificate certificate, string purpose, Cancellable? cancellable = null) throws Error
  Check if the certificate is a trust anchor for the given purpose.
• public async bool trust_is_certificate_anchored_async (Certificate certificate, string purpose, Cancellable? cancellable) throws Error
  Check if the certificate is a trust anchor for the given purpose.
• public bool trust_is_certificate_distrusted (uint8[] serial_nr, uint8[] issuer, Cancellable? cancellable = null) throws Error
  Checks whether the certificate that can be uniquely identified with the given serial_nr and issuer is marked as distrusted (for example by the user, or because it's part of a CRL).
• public async bool trust_is_certificate_distrusted_async (uint8[] serial_nr, uint8[] issuer, Cancellable? cancellable) throws Error
  Asynchronously checks whether the certificate that can be uniquely identified with the given serial_nr and issuer is marked as distrusted (for example by the user, or because it's part of a CRL).
• public bool trust_is_certificate_pinned (Certificate certificate, string purpose, string peer, Cancellable? cancellable = null) throws Error
  Check if certificate is pinned for purpose to communicate with peer.
• public async bool trust_is_certificate_pinned_async (Certificate certificate, string purpose, string peer, Cancellable? cancellable) throws Error
  Check if certificate is pinned for purpose to communicate with peer.
• public bool trust_remove_pinned_certificate (Certificate certificate, string purpose, string peer, Cancellable? cancellable = null) throws Error
  Remove a pinned certificate for communication with peer for purpose.
• public async bool trust_remove_pinned_certificate_async (Certificate certificate, string purpose, string peer, Cancellable? cancellable) throws Error
  Remove a pinned certificate for communication with peer for purpose.