Using Online Certificate Status Protocol (OCSP) with CockroachDB

On this page Carat arrow pointing down
Cockroach Labs will stop providing Assistance Support for v22.1 on November 24, 2023. Prior to that date, upgrade to a more recent version to continue receiving support. For more details, see the Release Support Policy.

CockroachDB Self-Hosted supports Online Certificate Status Protocol (OCSP) for certificate revocation.

Read more about Public Key Infrastructure (PKI) and Transport Layer Security (TLS) in CockroachDB.

To enable certificate revocation using your OCSP service:

  1. Ensure that your Certificate Authority sets the OCSP server address in the authorityInfoAccess field in the certificate.
  2. Set the cluster setting security.ocsp.mode to lax (by default, the cluster setting is set to off).


      > SHOW CLUSTER SETTING security.ocsp.mode;
      (1 row)
      Server Execution Time: 56µs
      Network Latency: 181µs


      > SET CLUSTER SETTING security.ocsp.mode = lax;

    For production clusters, we recommend that you set security.ocsp.mode to strict, but only after verifying the configuration with it set to lax.

    In the strict mode, all certificates are presumed to be invalid if the OCSP server is not reachable. Setting the cluster setting security.ocsp.mode to strict will lock you out of your CockroachDB database if your OCSP server is unavailable.

Yes No
On this page

Yes No