CRLManager Class
Properties Methods Events Configuration Settings Errors
The CRLManager class supports the importing, exporting, and validation of Certificate Revocation Lists (CRLs).
Syntax
secureblackboxlite.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.
CACertBytes | Returns raw certificate data in DER format. |
CACertHandle | Allows to get or set a 'handle', a unique identifier of the underlying property object. |
CRLBytes | Returns raw CRL data in DER format. |
CRLCAKeyID | A unique identifier (fingerprint) of the CA certificate's private key, if present in the CRL. |
CRLEntryCount | Returns the number of certificate status entries in the CRL. |
CRLHandle | Allows to get or set a 'handle', a unique identifier of the underlying property object. |
CRLIssuer | The common name of the CRL issuer (CA), typically a company name. |
CRLIssuerRDN | A collection of information, in the form of [OID, Value] pairs, uniquely identifying the CRL issuer. |
CRLLocation | The URL that the CRL was downloaded from. |
CRLNextUpdate | The planned time and date of the next version of this CRL to be published. |
CRLSigAlgorithm | The public key algorithm that was used by the CA to sign this CRL. |
CRLTBS | The to-be-signed part of the CRL (the CRL without the signature part). |
CRLThisUpdate | The date and time at which this version of the CRL was published. |
EntryCount | The number of items in the CRL. |
CRLEntryInfoCertStatus | Returns the status of the certificate. |
CRLEntryInfoHandle | Allows to get or set a 'handle', a unique identifier of the underlying property object. |
CRLEntryInfoRevocationDate | The time and date when the certificate gets revoked or cancelled. |
CRLEntryInfoRevocationReason | Specifies the reason for certificate revocation. |
CRLEntryInfoSerialNumber | The certificate serial number. |
ExternalCryptoCustomParams | Custom parameters to be passed to the signing service (uninterpreted). |
ExternalCryptoData | Additional data to be included in the async state and mirrored back by the requestor. |
ExternalCryptoExternalHashCalculation | Specifies whether the message hash is to be calculated at the external endpoint. |
ExternalCryptoHashAlgorithm | Specifies the request's signature hash algorithm. |
ExternalCryptoKeyID | The ID of the pre-shared key used for DC request authentication. |
ExternalCryptoKeySecret | The pre-shared key used for DC request authentication. |
ExternalCryptoMethod | Specifies the asynchronous signing method. |
ExternalCryptoMode | Specifies the external cryptography mode. |
ExternalCryptoPublicKeyAlgorithm | Provide 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.
Add | Adds a new revoked certificate entry. |
Clear | Empties the CRL. |
Config | Sets or retrieves a configuration setting. |
Download | Downloads a CRL from the specified location. |
GetCertEntryIndex | Returns the index of the CRL item by the certificate's serial number. |
Load | Loads a CRL from a byte array. |
LoadFromFile | Loads a CRL from a file. |
Remove | Removes the specified entry from the CRL. |
Save | Saves the CRL to a byte array. |
SaveToFile | Saves the CRL to a file. |
SelectEntry | Fetches revocation information about the selected certificate from the CRL. |
Validate | Validates 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.
Error | Information about errors during CRL management. |
ExternalSign | Handles remote or external signing initiated by the SignExternal method or other source. |
Notification | This 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.