Certificate

The Certificate holds the information about the certificate and its lifecycle. It represents the certificate in a human-readable format. Certificate holds the following information of any certificate:

• Human understandable parsed certificate content
• Base64 certificate content
• Certificate state
• Certificate validation status
• Certificate compliance status
• Metadata including discovery information

In addition to the above details, the following are mapped to the Certificate for the ease of management,

• Certificate owner
• Binding RA Profile
• Entity
• Group it belongs to

Certificate state

Certificate status represents stage of certificate lifecycle and transition to different state depends on certificate operations (e.g. issue, revoke, etc.) and/or events (approval expired, certificate revoked externally).

Certificate can be in following states:

Status	Description	Transition
Requested	The Certificate is created (requested) and ready to be issued.	Initial state in case user requests certificate.
Pending Approval	The Certificate action is waiting to be approved.	When certificate action needs to be approved.
Pending Issue (Not yet supported)	The Certificate action is waiting to be issued at authority.	When certificate is requested to be issued by authority (already approved) and waiting to be approve issuance on authority side.
Pending Revoke (Not yet supported)	The Certificate action is waiting to be revoked at authority.	When certificate is requested to be revoked by authority (already approved) and waiting to be approve revocation on authority side.
Rejected	The Certificate issuance approval request was rejected.	When approval for certificate issue action was rejected or expired.
Failed	The Certificate request issuance failed.	When certificate fails to be issued by authority caused by error or invalid request.
Issued	The Certificate is issued.	Initial state in case certificate is uploaded or discovered. When certificate is successfully issued. When certificate revocation failed state returns back to Issued.
Revoked	The Certificate is revoked.	When certificate is successfully revoked.
Archived (Not yet supported)	The Certificate is archived and not displayed in inventory by default.	When certificate is marked by user or scheduled job as archived.

Certificate state transition diagram is as follows:

Certificate validation status

Certificate validation status represents the result of the certificate validation process in time. It is periodically checked by system scheduled job to keep up-to-date certificate validation status. The validation status is calculated based on the validation result of the certificate and its chain.

The following validation statuses are supported:

Status	Description
NotChecked	The Certificate validation was not run yet.
Failed	The Certificate validation process failed.
Inactive	The Certificate is not yet active (before its validation period starts).
Valid	The Certificate is valid according to validation described below.
Invalid	The Certificate is invalid according to validation described below.
Revoked	The Certificate is revoked.
Expiring	The Certificate is marked as expiring when its expiry is in less than 30 days.
Expired	The Certificate is expired.

The Certificate status transition diagram is as follows:

Validation

Certificate validation is a complex process that ensures the security and trustworthiness of digital certificates in various applications, including secure web browsing, email encryption, and digital signatures. It plays a crucial role in establishing secure and authenticated communication over the internet.

In CZERTAINLY platform, certificate validation is periodically checked by system scheduled job to keep up-to-date certificate status. To achieve that, crucial part of validation algorithm is to update and construct certificate chain (path). Currently, only X.509 certificates are supported. Therefore, following description of certificate validation is valid for X.509 certificate type.

Certificate chain

Certificate chain is constructed by following algorithm:

1. Add certificates to chain by recursively following the issuer certificate reference stored in DB.
2. If last certificate is self-signed certificate (presumed root CA), return certificate chain with indication that chain is complete.
3. Search for issuer certificate in inventory by issuer subject DN. If more candidates are present, take first where verification of certificate signature with its public key is successful.
4. If no candidate in inventory found, check if Authority Information Access (AIA) extension is available and try to download certificate from URL from AIA extension
5. Construct certificate chain further by repeating step 3 and 4 until no more certificates are available from both sources
6. Return available certificate chain with indication that chain is complete when last certificate is self-signed

Validation algorithm

Construct the certificate chain and validate certificates from root CA to subject certificate as following based on RFC5280:

1. Check the completeness of chain
2. Verify signature of certificate using issuer public key - Section 6.1.3 (a)(1)
3. Check certificate validity by comparing notBefore and notAfter dates with current date - Section 6.1.3 (a)(2)
4. Consult Revocation Authorities - Section 6.1.3 (a)(3)
   • if OCSP is available, then do the OCSP check
   • if CRL information is available, then do the CRL check
   • if no revocation information source is available, show warning that the revocation was not checked, was not available, or related reason.
5. Check if certificate issuer DN equals to issuer subject DN - Section 6.1.3 (a)(4)
6. Check basic constraints
   • if certificate is version 3 and not end certificate, check if basic constraint extension is present and CA flag is set to true - Section 6.1.4 (k)
   • if certificate is CA, check path length greater than zero and less than its issuer - Section 6.1.4 (l)
7. Check key usage of CA certificate Section 6.1.4 (n)

Validation check types

Certificate validation algorithm consists of different validation check types. Certificate is validated by different criteria to provide partial validation result.

The following validation checks are performed for Certificate:

#	Validation check	Description	Result
1	Certificate chain	Check the completeness of chain (certificate validation path) and validity of issuer certificate	VALID if chain is complete. INVALID if certificate in validation path is missing or issuer certificate is invalid or revoked.
2	Signature verification	Check the signature of Certificate using public key of the issuer certificate.	NOT CHECKED if issuer is missing. VALID if signature verified. FAILED if verification fails.
3	Certificate validity	Check certificate validity based on notBefore and notAfter dates of the certificate.	INACTIVE in case notBefore >= current date. EXPIRED in case notAfter <= current date. EXPIRING in case the notAfter is less than 30 days from current date. VALID if notBefore < current date.
4	OCSP check	Check status using OCSP URL available in the certificate extension AuthorityInformationAccess.	NOT CHECKED if issuer is missing or certificate does not contain AIA extension or OCSP URL is not present. FAILED if not possible to retrieve OCSP URL or valid content from URL. VALID if OCSP returns good. REVOKED if the OCSP return revoked.
5	CRL check	Check status using CRL URL available in the certificate attribute CRLDistributionPoints or from CRL stored in database.	NOT CHECKED if issuer is missing or certificate does not contain its extension. VALID in case CRL is available, valid, and the certificate is not on the list. REVOKED in case CRL is available, valid, and the certificate is on the list.
6	Basic Constraints	Check the basic constraints if extension is present.	INVALID if certificate is version 3, not end certificate and does not have CA flag set or path length is greater than its issuer. FAILED if cannot check if certificate is CA (not version 3) VALID otherwise.
7	Certificate Key Usage	Check if certificate key can be used to verify signatures. Applicable for CA certificates.	NOT CHECKED if certificate is not CA. VALID if certificate has keyCertSign bit set in key usage extension. INVALID otherwise.

The above is true for a single Certificate, but all certificates in the certificate chain are validated the same way.

Validation result evaluation

After certificate is checked with individual validation check types, check results are then used as input for calculating result certificate validation status. Certificate validation checks results and result validation status are then stored and saved.

Calculation of result status is as follows:

Certificate revocation lists handling

When validating certificate and checking for revocation by existence of certificate in authority CRL, whole CRL needs to be downloaded and processed. To prevent downloading CRL each time when doing revocation validation check (even multiple times when certificates are issued by same authority), CRL and its entries are stored in database.

When certificate is checked for revocation:

• check if cRLDistributionPoints extension is set, if not we do not check CRL revocation and check result is NOT CHECKED
• check if exists CRL in database by certificate issuer DN and issuer serial number, if does not exist or current UTC time is past its Next Update timestamp, download it from CRL URL, process it and store its all entries in DB.
• update CRL information - CRL number, next update timestamp and last revocation date from last processed entry
• check if certificate has freshestCRL extension present and using delta CRL (more info in RFC). If yes, process as follows:
  • check in CRL if last processed delta is still valid by its Next update timestamp
  • if not valid or not set, download delta CRL and check its validity (compare CRL issuer with issuer stored in CRL entity). If they are not same, revocation check is FAILED.
  • if DeltaCRLIndicator base CRL number is not equal to one from CRL entity, redownload full CRL (new one was probably published), if received again old one, revocation check is FAILED.
  • if delta CRL number is greater than one in DB entity, process its entries which revocation date is >= revocation date of last processed entry. Update entries in following manner:
    • when entry by serial number is not present, add new one
    • when entry by serial number is present, probably reason changed so update its revocation reason and date
    • when entry by serial number is present and revocation reason is REMOVE_FROM_CRL, remove this entry
  • update delta CRL information - CRL number, next update timestamp and last revocation date from last processed entry
• CRL is updated with newest entries and certificate can be searched in its entries by serial number

Attributes

Certificate attributes hold information related to the platform. Once a certificate request is submitted platform creates the Certificate with a specific identification, defines certificate type, and assigns validity status. Certificate attributes also include connection to the other part of platform components.

Metadata

Metadata provides any additional information about the Certificate that can be technology specific. Metadata can be used for further processing of the Certificate by different components and modules of the platform.