SecureBlackbox Lite 2020 Qt Edition

Questions / Feedback?

CRLManager Class

Properties   Methods   Events   Configuration Settings   Errors  

The CRLManager class supports the importing, exporting, and validation of Certificate Revocation Lists (CRLs).

Syntax

CRLManager

Remarks

CRLs store information about revoked certificates, i.e., certificates that have been identified as invalid for any number of reasons by the issuing certificate authority (CA). CRLs identify certificates by their serial numbers. Therefore, by knowing the certificate's SerialNumber, its validity status can be checked against a CRL.

Each CRL corresponds to one issuing point, and each Certificate Authority (CA) certificate can have a corresponding CRL which contains information about the certificates signed with this CA certificate.

CAs are not required to issue CRLs if other revocation or certificate status mechanisms are provided. Each CRL must contain the date by which the next CRL will be issued. This date is specified by the NextUpdate field.

Property List


The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

CACertBytesReturns raw certificate data in DER format.
CACertHandleAllows to get or set a 'handle', a unique identifier of the underlying property object.
CRLBytesReturns raw CRL data in DER format.
CRLCAKeyIDA unique identifier (fingerprint) of the CA certificate's private key, if present in the CRL.
CRLEntryCountReturns the number of certificate status entries in the CRL.
CRLHandleAllows to get or set a 'handle', a unique identifier of the underlying property object.
CRLIssuerThe common name of the CRL issuer (CA), typically a company name.
CRLIssuerRDNA collection of information, in the form of [OID, Value] pairs, uniquely identifying the CRL issuer.
CRLLocationThe URL that the CRL was downloaded from.
CRLNextUpdateThe planned time and date of the next version of this CRL to be published.
CRLSigAlgorithmThe public key algorithm that was used by the CA to sign this CRL.
CRLTBSThe to-be-signed part of the CRL (the CRL without the signature part).
CRLThisUpdateThe date and time at which this version of the CRL was published.
EntryCountThe number of items in the CRL.
CRLEntryInfoCertStatusReturns the status of the certificate.
CRLEntryInfoHandleAllows to get or set a 'handle', a unique identifier of the underlying property object.
CRLEntryInfoRevocationDateThe time and date when the certificate gets revoked or cancelled.
CRLEntryInfoRevocationReasonSpecifies the reason for certificate revocation.
CRLEntryInfoSerialNumberThe certificate serial number.
ExternalCryptoCustomParamsCustom parameters to be passed to the signing service (uninterpreted).
ExternalCryptoDataAdditional data to be included in the async state and mirrored back by the requestor.
ExternalCryptoExternalHashCalculationSpecifies whether the message hash is to be calculated at the external endpoint.
ExternalCryptoHashAlgorithmSpecifies the request's signature hash algorithm.
ExternalCryptoKeyIDThe ID of the pre-shared key used for DC request authentication.
ExternalCryptoKeySecretThe pre-shared key used for DC request authentication.
ExternalCryptoMethodSpecifies the asynchronous signing method.
ExternalCryptoModeSpecifies the external cryptography mode.
ExternalCryptoPublicKeyAlgorithmProvide public key algorithm here if the certificate is not available on the pre-signing stage.

Method List


The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

AddAdds a new revoked certificate entry.
ClearEmpties the CRL.
ConfigSets or retrieves a configuration setting.
DownloadDownloads a CRL from the specified location.
GetCertEntryIndexReturns the index of the CRL item by the certificate's serial number.
LoadLoads a CRL from a byte array.
LoadFromFileLoads a CRL from a file.
RemoveRemoves the specified entry from the CRL.
SaveSaves the CRL to a byte array.
SaveToFileSaves the CRL to a file.
SelectEntryFetches revocation information about the selected certificate from the CRL.
ValidateValidates the CRL signature.

Event List


The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

ErrorInformation about errors during CRL management.
ExternalSignHandles remote or external signing initiated by the SignExternal method or other source.
NotificationThis event notifies the application about an underlying control flow event.

Configuration Settings


The following is a list of configuration settings for the class with short descriptions. Click on the links for further details.

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox Lite 2020 Qt Edition - Version 20.0 [Build 8166]