Certificate revocation list
The certificate revocation list consists of certificate serial numbers of issued certificates that are no longer valid. It is used by nodes when they establish a TLS connection between each other and need to ensure on certificate validity. In order to add entries to the certificate revocation list there is the certificate revocation process that resembles the one from the certificate signing request (CSR). Note that, once added the entries cannot be removed from the certificate revocation list.
In the similar vein as CSR, it is integrated with the JIRA tool, and the submitted requests follow exactly the same lifecycle. To support the above functionality, there are two externally available REST endpoints: one for the certificate revocation request submission and one for the certificate revocation list retrieval.
Since the certificate revocation list needs to be signed, the revocation process integrates with the HSM signing service. The certificate revocation list signing process requires human interaction and there is a separate tool designed for that purpose. Once signed the certificate revocation list replaces the current one.
Note: It is assumed that the signed certificate revocation list is always available - even if it’s empty.
HTTP certificate revocation protocol
The set of REST end-points for the revocation service are as follows.
Submission of the certificate revocation requests expects the following fields to be present in the request payload:
certificateSerialNumber: Serial number of the certificate that is to be revoked.
csrRequestId: Certificate signing request identifier associated with the certificate that is to be revoked.
legalName: Legal name associated with the certificate that is to be revoked.
reason: Revocation reason (as specified in the java.security.cert.CRLReason). The following values are allowed.
UNSPECIFIED: This reason indicates that it is unspecified as to why the certificate has been revoked.
KEY_COMPROMISE: This reason indicates that it is known or suspected that the certificate subject’s private key has been compromised. It applies to end-entity certificates only.
CA_COMPROMISE: This reason indicates that it is known or suspected that the certificate subject’s private key has been compromised. It applies to certificate authority (CA) certificates only.
AFFILIATION_CHANGED: This reason indicates that the subject’s name or other information has changed.
SUPERSEDED: This reason indicates that the certificate has been superseded.
CESSATION_OF_OPERATION: This reason indicates that the certificate is no longer needed.
PRIVILEGE_WITHDRAWN: This reason indicates that the privileges granted to the subject of the certificate have been withdrawn.
reporter: Issuer of this certificate revocation request.
Was this page helpful?
Thanks for your feedback!
Chat with us
Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.
Propose documentation improvements directly
Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.
We're sorry this page wasn't helpful. Let us know how we can make it better!
Chat with us
Create an issue
Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.