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
You can’t change the validity of a CA that has expired. Renew the CA first.
- Infisical UI
- API
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.
- Infisical UI
- API
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://orhttps://. - URL changes apply only to certificates issued after the update. Existing certificates aren’t affected.
Configure CRL mirrors
- Infisical UI
- API
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:<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.