通配符证书注意事项:一张 *.example.com 的风险半径、私钥管控与 7 步上线检查
通配符证书最大的注意事项不是能不能签下来,而是“一张证书覆盖所有同级子域”带来的风险半径:私钥泄露即全部子域同时失守,止血动作是换证加全网 reload,实测 MTTR 通常 2–6 小时。 通配符只匹配最左侧一个标签(RFC 6125 §6.4.3),*.example.com 不覆盖 a.b.example.com,也不允许 *.*.example.com,多级子域必须单独签 *.b.example.com。 公开 CA 签发通配符只能用 DNS-01 校验,Let's Encrypt 明确不支持 HTTP-01/TLS-ALPN-01;同时 CAA 必须同时配置 issue 与 issuewild(RFC 8659),只配 issue 时部分 CA 会直接拒绝签发。 私钥落地权限基线:chmod 600、chown root:root,只允许 Nginx master 读取;容器场景用 Secret 挂载到 tmpfs,禁止打进镜像层或用 SCP/IM 传输。 验证一条命令即可:openssl s_client -connect a.example.com:443 -servername a.example.com /dev/null | openssl x509 -noout -subject -dates -ext subjectAltName,确认 SAN 含 *.example.com 且 notAfter 剩余天数符合预期。
为什么一张 *.example.com 会让安全团队紧张?风险半径到底从哪来
一句话回答:因为通配符证书把”申请一次”和”覆盖一片”绑定在一起,而审批、私钥、吊销这三件事的成本都随覆盖范围线性甚至指数上升。风险半径不是证书本身带来的,是”新增子域无需二次审批 + 私钥多副本分发”这两件事叠加出来的。
第一层:自动覆盖的边界在哪?据 RFC 6125 §6.4.3,通配符只匹配最左侧的一个标签。*.example.com 覆盖 a.example.com,不覆盖 a.b.example.com,也不覆盖裸域 example.com。这一点可以直接用 OpenSSL 验证(-verify_hostname 需 OpenSSL 1.1.0 及以上,3.x 行为一致):
# 通配符证书与中间链
openssl verify -CAfile chain.pem -verify_hostname a.example.com wildcard.pem
# a.example.com: OK
openssl verify -CAfile chain.pem -verify_hostname a.b.example.com wildcard.pem
# error 62 at 0 depth lookup: hostname mismatch <-- X509_V_ERR_HOSTNAME_MISMATCH
openssl verify -CAfile chain.pem -verify_hostname example.com wildcard.pem
# error 62 at 0 depth lookup: hostname mismatch <-- 裸域不在覆盖范围内
问题在于”匹配”只朝一个方向收紧:深度受限于一个标签,广度却完全放开。证书有效期内,任何人新建 pay.example.com、admin.example.com,只要 DNS 指向那台机器,浏览器立刻认为它可信——中间没有任何一次证书层面的审批动作。这就是风险半径的起点。
第二层:私钥副本数决定了爆炸半径。Nginx、Tomcat、K8s Ingress Controller、CDN 回源、老旧的 Jenkins 发布机,往往共用同一个 wildcard.key。任意一处失守(chmod 644、误提交进 Git、被打进 Docker 镜像层)等于全部子域同时失守。上线前建议跑这三条审计命令:
# 1) 找出 other 位可读的私钥;期望输出为空
find /etc /opt /srv -type f -name "*.key" -perm -o=r 2>/dev/null
# 2) 确认权限基线,正确值应为 600 root:root
stat -c '%a %U:%G %n' /etc/nginx/ssl/wildcard.key
# 600 root:root /etc/nginx/ssl/wildcard.key
# 3) 查私钥是否曾进入 Git 历史或镜像层
git log --all --diff-filter=A -- '*.key' '*.pem'
docker history --no-trunc registry.example.com/web:1.4.2 | grep -iE 'key|pem'
| 对比维度 | 单域名证书(api.example.com) | 通配符证书(*.example.com) |
|---|---|---|
| 泄露后受影响主机名 | 1 个 | 有效期内任意新增二级子域,数量不受控 |
| 典型私钥副本数 | 1–3 台 | 10+(LB / Ingress / 回源 / 批处理节点) |
| 吊销后止血时间 | 分钟级 | 实测 2–6 小时(DNS-01 重签 + 多节点分发 + 灰度) |
| 合规审计边界 | 单个系统 | 所有持有该私钥的系统(PCI DSS 4.0 3.6.1) |
第三层:吊销远比想象中慢。CRL 与 OCSP 的生效存在缓存与下发延迟,浏览器策略也不统一——Chrome 依赖 CRLSets 聚合下发,不在集合里的吊销状态短期内可能不生效。查询实际状态可以这样确认:
openssl ocsp -issuer chain.pem -cert wildcard.pem
-url http://ocsp.example-ca.com -resp_text -noverify
# 关注输出中的 "Cert Status: good" / "revoked",
# 以及 "Next Update" 时间戳——它是缓存窗口的上界
所以真正有效的止血动作不是”去吊销”,而是”重签 + 全节点 reload”:走 DNS-01 重新校验、分发到所有节点、灰度验证,运维实测通常 2–6 小时。这个数字必须写进应急预案,否则通配符证书注意事项里最关键的时限就被低估了。
第四层:合规边界会变模糊。PCI DSS 4.0 的 3.6.1 要求覆盖私钥保护流程,4.2.1 要求强加密传输。一张通配符意味着审计范围要覆盖所有持有该私钥的系统;如果这些系统散落在 3 个团队、5 个云账号,”私钥到底在哪些机器上”就答不出来。
第五层:有效期缩短放大了人为失误概率。按 CA/Browser Forum SC-081 的推进节奏,公开信任证书最长有效期从 398 天压缩到 200 天(2026-03-15 起),再到 100 天(2027-03-15 起)。
| 生效日期(SC-081) | 公开信任证书最长有效期 | 通配符年分发次数(按 10 个节点估算) |
|---|---|---|
| 当前 | 398 天 | 约 10 次/年 |
| 2026-03-15 起 | 200 天 | 约 20 次/年 |
| 2027-03-15 起 | 100 天 | 约 40 次/年 |
每一次分发都是一次私钥暴露机会,手工流程出错概率随次数线性上升——这是 ACME 自动化(如 Let’s Encrypt 配合 certbot / cert-manager)从”可选项”变成”必选项”的直接原因。据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 挑战签发,意味着你必须把 DNS API 凭据交给自动化系统,这本身就是又一个需要管控的敏感资产。
第六层,也是最容易被忽略的:没有归属人。谁都能申请、谁都能部署,最终没人对 CAA 记录、私钥存放位置和吊销演练负责。技术措施能压缩风险半径,但压缩不到零——所以在讨论 *.example.com 之前,先确认有没有一个明确的、能签字的人。
上线前该做哪些检查?从域名盘点 to 演练的 7 个步骤
-
你手上的子域清单是全的吗?先从 CT 日志反查。证书透明度日志(CA/Browser Forum《Baseline Requirements》强制要求)记录了所有公开签发的证书,是最难被人为遗漏的资产来源。据 crt.sh 文档,
name_value字段会返回证书 SAN 中的全部主机名。# 拉取该域下曾出现在 CT 日志中的全部主机名(%25 是 % 的 URL 编码) curl -sL --max-time 30 "https://crt.sh/?q=%25.example.com&output=json" | jq -r '.[].name_value' | tr ',' 'n' | sort -u > ct-hosts.txt # 与 Nginx 配置、DNS zone、CMDB 三方比对,找出"已存在但没人认领"的孤儿主机 grep -rhoE '[a-z0-9._-]+.example.com' /etc/nginx/ | sort -u > nginx-hosts.txt comm -23 ct-hosts.txt nginx-hosts.txt # 只在 CT 出现、配置里没有 -
哪些子域该进通配符,哪些必须拆出去?通配符的风险半径等于整张证书可覆盖的命名空间,划边界的核心是把半径压在业务域内。
场景 建议 理由 同级子域 ≥5 个且持续动态新增 *.example.com签发与续期成本最低 固定 1–3 个 单域名或 SAN 证书 泄露后不波及未签发的名字 跨业务线、对外 API 独立通配符如 *.pay.example.com把半径限制在业务域内 登录、支付回调等高风险入口 单域名 + 收紧 CAA 牺牲一点便利换取可控性 -
CAA 记录配全了吗?按 RFC 8659 §5.3,缺少
issuewild时应回退到issue,但实际部分 CA 实现并不一致,会直接把通配符请求判为未授权而拒绝,双写最稳。dig +short CAA example.com @8.8.8.8 # 期望输出两条(0 表示非 critical) # 0 issue "letsencrypt.org" # 0 issuewild "letsencrypt.org" -
验证通道准备好了吗?据 Let’s Encrypt 官方文档,通配符证书只能走 DNS-01,HTTP-01 与 TLS-ALPN-01 均不支持。先确认 DNS 服务商有 API,再验证传播速度:
dig +short TXT _acme-challenge.example.com @1.1.1.1 dig +short TXT _acme-challenge.example.com @8.8.8.8 # 多解析器交叉确认 -
密钥算法怎么选?没有”最好”,只有取舍;面向公众的门户优先 RSA 2048 或 RSA 3072 过渡。
算法 握手体积 兼容性 适用 RSA 2048 大 最广 公众门户默认 RSA 3072 更大 广 合规过渡期 ECDSA P-256 小,CPU 开销低 Android 7 以下及部分老 Java 客户端不支持 内部服务、移动端 -
私钥分发路径与权限基线定死了吗?据 OpenSSL 文档,私钥文件应仅对属主可读;Nginx 由 root 启动 master 进程后降权,worker 无需读私钥即可满足最小权限。
install -o root -g root -m 600 fullchain.key /etc/ssl/private/example.com.key # 容器:Secret 挂到 tmpfs,不要 COPY 进镜像层 # 跨账号:KMS / Secrets Manager 下发,禁止 SCP、邮件、IM 传文件 -
监控和演练做了吗?三件事缺一不可:CT 日志监控(轮询 crt.sh 或订阅 certstream)、30/14/7 天三档到期提醒、一次完整的”模拟泄露 → 重签 → 全节点 reload → 验证”演练。
# 到期检查,可直接接入监控 echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates # 重签后全节点验证,确认没有节点还在用旧证书 openssl x509 -noout -serial -fingerprint -sha256 -in /etc/ssl/certs/example.com.pem把这次演练的 MTTR(从发现泄露到所有节点生效)写进运维手册——它才是通配符证书真实的风险半径。
命令和配置怎么写?OpenSSL 3.x、Nginx 与 certbot 的可复制片段
Q:怎么生成 ECDSA P-256 私钥和 CSR?
OpenSSL 3.0.13 实测可用的两条命令(在 Debian 12 / Ubuntu 24.04 上默认版本即为 3.0.x):
# 1) 生成 P-256(prime256v1)私钥,默认 PEM、未加密、权限 600
openssl ecparam -genkey -name prime256v1 -out wildcard.key
chmod 600 wildcard.key
# 2) 生成 CSR:-addext 是 OpenSSL 3.x 的写法,一次性注入 SAN
openssl req -new -sha256 -key wildcard.key
-subj "/CN=*.example.com"
-addext "subjectAltName=DNS:*.example.com,DNS:example.com"
-out wildcard.csr
# 3) 自查 CSR 内容(3.x 语法)
openssl req -in wildcard.csr -noout -text | grep -A1 "Subject Alternative Name"
关键提醒:据 Let’s Encrypt 与 CA/Browser Forum 基线要求,公开 CA 会按自己的规则重建 SAN,CSR 里的 subjectAltName 只是“请求”,最终以签发结果为准——所以拿到证书后必须用 openssl x509 -noout -ext subjectAltName 复核,别假设 CSR 写什么就签发什么。另外通配符只覆盖一级子域,*.example.com 不含 a.b.example.com,也不含裸域 example.com,因此两条 SAN 都要带上(这也是通配符证书注意事项里最常被忽略的一条)。
Q:私钥要加密吗?加密后 Nginx 还能直接用吗?
加密只用于归档和传输,不用于运行态。OpenSSL 3.x 推荐 pkey 子命令,旧的 openssl rsa -aes256 写法已不适用于 EC 密钥:
# 归档/传输用:AES-256-CBC 加密,-passout 避免交互(生产建议从环境变量或 KMS 取)
openssl pkey -in wildcard.key -aes-256-cbc -passout env:KEY_PASS -out wildcard.enc.key
# 运行态解密:输出到 tmpfs,避免落盘
openssl pkey -in wildcard.enc.key -passin env:KEY_PASS -out /run/nginx-ssl/wildcard.key
Nginx 启动时不会交互式询问口令;虽然 1.11.0 起提供 ssl_password_file,但把口令明文写盘等于抵消加密收益。常见报错是 nginx: [emerg] cannot load certificate key ... PEM_read_bio_PrivateKey() failed,根因就是给了带口令的私钥。生产上更稳妥的做法是由 KMS/Vault 在容器启动时注入 tmpfs。
Q:Nginx 的最小可用配置长什么样?
server {
listen 443 ssl;
http2 on; # nginx ≥1.25.1 的新语法
server_name example.com *.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 必须是 leaf → 中间证书顺序
ssl_certificate_key /etc/nginx/ssl/wildcard.key;
ssl_protocols TLSv1.2 TLSv1.3; # 1.23.4 起的默认值即此
ssl_prefer_server_ciphers off; # 1.23.4 起默认 off,交给客户端选
ssl_session_cache shared:SSL:10m;
}
拼接链文件时顺序错了会直接报 unable to get local issuer certificate:正确做法是 cat cert.pem chain.pem > fullchain.pem,而不是反过来。
Q:certbot 走 Cloudflare DNS-01 的完整命令?
# 前置:pip install certbot-dns-cloudflare;cf.ini 内容为 dns_cloudflare_api_token = xxx,权限 600
certbot certonly --dns-cloudflare
--dns-cloudflare-credentials /root/.secrets/cf.ini
-d '*.example.com' -d example.com
--cert-name wildcard-example
--deploy-hook 'systemctl reload nginx'
三个易错点:星号必须加单引号,否则 shell 会展开成当前目录文件名;--cert-name 固定 /etc/letsencrypt/live/wildcard-example/ 目录名,改了就换路径;--deploy-hook 只在签发/续期成功后执行,因此只在此时 reload 才是安全的(避免加载到半成品)。
Q:CAA 和本地验链怎么收尾?
; BIND zone 片段
example.com. 300 IN CAA 0 issue "letsencrypt.org"
example.com. 300 IN CAA 0 issuewild "letsencrypt.org"
example.com. 300 IN CAA 0 iodef "mailto:secops@example.com"
# 本地验链:返回 OK 才算链完整
openssl verify -untrusted chain.pem -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
据 RFC 8659,issuewild 缺失时 CA 会回退到 issue,但显式声明更利于审计;iodef 用于 CA 在违规签发时发告警邮件,很多团队漏配,等于放弃了最后一道告警通道。
| 真实报错 | 根因 | 修复动作 |
|---|---|---|
unable to get local issuer certificate |
fullchain 缺中间证书或顺序颠倒 | 按 leaf → intermediate 重新拼接并 openssl verify |
PEM_read_bio_PrivateKey() failed |
运行态私钥带口令 | 解密到 tmpfs 或由 KMS 注入 |
CAA record forbids issuance |
issuewild 缺失或写成其他 CA | 补 issuewild "letsencrypt.org" 并等 TTL 过期 |
DNS problem: NXDOMAIN looking for _acme-challenge |
API Token 无 DNS 编辑权限 | 在 Cloudflare 授予 Zone.DNS Edit |
一张通配符、按业务拆分、还是精确域名?三种方案怎么选
三种方案的分歧点,本质不是证书价格,而是私钥份数 × 泄露影响面与续期运维量之间的取舍。先看横向对比(成本为 2025 年公开报价区间):
| 维度 | 单张 *.example.com | 按业务拆 *.a / *.b | 精确域名 SAN 证书 |
|---|---|---|---|
| 覆盖子域 | 全部二级子域 | 各自业务域 | 仅列出的主机名 |
| 新增子域是否重签 | 否 | 否(限本域) | 是 |
| 私钥份数 | 1 | 2–5 | 按需 |
| 泄露影响面 | 全站 | 单业务线 | 单主机名 |
| DNS-01 依赖 | 强 | 强 | 可选 HTTP-01 |
| 年成本区间 | ¥400–2000(DV) ¥3000–8000(OV) |
翻倍 | 单域名更低 |
| 续期运维量 | 最低 | 中 | 最高 |
| 适合场景 | 小团队、子域多且变动快 | 多团队、多业务线 | 对外 API、支付回调 |
拆分阈值怎么定?子域数量 ≥20,或涉及 ≥3 个团队时,优先按业务拆成多张通配符,把“一张证书全网通”降级为“一张证书一条业务线”——泄露时只需 reload 该业务线的节点,而不是全网应急。注意,EV 证书本身不支持通配符(CA/Browser Forum Baseline Requirements 明确排除),且据 Let’s Encrypt 文档,通配符只能通过 DNS-01 签发,这意味着你的 DNS API 凭据会成为新的高价值攻击面,这也是通配符证书注意事项里最常被忽略的一条。另据 RFC 6125 §6.4.3,*.example.com 只匹配最左一个标签,a.b.example.com 不在其覆盖范围内,规划子域层级时要先确认这一点。
内部服务不要占用公开信任通配符。Vault PKI、step-ca、cert-manager 内置 CA 签发的内部域名证书成本为 0,还能把有效期压到 24 小时;把它们塞进公开通配符,只会把同一把私钥分发到测试、预发、内网等所有机器上。
# cert-manager v1.14+:内部域名走自建 CA,duration 默认 2160h(90d),此处压到 24h
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: internal-svc
namespace: prod
spec:
secretName: internal-svc-tls
duration: 24h # 自建 CA 才敢这么短
renewBefore: 8h # 默认 duration/3
dnsNames:
- svc.prod.internal # 绝不出现在公开通配符里
issuerRef:
name: internal-ca
kind: ClusterIssuer
# step-ca v0.25+ 命令行签发,--not-after 默认取 CA 的 claims.maxTLSDuration
step ca certificate svc.prod.internal svc.crt svc.key
--ca-url https://ca.internal:9000
--root /etc/step/certs/root_ca.crt
--not-after 24h
对外 API 与回调地址优先精确域名。这类域名数量固定、变更少,用 SAN 证书可避免“通配符把测试子域也一起信任”的问题,也便于按域名独立吊销。上线前用 OpenSSL 核对实际覆盖范围:
# OpenSSL 3.x
openssl x509 -in api.example.com.crt -noout -text
| grep -A1 "Subject Alternative Name"
# 输出示例:DNS:api.example.com, DNS:callback.example.com
成本不能只算证书价格。按一张通配符 ¥1200/年、泄露事故平均 4 人时处理、人力 ¥300/人时估算,单次事故的人力成本 ¥1200 已超过一年证书费,三年 ¥3600 的对比下,拆分方案的溢价通常在可接受范围内——真正被摊薄的是应急半径,而不是账单。
实际部署中最容易踩的 6 类报错,分别怎么排查
通配符证书注意事项里,部署期报错大多不是“证书没签下来”,而是匹配范围、SNI 路由、CAA、文件格式、证书链、限流六件事。按下面顺序排查,能少走很多弯路。
1. 为什么 curl 报 no alternative certificate subject name,Go/Java 也报 SAN 不匹配?
curl: (60) SSL: no alternative certificate subject name matches target host name ‘api.v2.example.com’
根因是 *.example.com 只覆盖一个标签,不覆盖 api.v2.example.com。RFC 6125 与 CA/Browser Forum 都要求客户端按单标签通配做匹配;Go 的 x509: certificate is valid for *.example.com, not a.b.example.com、Java 的 No subject alternative DNS name matching ... found 是同一件事。先确认证书实际 SAN:
# OpenSSL 1.1.1+;输出 DNS:*.example.com 即只覆盖一级
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -ext subjectAltName
# 线上实际返回的证书也要看
openssl s_client -connect api.v2.example.com:443 -servername api.v2.example.com </dev/null 2>/dev/null
| openssl x509 -noout -ext subjectAltName
| 目标主机名 | *.example.com 是否匹配 | 原因 |
|---|---|---|
| example.com | 否 | 通配符不覆盖裸域,需另加 SAN |
| a.example.com | 是 | 只替换最左一个标签 |
| a.b.example.com | 否 | 跨了两级,需 *.b.example.com 或显式 SAN |
多级子域必须单独签发 *.v2.example.com,或在同一张证书里加 DNS:api.v2.example.com;不要改客户端关校验。这是通配符证书注意事项中最容易忽略的边界。
2. 浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,但 openssl s_client 直连正常,为什么?
多半是 SNI 未命中。TLS 的 SNI 在 HTTP Host 之前决定用哪张证书;Nginx 没有匹配的 server_name,或默认 server 兜底到错误证书,就会这样。注意 Nginx 的 server_name *.example.com 可匹配多级,证书通配不行,路由成功不代表证书匹配。对比默认证书:
# 带 SNI:应返回 a.example.com 的证书
openssl s_client -connect 203.0.113.10:443 -servername a.example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -ext subjectAltName
# 不带 SNI:看默认 server 兜底成了哪张证书
openssl s_client -connect 203.0.113.10:443 </dev/null 2>/dev/null
| openssl x509 -noout -subject -ext subjectAltName
# Nginx 1.19.4+;ssl_reject_handshake 默认 off,未知 SNI 直接拒绝握手
server {
listen 443 ssl default_server;
server_name _;
ssl_reject_handshake on;
}
3. ACME 报 CAA record prevents issuance,怎么查?
urn:ietf:params:acme:error:caa “CAA record for example.com prevents issuance”
CA 按 RFC 8659 从主机名逐级向上查 CAA;有 CAA 集但缺 issuewild 时,通配符签发会被拒。逐级确认:
dig +short CAA example.com
dig +short CAA sub.example.com
# 同时签 *.example.com 和 example.com 时,issue 与 issuewild 都要有;TTL 示例 300 秒
# example.com. 300 IN CAA 0 issue "letsencrypt.org"
# example.com. 300 IN CAA 0 issuewild "letsencrypt.org"
改完等 TTL 过期再重试;据 Let’s Encrypt 文档,失败验证有每账户每主机名每小时 5 次限制,立刻连点只会更糟。
4. Nginx 报 PEM_read_bio_X509_AUX() failed / bad base64 decode,怎么修?
常见是 DER/PFX 直接改名,或文件头有 UTF-8 BOM。先用 OpenSSL 验证:
file cert.pem
head -c 3 cert.pem | xxd # EF BB BF 即 BOM
openssl x509 -in cert.pem -noout -subject -issuer
# PFX 只导出 leaf,不要用 -nodes 全量导出后当 leaf
openssl pkcs12 -in cert.pfx -clcerts -nokeys -out cert.pem
# DER 转 PEM
openssl x509 -inform DER -in cert.der -out cert.pem
-nodes 全量导出会混入私钥和中间证书;Nginx 的 ssl_certificate 要的是 leaf+中间链的 fullchain,不是私钥。
5. 客户端报 unable to get local issuer certificate,Android/Java 握手失败,缺什么?
缺中间证书。桌面浏览器常靠 AIA 自动补链,Android/Java 往往不补。据 Mozilla 服务器端 TLS 指南,服务端应发送完整链。数线上链:
openssl s_client -showcerts -connect a.example.com:443 </dev/null 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
# 正常 2–3;只有 1 说明缺中间证书
# Nginx 必须用 fullchain.pem,不能用 cert.pem
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
6. Let’s Encrypt 返回 too many certificates already issued,怎么避免?
too many certificates already issued for exact set of domains
据 Let’s Encrypt 速率限制文档,同一精确域名集每 7 天最多 5 张(滑动窗口)。先查重复任务和已有证书:
certbot certificates
grep -R "certbot|acme.sh" /etc/cron* /etc/systemd/system 2>/dev/null
# 所有调试先预演;生产前再跑 staging
certbot certonly --webroot -w /var/www/html
-d '*.example.com' -d example.com --dry-run
certbot certonly --webroot -w /var/www/html
-d '*.example.com' -d example.com --staging
通配符证书注意事项还包括申请节奏:定时任务重复申请、手工反复重试,都会撞“精确域名集”限额;预演通过再切生产。
怎么确认配置真的生效?6 项验证清单
配置改完、证书换上,怎么判断”真的生效”而不是”看起来生效”?下面 6 项按从证书本身到监控链路的顺序给出可复制命令,每项都写明期望输出与失败判据。据 OpenSSL 官方文档,s_client 默认不校验主机名,所以第 1 项必须显式带 -servername,否则可能连到错误虚拟主机上得到假阳性结果。
1. 证书内容核对(subject / SAN / 剩余天数)
# 取服务端实际下发的叶子证书,检查主体、签发者、有效期与 SAN
openssl s_client -connect a.example.com:443 -servername a.example.com /dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望:subject=CN = *.example.com
# SAN 中同时含 *.example.com 与 a.example.com(部分 CA 会额外写入裸域)
# notAfter 剩余 > 30 天,否则续期自动化已异常
# 剩余天数速算
openssl s_client -connect a.example.com:443 -servername a.example.com /dev/null
| openssl x509 -noout -checkend 2592000 # 2592000 秒 = 30 天,输出 "will not expire" 为通过
2. 链路完整性(中间证书是否下发)
# 本地验证:fullchain 必须能链到系统根
openssl verify -untrusted chain.pem -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# 期望输出:fullchain.pem: OK
# 统计服务端下发条数,期望 2–3 条(叶子 + 1~2 张中间证书)
openssl s_client -showcerts -connect a.example.com:443 -servername a.example.com /dev/null
| grep -c "BEGIN CERTIFICATE"
只下发叶子证书时,桌面 Chrome 常因缓存中间证书而”看起来正常”,但 Android 旧版本与部分 Java 客户端会直接报 unable to get local issuer certificate。这是通配符证书注意事项里最容易被忽略的一条:问题不在私钥,而在服务端证书链配置。
3. 协议与套件(是否残留 TLSv1.0/1.1)
# testssl.sh v3.2+ ,--severity HIGH 只报高危项
./testssl.sh --quiet --severity HIGH https://a.example.com
# 期望:TLS 1.2 与 TLS 1.3 为 offered;TLS 1.0 / 1.1 为 not offered
# 若出现 "VULNERABLE" 行(如 SWEET32、ROBOT),按输出中的 CVE 编号处置
4. HTTP 层复核
curl -sSI https://a.example.com | head -1 # 期望 200 或 301
curl -v https://a.example.com 2>&1 | grep -E "SSL certificate verify|subject:"
# 期望出现 "SSL certificate verify ok" 与实际 CN=*.example.com
5. CAA 与 ACME 复核
dig +short CAA example.com # 期望同时有 issue 与 issuewild
dig +short TXT _acme-challenge.example.com # 续期窗口内应能查到预期值
据 Let’s Encrypt 文档,CAA 检查发生在每次签发(含续期)时;若只写了 issue 而漏掉 issuewild,通配符续期会被拒绝,而普通子域证书仍能签发,故障因此具有欺骗性。
6. CT 日志与到期监控
curl -s "https://crt.sh/?q=%25.example.com&output=json"
| jq -r '.[] | "(.entry_timestamp) (.name_value)"' | tail -5
# 确认最新记录由自己的 ACME 账号签发;出现陌生签发者按私钥泄露流程处理
# Prometheus 告警规则(blackbox_exporter 提供 probe_ssl_earliest_cert_expiry 指标)
- alert: WildcardCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 21 * 86400
for: 1h
| 检查项 | 通过判据 | 典型失败信号 | 影响面 |
|---|---|---|---|
| 证书内容 | subject=*.example.com,SAN 含目标域,剩余 >30 天 | notAfter 已过或 SAN 缺项 | 全站 |
| 链路完整性 | verify 返回 OK,下发 2–3 条 | unable to get local issuer certificate | 移动端/Java 客户端 |
| 协议套件 | 仅 TLS1.2/1.3 offered | TLS1.0 offered、VULNERABLE 行 | 合规审计 |
| HTTP 层 | 200/301,verify ok | 证书不匹配告警 | 用户可见 |
| CAA/ACME | issue 与 issuewild 并存 | 续期 CAA 拒绝 | 未来 90 天 |
| CT 与监控 | 最新记录自签、21 天告警生效 | 陌生签发者记录 | 安全事件 |
这 6 项建议串成一条上线后 10 分钟内跑完的脚本;其中第 2 项与第 5 项失败时症状延迟出现,最值得固化为 CI 中的阻断式检查。关于私钥存放位置、HSTS 与 OCSP Stapling 的配合,属于同一张通配符证书的风险半径问题,需与上述验证一并纳入变更评审。
不能。RFC 6125 §6.4.3 规定通配符只匹配最左侧一个标签,*.example.com 只覆盖 a.example.com 这一级;a.b.example.com 需要单独签发 *.b.example.com。同时 *.*.example.com 这类多级通配符不被任何公共 CA 支持,CA/Browser Forum 基线要求也禁止部分通配符(如 f*.example.com)。
通配符签发走的是 issuewild 属性,不是 issue。按 RFC 8659,CA 在签发通配符时会专门查找 issuewild,只有 issue 而没有 issuewild 时,部分 CA 会判定为未授权。正确做法是同时配置 0 issue "letsencrypt.org" 与 0 issuewild "letsencrypt.org",并等待 TTL 过期后重试。
不行。据 Let's Encrypt 官方文档,通配符证书只能通过 DNS-01 校验,HTTP-01 与 TLS-ALPN-01 均不支持。这意味着你必须能通过 API 写入 _acme-challenge 的 TXT 记录,或者用 CNAME 把 _acme-challenge.example.com 委托到有 API 的另一个域名上。
DV 通配符国内渠道约 ¥400–2000/年,可以覆盖不限数量的二级子域;精确域名证书单张更便宜,但子域一多总价反超,且新增子域要重签。安全性上精确域名泄露只影响单个主机名,通配符泄露影响全部同级子域。经验阈值是子域 ≥20 个或涉及 ≥3 个团队时按业务拆成多张通配符,对外 API 这类固定域名用精确证书。
第一步立即吊销并重签(certbot revoke 或 CA 控制台操作),第二步生成全新密钥对而不是复用旧私钥,第三步灰度替换所有持有节点并 systemctl reload nginx(reload 不断连接,restart 会中断),第四步用 openssl s_client 与 CT 日志双向确认全网已切换,第五步复盘私钥是怎么流出的。整个过程建议控制在 2–6 小时内,并提前演练过一次。
多数是 SNI 或证书链问题。先确认 Nginx 的 server_name 是否精确匹配、默认 server 块是否兜底到了别的证书;再用 openssl s_client -showcerts 数证书条数,正常应为 2–3 条,缺中间证书时桌面浏览器可能靠缓存补齐,而 Android、Java、Go 客户端会直接握手失败。
不可以。EV 证书按规范不支持通配符域名,只签发精确的 FQDN。如果业务确实需要 EV 展示,只能为具体主机名单独申请;通配符场景下可选项只有 DV 与 OV,其中 OV 通配符需要做组织身份核验,签发周期通常 1–3 个工作日。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。