Using Online Certificate Status Protocol (OCSP) with CockroachDB

On this page

Warning:

CockroachDB v22.1 is no longer supported as of November 24, 2023. For more details, refer to the Release Support Policy.

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

To enable certificate revocation using your OCSP service:

Ensure that your Certificate Authority sets the OCSP server address in the authorityInfoAccess field in the certificate.
Set the cluster setting security.ocsp.mode to lax (by default, the cluster setting is set to off).
```
  > SHOW CLUSTER SETTING security.ocsp.mode;
```
```
  security.ocsp.mode
  ----------------------
  off
  (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.

Note:
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.

Was this helpful?