Skip to main content
Each internal CA has a certificate revocation list (CRL), a signed list of the certificates the CA has revoked. Validators download the CRL to check whether a certificate is still trusted. This page covers CRL validity, regenerating a CRL, and CRL mirror URLs.
This page is for product admins who manage internal CAs. The default CRL settings work for most CAs.

Set the CRL validity

Each CRL carries a next update time. Clients treat a CRL as current until that time and fetch a new one after it. The CRL is regenerated automatically before that time, until the CA certificate expires. A CA’s CRLs are valid for 7 days by default, and you can set any whole number of days from 1 to 365:
  • Use a longer validity, such as 30 days, if clients are often offline and can’t fetch a new CRL every few days
  • Use a shorter validity, such as 1 day, if clients are always online and need to see revocations sooner
Changing the validity regenerates the CRL right away. If the CA certificate expires before the validity period ends, the CRL’s next update time is the CA certificate’s expiry instead. A validity other than 7 days requires the Enterprise plan.
You can’t change the validity of a CA that has expired. Renew the CA first.
When you create an internal CA, set CRL Validity (Days) in the Distribution step. To change it on an existing CA:
1
Go to Certificate Manager → Certificate Authorities → Internal and select your CA.
2
Select the pencil icon on the Revocation card.
3
Enter the number of days in CRL Validity (Days) and select Save.

Regenerate a CRL

CRLs are regenerated automatically. Regenerate one yourself when you need a fresh copy with a full validity period, for example before you copy the CRL to clients on an offline network. The new CRL replaces the current one at the same URL and gets a higher CRL number. CRL numbers are based on the signing time, so they keep increasing after you restore Infisical from a backup. Regenerating a CRL requires the Enterprise plan. Only Product Admins can regenerate a CRL.
Regenerate CRL is unavailable for a CA that’s waiting for its certificate or has expired.
1
Go to Certificate Manager → Certificate Authorities → Internal and select your CA.
2
Select Regenerate CRL on the CA Certificate Revocation Lists (CRLs) card, then select Regenerate CRL to confirm.

CRL distribution points

Every certificate issued by an internal CA embeds a CRL Distribution Point (CDP) extension that tells validators where to fetch the CRL. You can register additional mirror URLs at the CA level so validators have fallback locations if the primary endpoint is unreachable.
  • The Infisical-managed URL is included as the primary CDP by default. It can be disabled per CA.
  • Up to 4 mirror URLs can be configured per CA.
  • URLs must use http:// or https://.
  • URL changes apply only to certificates issued after the update. Existing certificates aren’t affected.
Infisical only advertises the mirror URLs in issued certificates. It doesn’t publish your CRL to them. You’re responsible for fetching the latest CRL from Infisical and serving an up-to-date copy at every mirror URL you register. If a mirror serves a stale CRL, validators that fall back to it will get outdated revocation information and may continue to trust certificates you have already revoked.

Configure CRL mirrors

Mirror URLs can be configured at CA creation time or any time after via the Revocation card on the CA detail page.
1

Navigate to CA details

Go to Certificate Manager → Certificate Authorities → Internal and select your CA.
2

Edit revocation settings

Select the pencil icon on the Revocation card.
3

Add mirror URLs

Add one URL per row, in order of preference (clients try them in the listed order).
4

Disable managed CRL URL (optional)

Toggle Disable managed CRL URL to exclude the Infisical-managed CRL endpoint from issued certificates. This is useful when the Infisical instance is not reachable by certificate consumers.

Keeping mirrors in sync

Each CA’s CRL is regenerated whenever a certificate is revoked, and again before the current CRL reaches its next update time, until the CA certificate expires. To keep your mirrors useful, pull the latest CRL on a schedule and republish it at each mirror URL.

Fetch the current CRL

The current CRL is served in DER format at the Distribution Point URL on the CA Certificate Revocation Lists (CRLs) card. Download it and write it to your mirror destination using your preferred sync method:
To look up <crl-id> with the API, call the List CRLs endpoint and use the id of the entry.
Run this on a cron schedule that’s well within the CRL validity, such as every few hours, so mirrors never serve a stale or expired CRL to validators.

Example: Sync to S3

What’s next?

CA Renewal

Renew your CA certificates before expiry.

Certificate Policies

Define rules for certificate issuance.