跳到主要内容
基础知识

CRL 吊销列表怎么配置与排查?OpenSSL、Nginx 与 Apache 实操指南

crl 吊销列表 — 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 个动作。

  1. 准备 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
  2. 吊销目标证书。 -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
  3. 重新生成并校验。 每次吊销后必须重跑 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
  4. 部署文件。 权限 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/。
  5. 启用校验。 三者都要同时给出 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
  6. 重载并回归。 用未吊销和已吊销证书各测一次:
    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 拦截。

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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。