Sectigo(原 COMODO)通配符 SSL 证书实战:CSR 生成、DCV 验证到 Nginx/Apache 部署
问题背景与根因:多子域架构下单域名证书为何必然失效
当业务从 example.com 扩展到 api.example.com、admin.example.com、cdn.example.com、tenant1.example.com 时,运维最先撞上的往往不是架构问题,而是证书问题:每个子域一张单域名证书,意味着 N 张证书、N 次续期、N 套到期监控。漏掉任何一张,用户看到的就是浏览器的红色警告页,API 调用方收到的是握手失败。
根因在于 X.509 证书的域名匹配规则。证书通过 SAN(subjectAltName)扩展声明自己覆盖哪些主机名,浏览器与 TLS 客户端按 RFC 6125 逐条比对。单域名证书的 SAN 只有 example.com,访问 api.example.com 时比对失败,Chrome 抛出 NET::ERR_CERT_COMMON_NAME_INVALID,curl 则直接报错:
curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com'
通配符证书把 SAN 写成 *.example.com,用一条通配规则覆盖同一父域下的所有一级子域。但通配符并非“无限覆盖”,实际使用中有三个高频误判:
- 不覆盖根域:
*.example.com不匹配example.com,必须把根域作为额外 SAN 一起申请(Sectigo 通配符产品通常允许在同一张证书里追加根域)。 - 只匹配一个标签:
*.example.com匹配a.example.com,不匹配a.b.example.com。多级子域需要单独申请*.b.example.com。 - 星号位置受限:
a.*.example.com、*.com这类写法不被 CA 与浏览器接受,提交 CSR 时就会被 CA 驳回。
还有一条容易被忽略的硬约束:自 2020-09-01 起,Apple 与 Chrome 要求所有公开信任的 TLS 证书有效期不得超过 398 天,Sectigo 签发的通配符证书实际有效期通常为 1 年(365 天左右),到期必须重签,不能“一次买断永久使用”。这意味着续期流程必须自动化或至少有告警,否则 398 天后的凌晨就是故障时间。
证书类型与通配符匹配规则:DV、OV、EV 的现状
选型前先厘清验证等级。Sectigo(原 COMODO CA)的通配符产品线主要分 DV 与 OV 两档,EV 通配符已极少签发。
| 类型 | 验证内容 | 典型签发时长 | 浏览器表现 |
|---|---|---|---|
| DV(域名验证) | 仅验证域名控制权:DNS CNAME/TXT、HTTP 文件或管理员邮箱 | 5 分钟 – 2 小时 | 地址栏锁形图标 + HTTPS |
| OV(组织验证) | 域名控制权 + 营业执照、组织名称、地址、电话回访(须与 WHOIS 或第三方数据库一致) | 1 – 3 个工作日 | 锁形图标,证书详情中显示 O 字段 |
| EV(扩展验证) | 在 OV 基础上追加法律实体、经营状态、反欺诈核查 | 3 – 7 个工作日 | 锁形图标,O 字段显示公司全名 |
必须修正一个流传很广的过时说法:EV 证书的“绿色地址栏”已经不存在。Chrome 自 77 版(2019 年)起移除了 EV 的绿色视觉标识,Safari 15 起也不再显示,Firefox 同样只保留锁图标。EV 当前的价值在于合规审计与法律背书,而非视觉差异,采购时不要为“绿条”付费。
通配符匹配行为可以用一张表说清楚,测试时按这张表逐条验证即可:
| 证书 SAN | example.com | www.example.com | a.b.example.com | example.net |
|---|---|---|---|---|
*.example.com |
不匹配 | 匹配 | 不匹配 | 不匹配 |
*.example.com + example.com |
匹配 | 匹配 | 不匹配 | 不匹配 |
example.com(单域名) |
匹配 | 不匹配 | 不匹配 | 不匹配 |
结论:绝大多数生产环境应当申请 *.example.com 且把 example.com 一并写入 SAN。这一步在提交 CSR 时就要做对,证书签发后再补根域只能走重签流程。
实操第一步:生成私钥与 CSR(含一致性校验)
CSR 是向 CA 提交的唯一凭据,其中的 CN 与 SAN 直接决定最终证书覆盖范围。以下命令可直接执行,注意 CN 必须写成 *.example.com,不能带 https://、不能带路径、不能带端口。
mkdir -p /etc/ssl/sectigo && cd /etc/ssl/sectigo
# 生成 2048 位 RSA 私钥 + CSR,同时写入根域 SAN
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology Co., Ltd./OU=IT/CN=*.example.com'
-addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
chmod 600 example.com.key
chmod 644 example.com.csr
几点参数说明:-nodes 表示私钥不加密(否则 Nginx 每次 reload 都要交互输入密码);-addext 需要 OpenSSL 1.1.1 及以上,若系统版本较低,改用配置文件加 [v3_req] 段的 subjectAltName;ECDSA 用户可将 -newkey rsa:2048 换成 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1,但需确认所购产品支持 ECC 签发,传统通配符 DV 建议仍用 RSA 2048 以保证老旧客户端兼容。
提交前必须做三项校验,任何一项不通过都会导致签发后无法部署:
# 1. CSR 签名自校验,必须输出 verify OK
openssl req -in example.com.csr -noout -verify
# 2. 确认 SAN 与 CN 正确
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
# 3. 私钥与 CSR 公钥指纹必须完全一致
openssl req -in example.com.csr -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
第 3 步两条 SHA256 值不一致,说明私钥与 CSR 不是一对,后续必然触发 key values mismatch。此时不要试图“修”,直接重新生成一对,成本远低于排查时间。CSR 本身不含私钥,可以安全地粘贴到 CA 的申请表单中。
实操第二步:完成 DCV 域名验证(HTTP 文件 / DNS CNAME / 邮件)
Sectigo 对通配符证书只要求验证父域 example.com 的控制权,星号部分无需单独验证。三种 DCV 方式按可靠性排序如下。
方式一:DNS CNAME(推荐,可长期复用)。CA 会给出形如 _dnsauth.example.com 的记录名与一个随机值。添加记录后必须从公共 DNS 视角确认生效:
dig +short CNAME _dnsauth.example.com @8.8.8.8
dig +short CNAME _dnsauth.example.com @1.1.1.1
注意 _dnsauth 子域不能与已有 CNAME 冲突(同一主机名不能既有 CNAME 又有 A 记录),若冲突需先删除旧记录。TTL 建议设为 300 秒,验证通过后再改回,避免每次重签等待缓存过期。
方式二:HTTP 文件验证。把 CA 提供的随机文件名与内容放到站点根目录下:
mkdir -p /var/www/html/.well-known/pki-validation
echo -n '3f7a9c2e8b1d4f6a5c9e0d2b7a1f4e8c'
> /var/www/html/.well-known/pki-validation/9A8B7C6D5E4F.txt
# 本机与公网双重确认
curl -s http://example.com/.well-known/pki-validation/9A8B7C6D5E4F.txt
curl -s -o /dev/null -w '%{http_code}n' http://example.com/.well-known/pki-validation/9A8B7C6D5E4F.txt
三个坑必须提前规避:/.well-known 路径不能被 Nginx 的 location ~ .(txt)$ 之类规则拦截返回 403;不能返回 301/302 跳转到其他域名;CDN 或 WAF(Cloudflare、阿里云盾等)可能把验证请求当作爬虫拦截,验证期间需对该路径加白名单或临时回源。
方式三:管理员邮箱验证。仅支持 admin@、administrator@、webmaster@、hostmaster@、postmaster@ 五个固定前缀,且邮箱必须与 WHOIS 或 DNS SOA 记录一致。WHOIS 隐私保护开启时该方式通常不可用,不建议作为主方案。
验证失败的典型通知邮件是 The Certificate Authority received a response from the server that was not the expected response,九成是内容不一致(多了换行、BOM 或 CDN 缓存了旧文件),用 curl -s ... | xxd | head 对比字节即可定位。
实操第三步:证书链拼接与 Nginx / Apache 配置示例
CA 邮件里通常给两个文件:服务器证书(.crt)与中间证书(CA Bundle)。直接把 .crt 配进 Web 服务器是最常见的错误,会导致部分安卓客户端与 Java 客户端报 unable to verify the first certificate。必须先拼接完整链,顺序为“叶证书 → 中间证书”,不要包含根证书:
cat example.com.crt Sectigo_CA.crt > example.com.fullchain.pem
# 确认顺序正确,输出应依次为 *.example.com 与中间 CA
openssl crl2pkcs7 -nocrl -certfile example.com.fullchain.pem
| openssl pkcs7 -print_certs -noout
Nginx 配置示例(TLS 1.2/1.3,开启 OCSP Stapling 与 HSTS):
server {
listen 443 ssl http2;
server_name example.com *.example.com;
ssl_certificate /etc/ssl/sectigo/example.com.fullchain.pem;
ssl_certificate_key /etc/ssl/sectigo/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/ssl/sectigo/Sectigo_CA.crt;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}
Apache 2.4.8 及以上版本可让 SSLCertificateFile 直接指向 fullchain,老版本需单独指定链文件:
<VirtualHost *:443>
ServerName example.com
ServerAlias *.example.com
SSLEngine on
SSLCertificateFile /etc/ssl/sectigo/example.com.fullchain.pem
SSLCertificateKeyFile /etc/ssl/sectigo/example.com.key
# Apache < 2.4.8 才需要下面这行
# SSLCertificateChainFile /etc/ssl/sectigo/Sectigo_CA.crt
</VirtualHost>
重载前务必先做语法检查,避免把线上服务 reload 成 down:nginx -t && systemctl reload nginx,或 apachectl configtest && systemctl reload httpd。HSTS 头一旦下发就会被浏览器缓存 max-age 秒,首次上线建议先用 max-age=300 观察一周再拉长到一年。
对比表格:Sectigo 通配符、Let’s Encrypt 与多域名 SAN 证书
选型不该只看价格,要按“域名结构 + 续期能力 + 合规要求”三个维度决策。
| 维度 | Sectigo 通配符 DV | Sectigo 通配符 OV | Let’s Encrypt 通配符 | 多域名 SAN 证书 |
|---|---|---|---|---|
| 验证方式 | DNS / HTTP / 邮件 | 域名验证 + 组织资料 + 电话回访 | 仅 DNS-01 | 每个域名单独验证 |
| 有效期上限 | ≤ 398 天(通常 1 年) | ≤ 398 天(通常 1 年) | 90 天 | ≤ 398 天 |
| 覆盖范围 | 一级子域无限扩展 | 一级子域无限扩展 | 一级子域无限扩展 | 明确列出的域名,可含多级子域 |
| 是否含根域 | 需额外加 SAN | 需额外加 SAN | 需额外加 SAN | 直接列出即可 |
| 二级子域 a.b.example.com | 不支持 | 不支持 | 不支持 | 支持 |
| 续期自动化 | 需对接 CA API 或人工 | 人工 + 组织资料复核 | certbot / acme.sh 全自动 | 人工 |
| 适用场景 | 商业站点、需要厂商支持与保修 | 金融、政企、需展示组织身份 | 内部系统、成本敏感、域名结构稳定 | 域名分散在多个父域 |
一个常见的组合策略是:对外主站与支付相关子域用 Sectigo 通配符(有商业支持与责任条款),内部测试环境用 Let’s Encrypt 通配符并通过 acme.sh --dns dns_ali 之类的 DNS API 全自动续期。注意 Let’s Encrypt 已于 2025 年起提供有效期 6 天的短期证书选项,同时 CA/Browser Forum 已通过分阶段缩短证书有效期的方案,未来上限会从 398 天逐步压缩,任何依赖“一年一续”的人工流程都需要提前改造成自动化。
常见错误排查:真实报错与修复命令
报错 1:Nginx 启动失败。
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不配对,多为重签后只替换了证书没替换私钥。比对模数即可确认:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两个 MD5 不一致就换回配套文件,不要尝试修改证书。
报错 2:curl 与 Java 客户端校验失败。
curl: (60) SSL certificate problem: unable to verify the first certificate
缺中间证书。执行 openssl s_client -connect example.com:443 -showcerts </dev/null,如果输出只有一张证书,说明配置的是 .crt 而非 fullchain,按上一节重新拼接。
报错 3:浏览器域名不匹配。
NET::ERR_CERT_COMMON_NAME_INVALID
SSL_ERROR_BAD_CERT_DOMAIN
通常是访问了根域或二级子域。用命令确认证书实际覆盖范围:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -ext subjectAltName
若 SAN 中缺少 example.com,只能重签并补 SAN;若访问的是 a.b.example.com,需为 *.b.example.com 单独申请。
报错 4:证书过期或系统时间错误。
x509: certificate has expired or is not yet valid
先查服务器时间:timedatectl status,偏差超过 5 分钟即会导致握手失败,执行 timedatectl set-ntp true 校时;若时间正确,则是证书确实过期,检查续期任务是否执行。
报错 5:DCV 反复失败。除内容不匹配外,还要检查是否被 CDN 缓存了 404 页面、.well-known 目录权限是否为 755、验证文件是否被 WAF 规则拦截。可临时绕过 CDN 直连源站 IP 用 curl -H 'Host: example.com' http://<源站IP>/.well-known/pki-validation/xxx.txt 验证。
效果验证与到期监控
部署完成后不能只看浏览器有没有锁图标,要按“链完整性、域名覆盖、协议版本、剩余天数”四项逐条验证。
# 1. 证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. SAN 覆盖范围
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -ext subjectAltName
# 3. 链完整性:出现 verify return:1 且无 error 即为通过
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 4. 确认已禁用 TLS 1.0/1.1,期望返回 handshake failure
openssl s_client -connect example.com:443 -tls1_1 </dev/null
再把到期检查写成定时任务,剩余天数低于阈值就告警,这是避免“证书过期事故”最便宜的手段:
#!/usr/bin/env bash
HOST='example.com'
END=$(echo | openssl s_client -connect ${HOST}:443 -servername ${HOST} 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
END_TS=$(date -d "${END}" +%s)
LEFT=$(( (END_TS - $(date +%s)) / 86400 ))
echo "${HOST} 证书剩余 ${LEFT} 天"
[ "${LEFT}" -lt 30 ] && echo "WARN: ${HOST} 证书即将到期" | mail -s 'SSL 到期告警' ops@example.com
注意 date -d 是 GNU date 语法,macOS 需改用 date -j -f '%b %d %T %Y %Z'。除自建脚本外,建议叠加一层外部拨测(从公网多地发起 TLS 握手),因为自建脚本跑在内网时可能命中内网 DNS 或负载均衡器,看到的证书与真实用户看到的不一致。最后用 curl -vI https://api.example.com 对每个实际在用的子域抽查一遍,确认 SNI 返回的是同一张通配符证书。
常见问题
通配符证书能保护 example.com 主域吗?
不能。*.example.com 中的星号只能匹配一个标签,example.com 本身没有标签可供替换,因此不在覆盖范围内。解决办法是在提交 CSR 时把 example.com 一并写入 subjectAltName,Sectigo 的通配符产品通常允许免费附加根域;若已经签发完成,只能重新签发,无法事后追加。
一张通配符证书能覆盖 a.b.example.com 这种二级子域吗?
不能。*.example.com 只匹配 a.example.com 这一层。要覆盖 a.b.example.com,需要单独申请 *.b.example.com 通配符证书,或改用多域名 SAN 证书把具体主机名逐个列出。规划域名结构时,建议把业务层级压平到一级子域,能显著降低证书管理成本。
证书续期时需要重新做域名验证吗?
取决于 CA 的复用策略。Sectigo 对同一域名在验证有效期(通常 398 天内)内可复用已有 DCV 结果,但一旦超出窗口或更换了验证方式,就必须重新验证。使用 DNS CNAME 方式并保留记录不删除,是让续期最省事的方法;HTTP 文件验证的随机文件名每次都会变化,需要重新放置文件。
同一张通配符证书可以部署到多台服务器吗?
可以,私钥不受服务器数量限制。但私钥副本越多,泄露风险越大。生产环境建议把私钥集中存放在密钥管理服务或配置管理系统中,通过自动化下发,并确保文件权限为 600、属主为运行 Web 服务的账号。一旦私钥外泄,必须立即吊销并重签,同时排查日志中是否有异常使用。
为什么买了 EV 证书,浏览器地址栏没有变绿?
因为绿色地址栏已被主流浏览器移除。Chrome 自 77 版起不再对 EV 证书显示绿色标识,Safari 15 与 Firefox 也已跟进,现在所有 HTTPS 站点统一显示锁形图标。EV 的当前价值体现在证书详情的 O 字段、合规审计与法律背书,采购时应以业务合规需求为依据,而非视觉差异。
证书有效期为什么不能超过 398 天?
这是 CA/Browser Forum 基线要求与 Apple、Chrome 根证书策略共同作用的结果,自 2020-09-01 起对公开信任证书强制执行,目的是缩短密钥泄露的暴露窗口。Let’s Encrypt 更进一步,默认有效期仅 90 天。行业已确定继续缩短有效期的路线图,运维流程应尽早从人工续期切换到 ACME 自动化或 CA API 自动化。