Skip to content

feat: Clarifies CRL format#188

Open
NeedleInAJayStack wants to merge 1 commit intonginx:mainfrom
NeedleInAJayStack:docs/ssl-crl
Open

feat: Clarifies CRL format#188
NeedleInAJayStack wants to merge 1 commit intonginx:mainfrom
NeedleInAJayStack:docs/ssl-crl

Conversation

@NeedleInAJayStack
Copy link
Copy Markdown

@NeedleInAJayStack NeedleInAJayStack commented Oct 9, 2025

Proposed changes

closes #187

The ssl_crl documentation does not mention that a revocation list is required for every certificate in the certificate chain, which can cause confusion when using intermediate CAs. This forum post, this ticket and this stackoverflow that specify this requirement, but it seems like it would convenient to have it more visible in the official documentation.

Checklist

Before creating a PR, run through this checklist and mark each as complete:

Comment on lines +450 to +451
client certificates.
client certificates. If provided, a CRL must be included for each
certificate in the certificate chain.
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar documentation exists in:

  • ngx_mgmt_module
  • ngx_http_grpc_module
  • ngx_http_oidc_module
  • ngx_http_proxy_module
  • ngx_http_uwsgi_module
  • ngx_mail_ssl_module
  • ngx_stream_proxy_module
  • ngx_stream_ssl_module
  • ngx_stream_zone_sync_module

Would it be good to make this change in those places as well?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IMHO, it looks somewhat ambiguous wrt "each certificate", what about:

When using intermediate certificates, their CRLs should be specified in the same file.

(akin to the wording in ssl_certificate)

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh nice. Yeah, I like that wording more. Updated.

This is just to help clarify that the CRL input must match the certificate chain, which was discovered from this stackoverflow: https://stackoverflow.com/questions/17086934/nginx-unable-to-get-certificate-crl
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CRL format is explained in more detail

2 participants