亚洲诚信通配符证书续期与私钥轮换怎么做?OpenSSL 3.2、DNS-01 与 Nginx 1.26 灰度替换指南
亚洲诚信通配符证书续期的关键是提前 30 天生成新私钥与 CSR,用 DNS-01 TXT 完成 DCV,在 Nginx 1.26 上先灰度 reload 再切换流量,并核对 serial、SAN 与 OCSP 状态;公网 TLS 证书单次有效期按 398 天上限规划。 通配符只覆盖一级子域:`*.example.com` 匹配 `www.example.com`,不匹配 `a.b.example.com`;据 RFC 6125 与 CA/B Forum 通配符规则,多级子域要用 SAN 或拆分证书。 私钥轮换不要复用旧 key:OpenSSL 3.2.1 可用 `openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:3072` 生成新私钥,文件权限设为 `600`,旧 key 在全量切换后 24–48 小时退役。 Nginx 1.26.0 配置中 `ssl_certificate` 应放 leaf+intermediate 链,`ssl_certificate_key` 指向新私钥;`nginx -t && nginx -s reload` 后用 `openssl s_client -servername` 比对 serial 与 notAfter。 监控要同时看到期时间、serial 变化与 OCSP:Zabbix 7.0 可用 `UserParameter` 每 5 分钟采集 `notAfter`,提前 30/14/7 天告警,避免只监控 443 端口存活。
亚洲诚信通配符证书续期为什么容易在凌晨触发告警?
问:为什么证书明明续期成功,凌晨两点还是收到告警?
答:因为绝大多数”续期失败”并不是签发环节失败,而是验证、部署、监控三段链路中有一环被误判。下面是六个高频原因,每条都附可执行的复现命令。
1. 通配符到底覆盖几级子域?
据 RFC 6125 §6.4.3 与 CA/Browser Forum 基线要求(BR 3.2.2.6),通配符只匹配一个标签,不能跨多级。亚洲诚信 通配符证书通常签发给 *.example.com,续期时新增的 api.dev.example.com 不会自动进入 SAN,Chrome 直接抛 NET::ERR_CERT_COMMON_NAME_INVALID,OpenSSL 报 verify error:num=62:hostname mismatch。用 openssl verify(1.1.0+ 支持 -verify_hostname)可离线验证:
# 打印 SAN,确认新域名是否在证书里(OpenSSL 3.2 支持 -ext subjectAltName)
openssl x509 -in example.com.fullchain.pem -noout -subject -dates -ext subjectAltName
# 按 RFC 6125 规则校验主机名,mismatch 即说明 SAN 未覆盖
openssl verify -verify_hostname api.dev.example.com
-CAfile example.com.chain.pem example.com.cert.pem
# 预期输出:error 62 at 0 depth lookup: hostname mismatch
| 请求主机名 | *.example.com 是否匹配 |
正确做法 |
|---|---|---|
www.example.com |
匹配 | 无需额外 SAN |
example.com(裸域) |
不匹配 | 单独列入 SAN,多数 CA 免费附带 |
api.dev.example.com |
不匹配 | 另签 *.dev.example.com 或加 SAN |
a.b.example.com |
不匹配 | 同上,多级永不通配 |
2. DCV 为什么在凌晨卡住?
据 TrustAsia 与 Let’s Encrypt 文档,DV/OV 续期仍需 DNS TXT 或 HTTP-01 文件验证,私钥不会自动完成域名控制权校验。若 DNS 记录 TTL 设为 600 秒,公共递归缓存刷新常需 5–30 分钟,凌晨批量变更极易在 TXT 尚未生效时触发”验证失败”告警。签发前先自查:
# 分别向权威 NS 与公共递归查询,对比 TXT 是否一致
dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _dnsauth.example.com @ns1.example-dns.com
# TTL 会打印在完整输出中,600 即 10 分钟传播下限
dig TXT _dnsauth.example.com | grep -E '^_dnsauth.*INs+TXT'
3. 私钥真的换了吗?
不少团队只替换 fullchain.pem,ssl_certificate_key 仍指向两年前的旧 key。旧 key 一旦泄露,续期毫无意义,也不满足季度或年度密钥轮换策略。用公钥指纹比对,两者一致才说明匹配:
openssl x509 -in example.com.cert.pem -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
# 两行哈希必须完全相同,否则 Nginx 启动报
# SSL_CTX_use_PrivateKey ... key values mismatch
4. 为什么 curl 看到的还是旧证书?
Nginx 1.26.0 中,不带 SNI 的请求会落到 listen 443 default_server 的虚拟主机。直接 curl https://IP 拿到的是默认站点证书,会误判为续期失败。必须显式带上 SNI 再核对:
# 带 SNI,读取真实虚拟主机的证书
openssl s_client -connect 10.0.0.5:443 -servername www.example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -serial -enddate -ext subjectAltName
# 对比:-noservername 走 default_server,结果不同即说明 SNI 分流正常
5. 监控只测端口存活够吗?
不够。TCP connect 443 成功只证明进程在跑,无法发现证书过期或链缺失。应采集 notAfter、serial、SAN 与 OCSP 状态,提前 30 天进入处理窗口。上一条命令的输出即可作为采集源,配合 openssl x509 -checkend 2592000(30 天,秒为单位)做退出码判断。
6. 链与 OCSP stapling 缺什么?
若 ssl_certificate 只放 leaf 证书,部分客户端报 unable to get local issuer certificate;OCSP stapling 缺少 ssl_trusted_certificate 时,Nginx error.log 会出现 ssl_stapling ignored, issuer certificate not found。Nginx 1.26.0 中 ssl_stapling 与 ssl_stapling_verify 默认均为 off,需显式开启:
server {
listen 443 ssl default_server;
server_name www.example.com;
# leaf + 中间证书,顺序不可颠倒
ssl_certificate /etc/nginx/ssl/example.com.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
# 仅中间证书,供 stapling 校验用;缺失即触发 ssl_stapling ignored
ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 valid=300s;
}
改完先 nginx -t 再灰度 nginx -s reload,并在 reload 后用第 4 条命令复核 serial 是否已变——这才是判断”续期是否真正生效”的唯一可靠信号。
亚洲诚信通配符证书的续期不是”重新下单”这么简单——真正的风险点在私钥轮换与灰度替换之间的窗口期。下面这套 6 步流程在 OpenSSL 3.2.1 + Nginx 1.26 环境验证过,可直接作为变更单模板使用。
步骤 1:T-30 天盘点证书,先把现状钉死。不要凭记忆判断到期日,直接读证书本体:
# 一次性取出主体、签发者、有效期、序列号与 SAN,作为变更单基线
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout
-subject -issuer -dates -serial -ext subjectAltName
# 输出示例(关键行)
# notBefore=Apr 12 00:00:00 2025 GMT
# notAfter=Apr 11 23:59:59 2026 GMT
# serial=0A:3F:...(十六进制,用于灰度比对)
# X509v3 Subject Alternative Name:
# DNS:*.example.com, DNS:example.com
把 serial、notAfter、SAN 列表、OCSP/CRL 地址和所有部署节点(含 CDN 回源节点)记进变更单,同时写明续期窗口、DCV 方式与回滚证书路径。据 Let’s Encrypt 的《Why ninety days》说明,缩短证书生命周期正是为了压缩密钥泄露后的暴露窗口——所以”续期”应当默认包含”换私钥”。
步骤 2:生成新私钥,不要复用旧 key。OpenSSL 3.2 起 genpkey 是推荐入口(genrsa 仍可用但已非首选)。RSA 默认 rsa_keygen_bits 为 2048,这里显式提到 3072:
# RSA 3072:兼容性最好,握手稍慢
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:3072
-out /etc/nginx/ssl/example.com-202605.key
# 若 CA 支持 ECDSA(亚洲诚信部分品牌支持),P-256 体积小、握手快
openssl ecparam -name prime256v1 -genkey -noout
-out /etc/nginx/ssl/example.com-202605.key
chmod 600 /etc/nginx/ssl/example.com-202605.key
chown root:root /etc/nginx/ssl/example.com-202605.key
| 私钥算法 | 密钥/签名体积 | Nginx 1.26 兼容性 | 适用场景 |
|---|---|---|---|
| RSA 2048(默认) | 约 1.2 KB | 全兼容 | 老旧客户端多 |
| RSA 3072 | 约 1.7 KB | 全兼容 | 合规要求 ≥3072 位 |
| ECDSA P-256 | 约 0.3 KB | 需 OpenSSL 1.0.2+ | 移动端占比高 |
步骤 3:生成带 SAN 的 CSR,SAN 必须与订单逐字一致。据 OpenSSL 3.2 的 req 手册,-addext 会把扩展直接写入 CSR 请求体,省去手写 openssl.cnf:
openssl req -new -key /etc/nginx/ssl/example.com-202605.key
-subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example Tech Co., Ltd./CN=*.example.com'
-addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
-out /etc/nginx/ssl/example.com-202605.csr
# 自检:确认 CSR 里 SAN 与 CN 都对
openssl req -in /etc/nginx/ssl/example.com-202605.csr -noout -text | grep -A1 'Subject Alternative'
步骤 4:提交续期并完成 DCV。在亚洲诚信控制台选择续期,按提示为 _dnsauth.example.com 添加 TXT 记录,TTL 设 600 秒(便于失败后快速重试)。务必双解析器验证,避免单点缓存误判:
dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _dnsauth.example.com @223.5.5.5
# 两条输出应完全一致,且不含多余引号拼接错误
按行业通行节奏,DV 通常 5–15 分钟签发,OV 需人工核验,常见 1–3 个工作日——这也是为什么要 T-30 天启动。
步骤 5:下载证书包并校验证书链。Nginx 的 ssl_certificate 必须放 leaf + intermediate 的拼接链,顺序错会触发浏览器 NET::ERR_CERT_AUTHORITY_INVALID:
cat example.com.crt intermediate.crt > fullchain-202605.pem
# 返回 OK 才允许进入部署环节
openssl verify -CAfile ca-bundle.crt -untrusted intermediate.crt fullchain-202605.pem
# 复核 SAN 与有效期
openssl x509 -in fullchain-202605.pem -noout -ext subjectAltName -dates
步骤 6:灰度替换并退役旧私钥。先在 canary 节点替换并比对 serial:
nginx -t && nginx -s reload
# --resolve 绕过 DNS,强制打到灰度节点,看返回证书的 serial 是否为新值
curl --resolve www.example.com:443:10.0.1.23 -vI https://www.example.com 2>&1
| openssl x509 -noout -serial -dates
观察 24–48 小时无告警后再全量;旧私钥不要直接 rm,用 openssl pkcs8 -topk8 -scrypt 加密归档或走介质销毁流程,并同步更新 CMDB 中的证书指纹字段。整套流程的价值在于:亚洲诚信通配符证书的 私钥轮换 与证书替换被拆成两个可回滚的独立动作,任何一步失败都不会造成线上 443 中断。
OpenSSL 3.2 与 Nginx 1.26 的具体配置和命令示例
CSR 怎么生成,才能保证 SAN 同时覆盖泛域名和裸域?
先用 OpenSSL 3.2.1 生成新私钥,再用新私钥签发 CSR;之所以不能复用旧私钥,是因为私钥轮换的核心是假设旧私钥已泄露,而续期不换私钥,就等于没有真正处置泄露风险。命令如下:
# 1) 生成 2048 位 RSA 私钥(OpenSSL 3.2.1,默认生成参数即 2048 位;建议 600 权限)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048
-out /etc/ssl/private/example.com-202605.key
chmod 600 /etc/ssl/private/example.com-202605.key
# 2) 生成 CSR,-addext 直接把 SAN 写进请求(OpenSSL 1.1.1+ 支持,3.2 行为一致)
openssl req -new -key /etc/ssl/private/example.com-202605.key
-subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example Tech Co., Ltd./CN=*.example.com'
-addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
-out /etc/ssl/csr/example.com-202605.csr
# 3) 提交前自检:确认 SAN 与公钥指纹
openssl req -in /etc/ssl/csr/example.com-202605.csr -noout -text | grep -A2 'Subject Alternative Name'
openssl req -in /etc/ssl/csr/example.com-202605.csr -noout -pubkey | openssl sha256
第 3 步正常输出为 DNS:*.example.com, DNS:example.com。注意:亚洲诚信通配符证书默认只签发 *.example.com,裸域通常需在下单时勾选或另行配置;CSR 里写了裸域,并不等于证书一定包含裸域,签发后务必用 openssl x509 -in fullchain.pem -noout -text | grep DNS 复核。
Nginx 1.26.0 里怎么把新证书”灰度”挂上去?
先在 server 块替换证书路径(Nginx 1.26.0 为 2024-04 stable 分支,配置项语义与 1.24 一致):
ssl_certificate /etc/nginx/ssl/example.com.fullchain.pem; # 叶证书+中间证书,顺序不可颠倒
ssl_certificate_key /etc/nginx/ssl/example.com-202605.key; # 轮换后的新私钥
ssl_protocols TLSv1.2 TLSv1.3; # 与 Mozilla 中间兼容配置一致
ssl_session_cache shared:SSL:10m; # 约 4 万会话
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem; # 仅中间证书,用于校验 OCSP 响应
resolver 223.5.5.5 8.8.8.8 valid=300s; # stapling 需显式 resolver
校验与生效,别用 restart:
nginx -t # 期望:syntax is ok / test is successful
nginx -T | grep -E 'ssl_certificate|ssl_certificate_key|ssl_stapling' # 确认加载的是 202605 路径
systemctl reload nginx # 等价于 nginx -s reload,平滑替换 worker,不掐断存量连接
| nginx -t 报错片段 | 根因 | 处理 |
|---|---|---|
BIO_new_file() failed (SSL: ... No such file or directory) |
路径写错或 SELinux 拒绝读取 | 核对路径;restorecon -Rv /etc/nginx/ssl |
SSL_CTX_use_PrivateKey() failed (SSL: key values mismatch) |
证书与私钥不配对 | 比对 openssl x509 -noout -pubkey 与 openssl pkey -pubout 的 SHA256 |
"ssl_stapling" ignored, issuer certificate not found |
fullchain 里缺中间证书 | 补全链,并配置 ssl_trusted_certificate |
OCSP 装订到底生效没有?按 RFC 6960,OCSP 响应带 This Update/Next Update 有效期,排错时别只看一次请求:
openssl ocsp -issuer intermediate.pem -cert leaf.pem
-url http://ocsp.example-ca.cn -resp_text -noverify
# 关注三行:Cert Status: good / This Update / Next Update
怎么在到期前 30 天就收到告警?Zabbix 7.0 用 agent2 的 UserParameter(写入 /etc/zabbix/zabbix_agent2.d/tls.conf,agent2 默认已 Include 该目录):
UserParameter=tls.expire[*],echo | openssl s_client -servername $1 -connect $1:443 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2
采集间隔设 5 分钟,触发器按剩余 30 天(Warning)、14 天(Average)、7 天(High)三级设置;用 -servername 是为了触发 SNI,否则多域名共用 IP 时会拿到默认站点的证书。
如何从客户端确认打到的是新证书?用 curl 8.5.0 绕过 DNS 直连灰度节点:
curl -vI --resolve www.example.com:443:10.0.1.23 https://www.example.com
# 检查输出:SSL certificate verify ok. / subject: CN=*.example.com / issuer: ...
openssl s_client -connect 10.0.1.23:443 -servername www.example.com # 需要看 serial 时用这条
据 Let’s Encrypt 文档与 CA/B Forum 基线要求,泛域名证书只能走 DNS-01 验证,因此这套 CSR 生成流程应与 DNS-01 的 TXT 记录发布、私钥销毁、OCSP 复核串成一条可回滚的流水线,而不是人工逐台改配置。
亚洲诚信通配符、单域名 DV、多域名 SAN 与 Let's Encrypt 通配符怎么选?
先回答最常被问的那句:如果我的域名只有 www、api、static 这类一级子域,到底该买亚洲诚信通配符证书,还是直接用 Let’s Encrypt?答案取决于三件事——覆盖层级、续期自动化能力、以及你是否需要证书主题里出现组织名。先看选型表(价格为 2026 年常见渠道区间,务必以代理商报价与年限折扣为准)。
| 方案 | 覆盖范围 | 验证方式 | 单次有效期 | 续期自动化 | 私钥轮换 | 参考价(2026 渠道区间) | 适用场景 |
|---|---|---|---|---|---|---|---|
| 亚洲诚信 DV 通配符 | *.example.com 一级子域 |
DNS TXT 或文件 | 公网 TLS 上限 398 天 | 控制台+DCV,可脚本辅助 | 建议每次续期换 key | 约 800–2000 元/年 | 一级子域多、预算有限 |
| 亚洲诚信 OV 通配符 | *.example.com 一级子域 |
组织验证+DNS/文件 | 公网 TLS 上限 398 天 | 控制台+DCV,OV 需材料 | 建议每次续期换 key | 约 2500–6000 元/年 | 需要展示组织信息 |
| 单域名 DV | www.example.com |
DNS/文件 | 公网 TLS 上限 398 天 | 高 | 可自动化 | 约 100–500 元/年 | 子域少、成本敏感 |
| 多域名 SAN | 多个明确域名 | DNS/文件/组织 | 公网 TLS 上限 398 天 | 中 | 可自动化 | 约 300–1500 元/年 | 多级子域、跨域组合 |
| Let’s Encrypt 通配符 | *.example.com 一级子域 |
DNS-01 | 90 天 | ACME 高 | 可 60 天轮换 | 0 元 | 自动化能力强、内部或公开站点 |
覆盖范围优先于价格。通配符只匹配一级标签:*.example.com 覆盖 api.example.com,但不覆盖 a.b.example.com。这个边界不是厂商限制,而是 RFC 6125 对 wildcard 匹配的定义。若业务里存在二级子域,正确做法是买多域名 SAN 或按业务拆分证书,而不是加钱买”更贵的通配符”。用 OpenSSL 3.2 可以直接核对证书实际覆盖范围(-ext 自 1.1.1 起可用,无默认值需显式指定):
# OpenSSL 3.2.x:核对 SAN 与有效期,确认是否覆盖目标主机
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
# 典型输出(亚洲诚信 DV 通配符,TrustAsia 签发)
# subject=CN = *.example.com
# issuer=C = CN, O = "TrustAsia Technologies, Inc.", CN = TrustAsia TLS RSA CA
# notBefore=Jan 5 00:00:00 2026 GMT
# notAfter=Feb 7 23:59:59 2027 GMT
# X509v3 Subject Alternative Name:
# DNS:*.example.com, DNS:example.com
# 线上实测(s_client 需显式 -servername,否则 SNI 缺失会拿到默认站点证书)
openssl s_client -connect api.example.com:443 -servername api.example.com /dev/null
| openssl x509 -noout -subject -enddate
覆盖判断错了,报错会非常直白——curl 会直接拒绝,而不是”证书不受信任”:
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
curl: (60) SSL: no alternative certificate subject name matches target host name 'a.b.example.com'
自动化能力的差距,比价格差距更影响运维成本。据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 挑战签发,且证书有效期固定 90 天;Certbot 默认在到期前 30 天续期,acme.sh 默认 60 天续期,二者都可配合 DNS API 实现无人值守与私钥轮换。亚洲诚信通配符证书则走控制台下单 + DCV,DV 在 DCV 通过后常见 5–15 分钟签发,OV 因需组织材料通常 1–3 个工作日;续期多为控制台操作或代理商 API,适合需要 OV 组织信息与商业支持的团队。Let’s Encrypt 通配符的最小可用命令:
# Certbot 2.x:通配符必须走 DNS-01;--cert-name 固定证书目录名,便于灰度脚本引用
certbot certonly --manual --preferred-challenges dns
-d '*.example.com' -d example.com
--cert-name wildcard-example
# 生产环境请把 --manual 换成 DNS 插件(如 --dns dns_ali),才能自动清理 TXT 记录
还要把合规变化算进去。按 CA/Browser Forum SC-081v3,公网 TLS 证书最长有效期将从 398 天分阶段缩短至 200 天(2026-03-15)、100 天(2027-03-15)、47 天(2029-03-15)。这意味着”一年一续”的商业证书流程迟早要改造成短周期流水线,而 90 天 ACME 体系天然适配。因此无论选哪种方案,私钥轮换、到期监控与 Nginx 灰度替换都应设计成同一套流程,而不是等到换证书那天才临时拼脚本。
续期时常见的 6 个报错与排查路径
续期时最容易踩的坑,往往不是申请环节,而是把新证书塞进 Nginx 的那一刻。下面按真实报错逐条拆解。
1. nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
这是证书与私钥不配对。私钥轮换后若只换了 key 没换证书(或反之),Nginx 直接起不来。用模数比对确认:
# 两条命令输出的 md5 必须完全一致
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -modulus | openssl md5
openssl rsa -in /etc/nginx/ssl/example.com-202605.key -noout -modulus | openssl md5
# 若私钥是 PKCS#8 或 ECDSA,改用:
# openssl pkey -in example.com-202605.key -pubout | openssl md5
# openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
OpenSSL 3.x 默认 openssl rsa 仍可读 PKCS#1,但对 PKCS#8 会提示 Could not read key,此时用 openssl pkey。注意 RSA 用 modulus 比对,ECDSA 无 modulus,必须比对公钥摘要。
2. curl: (60) SSL certificate problem: unable to get local issuer certificate
链不完整。Nginx ssl_certificate 必须指向「叶证书 + 中间证书」拼接的 fullchain,顺序是叶在前、中间在后,根证书不要放(据 Let’s Encrypt 与 Mozilla SSL 配置生成器建议)。验证:
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# 期望输出:fullchain.pem: OK
# 报 error 20 at 0 depth lookup 即缺中间证书
3. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID
先查 SAN:openssl x509 -in fullchain.pem -noout -text | grep -A1 "Subject Alternative Name"。据 RFC 6125,通配符只匹配一个标签——*.example.com 不覆盖 a.b.example.com,也不覆盖裸域 example.com。亚洲诚信通配符证书的 SAN 以订单实际签发为准,下单前务必确认是否含裸域。
4. DCV 卡在 pending,提示 TXT record not found
双 DNS 查询排除解析分裂:
dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _dnsauth.example.com @223.5.5.5
常见错因:记录加在 www 子域、TXT 值被额外加了引号、TTL 仍为 3600 导致旧缓存未过期。签发期间建议把 TTL 临时降到 60。
5. nginx -s reload 后仍返回旧证书
先确认实际加载路径:nginx -T | grep -n ssl_certificate;再排查是否有其他 server block 命中 default_server。测试时必须带 SNI,只连 IP 会拿到默认站点证书:
openssl s_client -connect 10.0.0.5:443 -servername www.example.com </dev/null 2>/dev/null
| openssl x509 -noout -dates -subject
6. nginx: [warn] ssl_stapling ignored, issuer certificate not found
OCSP stapling 需要可信链。补上:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 仅中间链,不含叶证书
resolver 223.5.5.5 8.8.8.8 valid=300s; # 默认不设 resolver 时 stapling 直接失效
resolver_timeout 5s;
还需确认出站 80 端口可达——OCSP 响应器走 HTTP,被安全组拦截时 stapling 永远不生效。另有一类 error:0A00018F:SSL routines::ee key too small,指私钥长度不足:RSA 至少 2048 位(新签常见 3072 位)。若历史系统只支持 RSA,不要贸然切 ECDSA,先在 canary 节点验证客户端兼容性。
如何验证新证书已生效且旧私钥已下线?
为什么不能只看浏览器地址栏的小锁?因为浏览器只验证“当前这台设备到当前这个节点”的一条链,它不告诉你:SNI 虚拟主机是否命中、LB 后面的其它后端是否还在用旧私钥、旧 serial 是否已被吊销、CT 日志是否已经收录新证书。下面按“单点→灰度→全量→客户端”四层顺序验证,每层都有可复制的命令和明确的通过判据。
第一步:从公网侧确认链、有效期与 serial
# 取回完整证书链(-servername 必须给,否则 Nginx 可能返回默认站点证书)
openssl s_client -connect www.example.com:443 -servername www.example.com
-showcerts /dev/null | openssl x509 -noout
-subject -issuer -dates -serial -ext subjectAltName
# 单独确认校验结果(关键:0 (ok) 才说明中间 CA 完整)
openssl s_client -connect www.example.com:443 -servername www.example.com
/dev/null | grep -E 'Verify return code|Protocol|Cipher'
# 期望输出:
# Verify return code: 0 (ok)
# Protocol : TLSv1.3 Cipher : TLS_AES_256_GCM_SHA384
判定标准三条同时满足:Verify return code: 0 (ok);notAfter 是本次续期后的新日期(亚洲诚信通配符证书通常为 1 年期,注意 CA 自 2020 年起签发的公开证书有效期上限受 CA/B Forum 基线要求约束,不要按“多年期”预期验收);serial 与后台签发记录逐位一致。Serial 不匹配是最常见的“换了证书但 Nginx 没 reload”或“reload 了但 ssl_certificate 指向旧路径”的症状。
第二步:用 curl 逐节点验证灰度
# --resolve 绕过 DNS,把域名强制指到某台灰度节点,Host/SNI 仍为 www.example.com
curl -vI --resolve www.example.com:443:10.0.1.23 https://www.example.com 2>&1
| grep -E 'SSL certificate verify|subject:|issuer:|expire date'
# 期望:
# * SSL certificate verify ok.
# * subject: CN=*.example.com
# * issuer: C=CN; O=...(亚洲诚信对应中间 CA 名称)
# * expire date: ...(新日期)
对生产 LB 的每一个后端 IP 重复这条命令,一个都不能漏——Nginx 1.26 的 upstream 里只要有一台机器没换证书,灰度期间就会随机命中旧证书。批量做法:for ip in $(cat backends.txt); do echo "== $ip"; curl -sI --resolve www.example.com:443:$ip https://www.example.com -o /dev/null -w '%{ssl_verify_result}n'; done,输出全为 0 才算通过。
第三步:协议与链强度检查(testssl.sh 3.2)
# --fast 只跑关键项,适合每次发布做门禁;正式验收建议去掉 --fast 跑全量
testssl.sh --fast --severity HIGH https://www.example.com
# 关注输出行:
# TLS 1.2 offered (OK)
# TLS 1.3 offered (OK)
# TLS 1.0/1.1 not offered ← 应为 not offered
# Chain of trust OK
# OCSP URI http://ocsp.example-ca.cn
据 Mozilla Server Side TLS 指南(v5.7)的 “Intermediate” 配置建议,面向公网的现代客户端应至少要求 TLS 1.2 与 TLS 1.3,禁用 TLS 1.0/1.1 及 RC4、3DES、静态 RSA 套件;若 --severity HIGH 报出 RC4、3DES 或 expired,说明证书换了但 ssl_protocols/ssl_ciphers 没跟着收敛。
第四步:OCSP 确认旧证书确实“死了”
# OCSP 地址优先从证书 AIA 扩展自动取,避免手抄错
openssl x509 -in leaf.pem -noout -ocsp_uri
openssl ocsp -issuer intermediate.pem -cert leaf.pem
-url http://ocsp.example-ca.cn -resp_text -noverify
# 期望:Cert Status: good
# Next Update: ...(未过期,通常有效期数天)
看到 Cert Status: revoked 说明旧私钥可能已泄露并被 CA 吊销,此时不要继续灰度,立即把 Nginx 回滚到上一版配置并联系亚洲诚信证书服务方确认吊销原因;Next Update 已过期则说明 OCSP 响应缓存失效,需重新取响应,不能当作 “good” 使用。注意 OCSP 的 -noverify 只是跳过响应签名校验,生产巡检建议去掉该参数并用 -CAfile 指定 CA 链。
第五步:CT 日志 + 监控 + 浏览器全量复核
# 查证书透明日志里是否已有新 serial(crt.sh 的 serial 为小写十六进制、无冒号)
curl -s 'https://crt.sh/?q=%25.example.com&output=json'
| jq -r '.[] | [.not_after, .serial_number, .issuer_name] | @tsv' | sort -u | tail -5
# Zabbix 7.0:用内置 item key 采集证书元数据,做“到期时间 + serial + OCSP”三联动触发器
zabbix_get -s 10.0.1.23 -k 'web.certificate.get[www.example.com,443]' | jq '.x509 | {serial_number, not_after, subject}'
Zabbix 7.0 的 web.certificate.get 返回 JSON,其中 serial_number 与 not_after 可直接做触发器:serial 与基线不符即告警“证书被意外替换”,not_after 距今天数小于 30 触发续期工单。同时用 grep -rn "example.com.key" /etc/nginx/ 确认配置只引用新私钥,再把旧 key 从备份目录移出(确认回滚窗口已过后用 shred -u 销毁),否则“轮换”只是换了引用、旧私钥仍在磁盘上。
| 验证层 | 核心命令 | 通过判据 | 不通过时的处置 |
|---|---|---|---|
| 公网链与 serial | openssl s_client -showcerts + openssl x509 |
Verify return code: 0 (ok)、notAfter 为新日期、serial 与后台一致 |
检查 Nginx ssl_certificate 路径与 nginx -s reload 是否成功 |
| 灰度节点 | curl -vI --resolve |
SSL certificate verify ok、subject 为 *.example.com、issuer 为对应中间 CA |
该节点未更新证书,重新分发并 reload |
| 协议与链 | testssl.sh --fast --severity HIGH |
TLS 1.2/1.3 offered,TLS 1.0/1.1 not offered,Chain of trust OK | 收敛 ssl_protocols/ssl_ciphers,补全中间证书 |
| 吊销状态 | openssl ocsp -resp_text |
Cert Status: good,Next Update 未过期 |
为 revoked 时立即回滚并联系 CA |
| 全量与客户端 | crt.sh + Zabbix 7.0 item + Chrome/Edge Security 面板 + 移动端系统浏览器 | CT 有记录、监控三项已更新、桌面与移动端链均 OK | 旧 Android 报链错误时补发中间证书(ssl_certificate 用 fullchain) |
最后别省掉“客户端侧”这一步:桌面 Chrome 通过不代表旧 Android(7.0 以下)和内网 Java 客户端通过,后者对缺少中间证书、对 SHA-1 签名、对仅 TLS 1.3 的站点都可能直接握手失败。用系统浏览器在内网和一台旧机型上各访问一次,再回到 Zabbix 确认 serial、到期时间、OCSP 三项监控都已刷新为新值——三项里只要有一项还停在旧值,就说明某个采集点仍指向旧证书或旧私钥。
团队落地清单:把续期从个人经验变成可审计流程
把续期从“某个人记得”变成“流程能证明”,核心只有一句话:每个动作都要留下可复核的文件、命令输出和时间戳。下面这套清单按亚洲诚信通配符证书的常见签发节奏编排,直接抄进变更单即可。
| 时间点 | 动作 | 审计留痕 | 回滚位 |
|---|---|---|---|
| T-30 | 生成新私钥 + CSR(不复用旧 key) | CSR 的 SHA-256 指纹、SAN 列表 | 旧 key 仍在原位,不动 |
| T-15 | 完成 DCV(DNS-01 TXT) | dig 输出、TXT 值、验证时间 | 无,仅记录 |
| T-7 | canary 节点灰度替换 | 节点名、nginx -t 结果、s_client 输出 | canary 单节点回旧证书 |
| T-1 | 全量切换 | 逐节点 reload 时间 | 全量回滚窗口 7 天 |
| T+0 | 监控 serial 与 OCSP | serial、OCSP 状态快照 | 同上 |
| T+2 | 退役旧私钥(移入离线归档并标记) | 旧 key 指纹、销毁/归档人 | 归档副本保留至 T+7 |
T-30 的命令序列(OpenSSL 3.2,openssl version 应显示 3.2.x):
# 1) 建立仅 root 可进入的轮换目录,umask 077 保证新文件默认 600
install -d -m 700 -o root -g root /etc/ssl/private/rotating
umask 077
# 2) 生成 4096 位新私钥;CA/B Forum TLS BR 6.1.1.3 限制同一密钥跨证书复用,因此每次续期都换 key
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:4096
-out /etc/ssl/private/rotating/wildcard-202506.key
# 3) CSR 的 SAN 必须与旧证书逐字一致,否则 DCV 要重走一遍
openssl req -new -sha256
-key /etc/ssl/private/rotating/wildcard-202506.key
-subj "/CN=*.example.com"
-addext "subjectAltName=DNS:*.example.com,DNS:example.com"
-out /etc/ssl/private/rotating/wildcard-202506.csr
# 4) 复核 SAN,并记录私钥公钥指纹(写进审计字段)
openssl req -in /etc/ssl/private/rotating/wildcard-202506.csr -noout -text | grep -A1 "Subject Alternative Name"
openssl pkey -in /etc/ssl/private/rotating/wildcard-202506.key -pubout -outform der | openssl sha256
# 5) T-15 验证 DNS-01 记录(亚洲诚信通配符证书通常下发 _dnsauth 主机记录)
dig +short TXT _dnsauth.example.com @8.8.8.8
权限与存储:私钥权限 600、属主 root:root,Nginx 1.26 由 master 进程(root)加载私钥,worker 以 nobody/nginx 运行,因此不需要给私钥组读权限。禁止把 key 提交到 Git、Confluence 或聊天工具;有条件的团队放 HSM 或云 KMS(Nginx 1.26 可通过 ssl_certificate_key 指向 PKCS#11 engine 或 ngx_http_ssl_module 的 provider 方案),至少做加密备份并把解密权限收敛到 2 人以内。
T-7 灰度时,Nginx 1.26 的 ssl_certificate 支持重复出现以同时挂 RSA/ECDSA 双证书,替换前务必 nginx -t。若 key 与证书不配对,会直接报:nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0A080006:SSL routines::EVP lib),此时不要 reload,回到 T-30 重签 CSR。
| 监控项 | 采集方式 | 阈值 / 告警 | 接收人 |
|---|---|---|---|
| 到期时间 | openssl x509 -noout -enddate |
剩余 30/14/7 天 | 当班运维 + 业务负责人 |
| serial 变化 | -noout -serial 比对基线 |
任一节点 serial 不一致即告警 | 当班运维 |
| OCSP 状态 | openssl ocsp -issuer chain.pem -cert leaf.pem -url "$(openssl x509 -in leaf.pem -noout -ocsp_uri)" -resp_text |
非 good 或超时 |
当班运维 |
| 证书链缺失 | openssl s_client -connect IP:443 -servername www.example.com -showcerts |
验证结果含 unable to get local issuer certificate |
当班运维 |
采集间隔统一 5 分钟,避免与 Let’s Encrypt / 亚洲诚信 OCSP 响应器的速率限制冲突。审计字段固定为:域名、SAN、证书 serial、签发 CA、DCV 方式、部署节点、Nginx 配置路径、私钥 SHA-256 指纹、切换时间、回滚人。变更单关闭前这十项必须填满——下次续期直接复用清单,就不用凌晨三点靠记忆排错。
不能。`*.example.com` 只匹配一级子域,如 `www.example.com`、`api.example.com`;`a.b.example.com` 需要单独加入 SAN 或另购多域名证书。据 RFC 6125,通配符不跨多个标签匹配。
建议每次续期都生成新私钥并轮换。复用旧 key 会扩大泄露后的影响面,也不利于满足年度密钥轮换要求;如果 CA 支持复用 CSR,仍建议至少按 12 个月或安全事件触发轮换。
如果只有一级子域且追求零成本和 ACME 自动化,Let's Encrypt 通配符更轻量,但单次有效期 90 天,需要 DNS-01 自动化。若需要 OV 组织信息、商业支持、固定签发流程或更长有效期,亚洲诚信 DV/OV 通配符更合适,价格常见 800–6000 元/年区间。
先用 `dig +short TXT _dnsauth.example.com @8.8.8.8` 和 `@223.5.5.5` 确认公共递归能查到,再检查记录名是否漏了 `_dnsauth`、TXT 值是否被引号包裹、TTL 是否过大。公共 DNS 缓存常见延迟 5–30 分钟,超过 1 小时仍未通过就联系签发渠道核对记录。
先执行 `nginx -T | grep ssl_certificate` 确认加载路径,再用 `openssl s_client -connect IP:443 -servername www.example.com` 指定 SNI 检查。若前面有 CDN、SLB 或 WAF,证书可能在边缘节点终止,需要在对应控制台上传新证书并刷新。
私钥权限设为 `600`、属主 root,禁止进入代码仓库;备份要加密并限制解密权限。全量切换并观察 24–48 小时后,旧 key 从 Nginx 配置、备份目录和 CI 变量中移除,按介质销毁流程处理。
不是所有场景都必须开启,但开启后可减少客户端 OCSP 查询延迟。出现 `ssl_stapling ignored, issuer certificate not found` 时,配置 `ssl_trusted_certificate` 指向完整中间链,并设置可用的 `resolver`;若 CA 的 OCSP 地址不可达,先排查出站网络。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。