CRL 吊销列表怎么配置与排查?OpenSSL、Nginx 与 Apache 实操指南
CRL 吊销列表是 CA 定期签名发布的已吊销证书序列号清单,服务端或客户端通过校验 CRL 签名、thisUpdate/nextUpdate 和序列号判断证书是否被吊销;生产环境建议 CRL 刷新周期控制在 1-7 天,并配合 OCSP Stapling 或短有效期证书降低延迟。 OpenSSL 3.0+ 可用 `openssl ca -gencrl -config /etc/ssl/openssl.cnf -out ca.crl.pem -crldays 7 -md sha256` 生成 CRL,再用 `openssl crl -in ca.crl.pem -noout -text` 查看 nextUpdate、 revoked 列表和签名算法。 Nginx 1.25 配置 `ssl_crl /etc/nginx/ssl/ca.crl.pem;` 与 `ssl_verify_client on;` 后执行 `nginx -t && nginx -s reload`;据 Nginx 官方文档,ssl_crl 默认 none,更新 CRL 文件后必须 reload 才会重新加载。 Apache 2.4 使用 `SSLCARevocationFile /etc/httpd/ssl/ca.crl.pem` 与 `SSLCARevocationCheck chain`,HAProxy 2.8 在 bind 行加 `crl-file /etc/haproxy/ca.crl.pem verify required`;只放文件不开启校验不会生效。 验证时执行 `openssl verify -crl_check -CAfile ca.pem -CRLfile ca.crl.pem client.pem`,返回 OK 表示未吊销,返回 `error 23 at 0 depth lookup: certificate revoked` 表示序列号命中 CRL。
为什么证书没过期也会被拒绝?CRL 吊销列表到底解决什么问题?
问:证书明明还在有效期内,为什么 Nginx 或客户端还是把它拒了?
答:因为证书验证从来不是”只看 notBefore/notAfter”。一条完整的验证链要同时满足:签名链能回到受信任根、域名(SAN)匹配、时间在有效期内、扩展用途(EKU/KeyUsage)正确,以及该证书没有被签发者在到期前宣告作废。前四项由证书自身静态决定,最后一项必须外部查证——这就是 CRL 吊销列表和 OCSP 存在的原因。据 RFC 5280 第 5 节定义,CRL 是一个由 CA 签名、包含 thisUpdate(发布时间)、nextUpdate(下次更新时间,过期即失效)、revokedCertificates(被吊销证书的序列号列表,含 revocationDate 与可选 reasonCode)等字段的批量结构。私钥泄露、域名归属变更、误签发、内部 CA 人员离职未回收证书,这些事件都发生在 notAfter 之前,只能靠吊销机制止损。
问:客户端是怎么找到 CRL 的?找不到会报什么错?
答:靠证书里的 CRL Distribution Points(CDP)扩展。验证方按 CDP 里的 URI 下载 CRL,然后校验三件事:CA 对 CRL 的签名、thisUpdate/nextUpdate 时间窗口、目标证书序列号是否出现在列表中。任一环节失败就拒绝连接。先用命令确认 CDP 是否存在(OpenSSL 1.1.0+ 均适用):
# 查看证书的 CRL 分发点;若输出为空,说明该证书根本没配 CDP,CRL 校验必然失败
openssl x509 -in client.crt -noout -text | grep -A2 "CRL Distribution Points"
# 典型输出:
# X509v3 CRL Distribution Points:
# Full Name:
# URI:http://crl.example.com/intermediate.crl
问:拿到 CRL 之后怎么自查?
答:下载后解析并验证签名,再用 openssl verify 复现服务端的判断逻辑:
# 1) 解析 CRL:确认签发者、有效期、以及目标序列号是否在册
curl -s -o intermediate.crl http://crl.example.com/intermediate.crl
openssl crl -in intermediate.crl -inform DER -noout -text
# 关键输出:
# Issuer: C=CN, O=Example, CN=Example Intermediate CA
# Last Update: Mar 1 00:00:00 2025 GMT ← thisUpdate
# Next Update: Mar 8 00:00:00 2025 GMT ← nextUpdate,超过即 "CRL has expired"
# Revoked Certificates:
# Serial Number: 3A:7F:... ← 命中即吊销
# 2) 校验 CRL 签名(-verify 需 OpenSSL 1.1.0+;1.0.2 需改用 openssl crl -noout -text 后人工比对)
openssl crl -in intermediate.crl -inform DER -CAfile chain.pem -verify -noout
# 输出 verify OK 才说明 CRL 未被篡改
# 3) 模拟服务端验证,强制走 CRL 检查
openssl verify -crl_check -CRLfile intermediate.crl -CAfile chain.pem client.crt
# 常见真实报错:
# error 23 at 0 depth lookup: certificate revoked ← 序列号命中
# error 3 at 0 depth lookup: unable to get certificate CRL ← CDP 缺失或下载失败
# error 12 at 0 depth lookup: CRL has expired ← nextUpdate 已过
问:CRL 和 OCSP 该选哪个?
答:两者的取舍本质是”批量文件 + 缓存”对”逐张实时查询”:
| 维度 | CRL | OCSP |
|---|---|---|
| 查询粒度 | 整份列表,含该 CA 下全部吊销序列号 | 按单个序列号实时查询 |
| 更新周期 | 通常 1–7 天一次,由 nextUpdate 决定时效 |
秒级,取决于 CA 响应缓存策略 |
| 握手开销 | 无额外请求(可本地缓存),但文件可能达数百 KB–数 MB | 每次验证多一次网络往返;可用 OCSP Stapling 由服务端预取并随握手下发 |
| 隐私 | 不暴露用户访问了哪张证书 | 查询明文暴露序列号,需 OCSP Must-Staple 或代理缓解 |
| 典型配置项 | Nginx ssl_crl、Apache SSLCARevocationFile |
Nginx ssl_stapling on、Apache SSLUseStapling on |
趋势上 CRL 正在回潮:据 Let’s Encrypt 官方公告,其 OCSP 响应服务已于 2025 年 8 月 6 日关闭,全面改为通过 CDP 分发 CRL,这让”CDP 是否可达”重新成为排障重点。
问:我在 Nginx 配了 ssl_crl,为什么浏览器访问毫无变化?
答:这是最常见的误区——ssl_crl 只参与客户端证书验证,也就是 mTLS 场景。不打开 ssl_verify_client(默认 off),CRL 根本不会被加载和匹配。Apache 同理,SSLVerifyClient 默认 none,且 2.4.x 的 SSLCARevocationCheck 默认为 off,必须显式设为 chain 或 leaf:
# Nginx 1.19.0+:ssl_crl 支持在单个文件中堆叠多级 CRL;更早版本只认一个 CRL
ssl_client_certificate /etc/nginx/ca/chain.pem;
ssl_crl /etc/nginx/ca/intermediate.crl;
ssl_verify_client on; # 默认 off;不开这一行,ssl_crl 形同虚设
ssl_verify_depth 2; # 默认 1,链路较深时需放宽
# Apache httpd 2.4.x
SSLCARevocationFile /etc/httpd/ca/intermediate.crl
SSLCARevocationCheck chain # 默认 off,可选 leaf / chain / no_crl_for_cert_ok
SSLVerifyClient require # 默认 none
配置生效后若证书被吊销,Nginx 的 error.log 会出现形如 client SSL certificate verify error: (23:certificate revoked) while reading client request headers 的记录,直接对应 OpenSSL 的 X509_V_ERR_CERT_REVOKED;而 (3:unable to get certificate CRL) 则说明 CDP 拉取失败或本地 CRL 文件路径写错。排查顺序建议固定为:证书是否有 CDP → CRL 是否可下载且签名有效 → nextUpdate 是否过期 → 验证开关是否真的打开。
从吊销到生效:CRL 吊销列表的完整实操步骤怎么走?
问:证书已经 revoke 了,为什么客户端还是能连上? 因为 revoke 只改 CA 数据库里的状态,不重生成 CRL 文件;服务端也未必开启 CRL 校验。据 RFC 5280 §5,CRL 的有效期由 nextUpdate 决定,客户端缓存过期 CRL 后可能按策略放行或直接失败——所以“吊销”和“生效”之间隔着 6 个动作。
- 准备 CA 数据库。 缺任何一项,gencrl 都会失败或生成无效 CRL。OpenSSL 3.0+ 的 default_crl_days 默认 30 天:
# /etc/ssl/openssl.cnf [ CA_default ] dir = /etc/ssl # 基准目录,默认 ./demoCA database = $dir/index.txt # 吊销状态存于此,文件必须已存在 crlnumber = $dir/crlnumber # CRL 序号,保证单调递增,避免客户端缓存旧 CRL default_crl_days = 30 # 未指定 -crldays 时的默认有效期 openssl ca -config /etc/ssl/openssl.cnf -gencrl -out /var/www/crl/ca.crl.pem -crldays 7 -md sha256 - 吊销目标证书。 -crl_reason 取值见 RFC 5280 §5.3.1(keyCompromise、cessationOfOperation 等),省略则为 unspecified。执行后 index.txt 中该序列号首列变 R,但不要删除原证书文件:
openssl ca -config /etc/ssl/openssl.cnf -revoke /etc/ssl/newcerts/1000.pem -crl_reason keyCompromise grep -E '^R' /etc/ssl/index.txt - 重新生成并校验。 每次吊销后必须重跑 gencrl,否则 CRL 内容不变:
openssl ca -config /etc/ssl/openssl.cnf -gencrl -out /var/www/crl/ca.crl.pem -crldays 7 -md sha256 openssl crl -in /var/www/crl/ca.crl.pem -noout -text | head -20 # Last Update: Jul 1 08:00:00 2025 GMT # Next Update: Jul 8 08:00:00 2025 GMT # Revoked Certificates: # Serial Number: 1000 # Revocation Date: Jul 1 07:59:00 2025 GMT - 部署文件。 权限 644、属主 root:root 即可,服务用户只需可读:install -o root -g root -m 644 ca.crl.pem /etc/nginx/ssl/ca.crl.pem。Nginx 放 /etc/nginx/ssl/、Apache 放 /etc/httpd/ssl/、HAProxy 放 /etc/haproxy/。
- 启用校验。 三者都要同时给出 CA 证书与 CRL,只配 CRL 不生效:
# Nginx(ssl_crl 自 0.8.7 起支持,1.19.0 起可指向目录) ssl_client_certificate /etc/nginx/ssl/ca.crt; ssl_crl /etc/nginx/ssl/ca.crl.pem; ssl_verify_client on; # 默认 off ssl_verify_depth 2; # 默认 1,中间 CA 场景需调大 # Apache 2.4+ SSLCACertificateFile /etc/httpd/ssl/ca.crt SSLCARevocationFile /etc/httpd/ssl/ca.crl.pem SSLCARevocationCheck chain # 默认 none,必须显式开启 SSLVerifyClient require # 默认 none # HAProxy 2.1+ bind *:443 ssl crt /etc/haproxy/site.pem ca-file /etc/haproxy/ca.crt crl-file /etc/haproxy/ca.crl.pem verify required - 重载并回归。 用未吊销和已吊销证书各测一次:
nginx -t && nginx -s reload apachectl configtest && systemctl reload httpd haproxy -c -f /etc/haproxy/haproxy.cfg && systemctl reload haproxy openssl s_client -connect example.com:443 -cert revoked.pem -key revoked.key -CAfile ca.crt # verify error:num=23:certificate revoked # Nginx error.log : client SSL certificate verify error: (23:certificate revoked) # Apache error_log: AH02039: Certificate Verification: Error (23): certificate revoked
| 服务端 | 启用 CRL 的关键指令 | 默认值 | 常见坑 |
|---|---|---|---|
| Nginx | ssl_crl | 未设置(不校验) | 只配 ssl_crl 不配 ssl_client_certificate,校验直接跳过 |
| Apache 2.4 | SSLCARevocationCheck chain | none | 写了文件但忘改 none,等于没开 |
| HAProxy 2.1+ | crl-file + verify required | 无 crl-file 即不校验 | crl-file 写在 default-server 而非 bind 行 |
若测试仍然握手成功,按顺序查三点:CRL 的 Next Update 是否已过期(过期 CRL 在严格模式下会被拒绝)、服务是否真的 reload、ssl_verify_depth 是否截断了中间 CA 链——据 OpenSSL 文档,深度不足时链校验提前终止,CRL 检查根本不会走到。
OpenSSL、Nginx、Apache、HAProxy 的 CRL 配置命令怎么写?
OpenSSL 3.0 如何生成与查看 CRL?先说清前提:CRL 不是手工编辑出来的,而是 CA 根据 index.txt 里的吊销记录签名生成的。据 OpenSSL 文档,openssl ca -gencrl 读取 openssl.cnf 中 [CA_default] 指定的 database 与 private_key,因此必须在 CA 主机上执行:
# OpenSSL 3.0(1.1.1 语法一致):生成有效期 7 天的 CRL
openssl ca -config /etc/ssl/openssl.cnf
-gencrl -out /var/www/crl/ca.crl.pem
-crldays 7 -md sha256
# -crldays 7 → Next Update = 生成时刻 + 7 天;也可用 -crlhours/-crlsec
# -md sha256 → 签名摘要算法,OpenSSL 3.0 默认即 sha256
# 查看内容、签名算法与指纹
openssl crl -in /var/www/crl/ca.crl.pem -noout -text -fingerprint -sha256
# 必须确认:Next Update 大于当前时间;Signature Algorithm: sha256WithRSAEncryption
# 若 Next Update 已过期,客户端会直接判定整份 crl 吊销列表失效(RFC 5280 §5)
Nginx 1.25 怎么写?三个指令缺一不可,且必须放在 http 或 server 上下文。据 Nginx 官方文档,ssl_crl 默认值为 none,且文件只在 reload 时读取,运行中替换 CRL 不会热生效:
ssl_client_certificate /etc/nginx/ssl/ca.pem; # 签发客户端证书的 CA 链
ssl_crl /etc/nginx/ssl/ca.crl.pem; # 默认 none,PEM 格式
ssl_verify_client on; # on|off|optional|optional_no_ca
ssl_verify_depth 2; # 默认 1,按链层数调大
# nginx -t && nginx -s reload 后才加载新 CRL
# 被吊销时 error.log 记录:client SSL certificate verify error: (23:certificate revoked)
Apache 2.4.6+ 最容易踩的坑是只放文件、不设检查级别。据 mod_ssl 文档,SSLCARevocationCheck 默认 none,此时 CRL 仅被加载而不参与校验:
SSLVerifyClient require
SSLVerifyDepth 10
SSLCACertificateFile /etc/httpd/ssl/ca.pem
SSLCARevocationFile /etc/httpd/ssl/ca.crl.pem
SSLCARevocationCheck chain # none(默认)|leaf|chain,none 等于不查吊销
# 命中时 error_log:AH02039: Certificate Verification: Error (23): certificate revoked
HAProxy 2.8 的写法更紧凑,所有校验参数集中在 bind 行;crl-file 只接受 PEM 格式,改完用 -c 做语法检查再 reload:
frontend fe_https
bind *:443 ssl crt /etc/haproxy/site.pem ca-file /etc/haproxy/ca.pem
crl-file /etc/haproxy/ca.crl.pem verify required
# haproxy -c -f /etc/haproxy/haproxy.cfg → Configuration file is valid
| 组件 | 核心指令 | 默认值 | CRL 更新后生效方式 |
|---|---|---|---|
| OpenSSL 3.0 | ca -gencrl / crl -text |
无(命令行) | 重新生成并分发文件 |
| Nginx 1.25 | ssl_crl |
none |
必须 reload |
| Apache 2.4 | SSLCARevocationFile + SSLCARevocationCheck |
none |
graceful restart |
| HAProxy 2.8 | crl-file |
未设置即不检查 | reload 或运行时 API |
不动服务端也能自测吗?可以,用 openssl verify 直接模拟校验逻辑,这是排查“配置写了但没生效”最快的手段:
openssl verify -crl_check -CAfile ca.pem -CRLfile ca.crl.pem client.pem
# 正常输出:client.pem: OK
# 被吊销:error 23 at 0 depth lookup: certificate revoked
# 中间链需补 -untrusted chain.pem;要求整条链每级都查用 -crl_check_all
openssl crl -in ca.crl.pem -outform DER -out ca.crl # 仅认 DER 的设备/老防火墙
CRL、OCSP、OCSP Stapling 与短有效期证书怎么选?
先给结论:这五种机制不是互相替代关系,而是”实时性—成本—兼容性”三角上的不同取点。选之前先问自己三个问题:客户端是谁(浏览器 / 你的内网服务 / 嵌入式设备)?能不能出站访问?吊销后多久必须生效?据 RFC 5280 §5,CRL 吊销列表本质上是一份带 thisUpdate / nextUpdate 时间窗的签名清单,它的”延迟”不是缺陷,而是设计上可预测的缓存窗口。
| 方案 | 实时性 | 额外网络请求 | 兼容性 | 运维复杂度 | 典型场景 |
|---|---|---|---|---|---|
| CRL | 1–7 天延迟,取决于 nextUpdate | 下载完整 CRL | 广 | 中 | 内网 mTLS、固定客户端 |
| Delta CRL | 分钟到小时级 | 基础 CRL + 增量 CRL | 有限 | 高 | 大型私有 CA |
| OCSP | 秒级 | 每次查询 | 中,部分客户端行为差异 | 中高 | 公网 Web 过渡方案 |
| OCSP Stapling | 秒级到分钟级 | 服务端缓存,客户端无额外请求 | 需客户端支持 | 中 | 公网 Web 推荐组合 |
| 短有效期证书 | 小时到 90 天 | 无吊销查询 | 广 | 依赖自动化 | 公开站点、ACME |
怎么先看清一张证书到底支持哪些通道?用 OpenSSL(1.1.1 / 3.x 行为一致)三条命令即可:
# 1) 证书里声明的 CRL 分发点与 OCSP 响应者地址
openssl x509 -in server.crt -noout -ocsp_uri -ext crlDistributionPoints
# 2) 强制走 CRL 校验(-crl_check_all 会校验整条链,缺中间 CRL 直接失败)
curl -sO https://ca.example.com/root.crl
openssl verify -crl_check_all -CRLfile root.crl -CAfile chain.pem server.crt
# 吊销时输出:error 23 at 0 depth lookup: certificate revoked
# 3) 看这份 CRL 的"最长过期时间",它就是你的最坏延迟
openssl crl -in root.crl -noout -lastupdate -nextupdate -crlnumber
选型上:内网 mTLS 且客户端固定,优先用 CRL 吊销列表,nextUpdate 设 1–7 天,配合 Nginx ssl_crl 或 Apache SSLCARevocationFile 即可;公网 Web 面向浏览器,优先短有效期证书(Let’s Encrypt 默认 90 天,ACME Renewal Info 可进一步缩短续期抖动)加 OCSP Stapling,CRL 作兜底。若客户端不支持 OCSP 或网络不能出站,CRL 更稳——但要评估体积:10 万条吊销记录时 CRL 文件常达 MB 级,下载带宽与缓存策略要一并算进去。
Delta CRL 适合大型私有 CA,RFC 5280 §5.2.4 定义了 Delta CRL Indicator 扩展(OID 2.5.29.27),但客户端兼容性不如完整 CRL,落地前先做客户端矩阵测试。另一个常见坑是 Nginx 静默忽略 stapling:
# nginx.conf —— ssl_trusted_certificate 必须含签发者证书,否则 stapling 不生效
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/chain.pem;
resolver 223.5.5.5 valid=300s; # 未配 resolver 时 stapling 同样失效
典型告警:ssl_stapling ignored, issuer certificate not found——原因就是 trusted 文件里只有叶子证书。据 Mozilla Server Side TLS 配置指南,CRL 属于 PKI 验证链配置(verification path),与 ssl_protocols 这类 TLS 协议开关是两个层面,别指望改协议版本能解决吊销问题。
成本参考:公开 DV 证书年费常见 0–500 元,企业 OV/EV 常见 1000–10000 元/年;私有 CA 的 CRL 成本主要是发布链路与运维人力,不是证书单价。OCSP 还有一个隐藏风险——软失败(soft-fail):响应者超时后多数客户端默认放行,等于吊销失效,这正是 OCSP Stapling 把查询挪到服务端、可缓存可观测的原因。
配置 CRL 后常见报错有哪些?如何逐条排查?
openssl verify 打印的 error 编号对应 OpenSSL 头文件 x509_vfy.h 里的 X509_V_ERR_* 常量(据 OpenSSL verify(1) 手册),数字本身就是排查线索。按“先本地 verify、再看服务日志”的顺序逐条对照即可。
error 3 at 0 depth lookup: unable to get certificate CRL,为什么本地能过、线上不过?
两种成因:verify 命令没带 CRL,或证书 CDP(CRL Distribution Points)指向的 URL 取不到。先手动带 CRL 复验,再验证 CDP 可达性:
# -crl_check 只查末端证书;-crl_check_all 会连中间 CA 一起查(需每条链都有 CRL)
openssl verify -CAfile ca.pem -CRLfile ca.crl.pem -crl_check client.pem
# 打印证书内嵌的 CDP 地址,确认它真的能下载
openssl x509 -in client.pem -noout -ext crlDistributionPoints
curl -sI http://crl.example.com/ca.crl | head -1 # 期望 HTTP/1.1 200
error 12 at 0 depth lookup: CRL has expired,怎么续期?
CRL 的 nextUpdate 已过(RFC 5280 §5.1.2.5 规定它是 CRL 有效期上界),校验方会直接判定 CRL 失效。查看并重新生成:
openssl crl -in ca.crl.pem -noout -lastupdate -nextupdate
# -crldays 默认取 openssl.cnf 中 default_crl_days(OpenSSL 示例配置为 30 天)
openssl ca -config /etc/pki/CA/openssl.cnf -gencrl -crldays 7 -out ca.crl.pem
openssl crl -in ca.crl.pem -noout -nextupdate # 确认新日期
nginx -s reload # 或 apachectl graceful
error 23 at 0 depth lookup: certificate revoked,是误吊销吗?
序列号确实命中 CRL。取证书序列号与 CRL 条目逐字节对比(注意大小写与冒号格式差异):
openssl x509 -in client.pem -noout -serial
openssl crl -in ca.crl.pem -noout -text | grep -A1 "Serial Number"
Nginx 报 cannot load certificate revocation list 怎么办?
ssl_crl 自 nginx 0.8.7 起可用,路径为相对路径时相对编译前缀。该报错只有四种成因:路径错、文件不是 PEM、权限不足、SELinux 拦截。
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
namei -l /etc/nginx/ssl/ca.crl.pem # 逐级检查 o+r 是否贯通
openssl crl -in /etc/nginx/ssl/ca.crl.pem -noout -text | head -3 # 能解析即 PEM
getenforce; ls -lZ /etc/nginx/ssl/ca.crl.pem # Enforcing 时看 context
Apache 报 AH02039: Certificate Verification: Error (23): certificate revoked?
说明客户端证书确实被吊销。SSLCARevocationCheck 在 2.4 中默认 none,可选 leaf、chain、leaf+chain。误报通常是 CRL 陈旧或检查范围过宽——chain 要求链上每个 CA 都有 CRL,缺一个就会退化成 error 3;可先用 openssl verify -crl_check_all 复现,再把范围收窄到 leaf。
HAProxy 日志只有 SSL handshake failure、后端 503?
bind 行的 verify required 与 crl-file 必须同时存在,缺一则 CRL 不生效;已吊销客户端在握手阶段即被拒,因此不会产生后端访问日志。用 haproxy -c -f /etc/haproxy/haproxy.cfg 确认 CRL 文件已成功加载,再用 echo "show info" | socat stdio /var/run/haproxy/admin.sock 观察握手失败计数。
| 报错 | 语义 | 首选命令 |
|---|---|---|
| error 3 | 拿不到 CRL | openssl verify -CRLfile … -crl_check |
| error 12 | CRL 过期 | openssl crl -noout -nextupdate |
| error 23 | 证书已吊销 | openssl x509 -noout -serial |
| AH02039 (23) | mod_ssl 吊销校验失败 | 核对 SSLCARevocationCheck |
怎么验证 CRL 吊销列表已经生效?
先别急着抓包看客户端,第一步是确认 CRL 文件本身还”活着”。据 RFC 5280 第 5 节,CRL 必须携带 nextUpdate,过期的 CRL 不应被依赖;OpenSSL 3.x 与 1.1.1 都提供只读的打印选项:
# 只看元数据,不修改文件;-crlnumber 打印的是 CRL Number 扩展
openssl crl -in ca.crl.pem -noout -lastupdate -nextupdate -crlnumber
# lastUpdate=Jul 1 00:00:00 2025 GMT
# nextUpdate=Jul 8 00:00:00 2025 GMT
# CRLNumber=1284
date -u # 与上面的 GMT 时间对比,别用本地时区误判
判定只有两条:nextUpdate 晚于当前时间;CRL Number 每次发布都递增。据 RFC 5280 §5.2.3,CRL Number 是单调递增整数,客户端靠它判断新旧。如果编号没变而你确信已重新签发,多半是签发脚本写到了别的路径,或生成的是空 CRL。
第二步用 openssl verify 做离线判定,这一步比任何日志都干净:
# -crl_check 只检查叶子证书,-crl_check_all 检查整条链;两者默认都不开启
openssl verify -crl_check -CAfile ca.pem -CRLfile ca.crl.pem good.pem
# good.pem: OK
# 有中间 CA 时必须用 -untrusted 提供中间证书,否则报 unable to get certificate CRL
openssl verify -crl_check_all -CAfile ca.pem -untrusted chain.pem -CRLfile ca.crl.pem good.pem
# 换成已吊销的证书
openssl verify -crl_check -CAfile ca.pem -CRLfile ca.crl.pem revoked.pem
# CN=revoked-client
# error 23 at 0 depth lookup: certificate revoked
# error revoked.pem: verification failed
error 23 就是 OpenSSL 文档里的 X509_V_ERR_CERT_REVOKED。如果换成 revoked.pem 仍返回 OK,只有两种解释:CRL 里没有该序列号(用 openssl crl -in ca.crl.pem -text -noout 找 Serial Number 确认),或你手上/服务端加载的是旧文件。
第三步端到端,让握手自己说话:
# 服务端需已开启客户端证书校验,例如 nginx: ssl_verify_client on;
curl -v --cert client.pem --key client.key --cacert ca.pem https://example.com/
# 正常:HTTP/2 200
# 吊销后:OpenSSL SSL_read: ... alert certificate revoked,或 curl: (56) 连接被重置
注意 --cacert 只校验服务端证书;客户端证书被拒时握手在 HTTP 之前就失败,所以你看到的是 TLS alert 而不是 4xx 状态码。
第四步看服务端变量,把”没生效”和”没走到”区分开:
# nginx:$ssl_client_verify 取值 SUCCESS / NONE / FAILED:reason
log_format ssl '$remote_addr "$ssl_client_verify" $ssl_client_s_dn';
access_log /var/log/nginx/ssl.log ssl;
# Apache httpd + mod_ssl:%{SSL_CLIENT_VERIFY}x,取值 SUCCESS / NONE / FAILED:reason / GENEROUS
LogFormat "%h %{SSL_CLIENT_VERIFY}x %{SSL_CLIENT_S_DN}x" ssl_access
| 组件 | 观测点 | 成功值 | 吊销后的值 |
|---|---|---|---|
| Nginx | $ssl_client_verify |
SUCCESS |
FAILED:certificate revoked |
| Apache | %{SSL_CLIENT_VERIFY}x |
SUCCESS |
FAILED:certificate revoked |
| HAProxy | ssl_c_verify / ssl_fc_has_crt |
0 / 1 | 23 / 1(has_crt 只表示”提供了证书”,不能当吊销结论) |
最后别忘了缓存。CDN 或反向代理缓存了旧 CRL,会让上面所有检查都”看起来正常”:
curl -I https://ca.example.com/ca.crl
# cache-control: max-age=86400
# age: 3600
# last-modified: Tue, 01 Jul 2025 00:00:00 GMT
把 max-age 与 nextUpdate 的剩余时间对齐——max-age 大于剩余有效期,就会出现”旧 CRL 尚未过期、新 CRL 已发布”的盲区;Age 头则直接告诉你手上这份副本有多旧。OCSP 响应(nextUpdate 字段同理)和 Nginx 的 ssl_crl 文件都建议在发布流程中配合 reload 一起刷新。
生产环境如何自动刷新、缓存和监控 CRL?
CRL 不是”配一次就完事”的静态文件——它带 nextUpdate 保鲜期,过期后严格校验的客户端(如 OpenSSL -crl_check、Nginx ssl_crl)会直接判定”无法确认吊销状态”而拒绝连接。所以生产环境必须把 定时重签 + 原子发布 + 主动监控 三件事闭环。下面按运维最常搜的几个问题展开。
CRL 应该多久刷新一次?default_crl_days 默认是多少?
据 OpenSSL 的 openssl-ca(1) 手册,default_crl_days 默认值为 30 天,这是示例 openssl.cnf 里最容易被忽略的坑:吊销一张被泄露的私钥后,客户端最长要等 30 天才看到。建议改成 7,并把重签任务放到每 6 小时一次的 cron 上——nextUpdate 决定的是客户端缓存上限,生成频率决定你多快能把新吊销塞进去,两者都短才安全。据 RFC 5280 §5.1.2.5,nextUpdate 缺失时校验方行为未定义,务必显式设置。
# /etc/ssl/openssl.cnf —— 仅列出需要改的行
[ CA_default ]
default_crl_days = 7 # 默认 30;生产建议 7,不要超过 30
crl_extensions = crl_ext # 保留 crlNumber 扩展,监控要靠它
# 每 6 小时重签一次
0 */6 * * * /usr/local/bin/refresh-crl.sh >> /var/log/crl-refresh.log 2>&1
怎么避免 Nginx 读到”写了一半”的 CRL 文件?
直接把 -gencrl 输出到线上路径,reload 与写文件并发时会加载到截断的 PEM,表现为 cannot load certificate revocation list。标准做法是同目录写 .tmp、验签、再 mv(同文件系统内 mv 是原子 rename(2)),最后才 reload。
#!/usr/bin/env bash
# /usr/local/bin/refresh-crl.sh
set -euo pipefail
CA=/etc/ssl/ca
NEW="$CA/ca.crl.pem.tmp"
openssl ca -config /etc/ssl/openssl.cnf -gencrl -out "$NEW"
# 1) 用 CA 公钥验证签名,失败则 set -e 退出,线上文件不受影响
openssl crl -in "$NEW" -noout -verify -CAfile "$CA/ca.pem"
# 2) 打印 nextUpdate 与 crlNumber,便于日志审计
openssl crl -in "$NEW" -noout -nextupdate -crlnumber
install -m 644 "$NEW" "$CA/ca.crl.pem.new" # 644:Nginx worker 需可读
mv "$CA/ca.crl.pem.new" "$CA/ca.crl.pem" # 原子替换
rm -f "$NEW"
nginx -t && systemctl reload nginx
# Apache 对应:apachectl -t && systemctl reload httpd
监控到底该盯哪几个指标?
| 监控项 | 采集命令 | 告警阈值 |
| 文件 mtime | stat -c %Y /etc/nginx/ssl/ca.crl.pem |
超过 8 小时未变(刷新间隔 6h)即告警,说明 cron 挂了 |
| nextUpdate 剩余 | date -d "$(openssl crl -in ca.crl.pem -noout -nextupdate | cut -d= -f2)" +%s |
剩余 < 24h 预警,< 1h 升级为 P1 |
| crlNumber 递增 | openssl crl -in ca.crl.pem -noout -crlnumber |
与上一周期记录比对,未递增说明签发了同一份 |
| HTTP 分发可用性 | curl -sI -w '%{http_code} %{content_type}n' -o /dev/null https://pki.example.com/ca.crl |
非 200,或 Content-Type 不是 application/pkix-crl |
最后一项常被忽略:CRL 的 crlDistributionPoints 指向 HTTP URL 时,客户端按 MIME 类型解析,返回 text/plain 会导致部分 Java/Windows 客户端缓存失败。Nginx 侧加 types { application/pkix-crl crl; } 或 default_type application/pkix-crl;。
reload 报 cannot load certificate revocation list 怎么办?
九成是权限或 SELinux,而不是 CRL 内容。先看真实报错:
nginx: [emerg] cannot load certificate revocation list "/etc/nginx/ssl/ca.crl.pem"
(SSL: error:8000000D:system library::Permission denied)
排查顺序:stat -c '%a %U' /etc/nginx/ssl/ca.crl.pem 应为 644 root;若权限正确仍失败,用 ausearch -m avc -ts recent 确认是 SELinux 拦截,再打标签:
# 方式一:临时验证
chcon -t httpd_config_t /etc/nginx/ssl/ca.crl.pem
# 方式二:持久化(推荐,重启/relabel 后仍生效)
semanage fcontext -a -t httpd_config_t "/etc/nginx/ssl(/.*)?"
restorecon -Rv /etc/nginx/ssl
变更窗口怎么排?出问题怎么回滚?
CRL 更新属于”配置类变更”,不要一次全量 reload。先在一台节点替换并 reload,跑回归:
# 正例:未吊销的叶子证书应返回 OK
openssl verify -CAfile ca.pem -CRLfile ca.crl.pem -crl_check leaf.pem
# 反例:已吊销证书应输出 "certificate revoked"(error 23)
openssl verify -CAfile ca.pem -CRLfile ca.crl.pem -crl_check revoked.pem
两条都符合预期后再滚动到其余节点,并把上一版保存为 ca.crl.pem.prev,至少保留 1 个发布周期——回滚只需 mv 回去再 reload,比重新签一份快得多。注意 Nginx 的 ssl_crl 指令(ngx_http_ssl_module,0.8.7 起可用)和 Apache 的 SSLCARevocationFile(mod_ssl)都只在 reload 时重新读取,运行中修改文件不会生效,这也是”原子替换 + reload”必须成对出现的原因。
CRL 是 CA 定期签发的批量文件,延迟取决于 nextUpdate,常见 1-7 天;OCSP 按证书序列号实时查询,每次握手多一次网络请求。内网 mTLS 且客户端固定可优先 CRL,公网 Web 更常见的是短有效期证书配合 OCSP Stapling,CRL 作为兜底。
先确认同时配置了 `ssl_client_certificate` 和 `ssl_verify_client on`,否则 CRL 不会参与客户端证书校验。再确认 CRL 文件为 PEM、nextUpdate 未过期、目标序列号确实在 revoked 列表中,并执行 `nginx -t && nginx -s reload`。
生产环境建议 1-7 天更新一次,私有 CA 可用脚本每天或每 6 小时执行 `openssl ca -gencrl`。nextUpdate 过期后 openssl verify 会报 `error 12 at 0 depth lookup: CRL has expired`,服务端可能直接拒绝客户端证书。
这个报错通常表示验证时没有提供 CRL,或证书 CDP 指向的 URL 不可达。先加 `-CRLfile ca.crl.pem`,有中间 CA 时再加 `-untrusted chain.pem`,然后检查 CDP 地址是否返回 200。
证书有效期和吊销状态是两件事,证书在 notAfter 之前仍可能因私钥泄露、误签发或人员离职被 CA 吊销。服务端校验 CRL 时按序列号匹配,命中后返回 `error 23 at 0 depth lookup: certificate revoked`。
不一定。据 Apache mod_ssl 文档,`SSLCARevocationCheck` 默认 none,只配置 `SSLCARevocationFile` 不会执行吊销检查。需要显式设置 `SSLCARevocationCheck leaf` 或 `chain`,再 reload Apache。
在 bind 行写 `ssl crt /etc/haproxy/site.pem ca-file /etc/haproxy/ca.pem crl-file /etc/haproxy/ca.crl.pem verify required`,然后执行 `haproxy -c -f /etc/haproxy/haproxy.cfg` 检查配置并 reload。更新 CRL 后需确认新文件已加载,再用已吊销客户端证书做握手测试。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。