DigiCert 证书下载全流程:CertCentral 导出 PEM/PFX 并在 Nginx/IIS 部署
DigiCert 证书下载入口在 CertCentral 的 Orders → 目标订单 → Download certificate;Nginx 选 Apache/NGINX 的 PEM 链文件,IIS/Tomcat 选 PFX,私钥不会随证书下载(CSR 在本地生成时)。 下载后先跑 openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName,确认 CN/SAN 与到期日;DigiCert 常见中间证书为 DigiCert TLS RSA SHA256 2020 CA1 或 DigiCert Global G2 TLS RSA SHA256 2020 CA1。 Nginx 的 ssl_certificate 必须指向 fullchain.pem(叶证书在前、中间证书在后),只放叶证书会让 Java/Android 客户端报 PKIX path building failed。 IIS 导入 PFX 时勾选“包括所有中间证书”,Tomcat 10.1 在 server.xml 设置 keystoreType='PKCS12';PFX 密码建议 16 位以上并存入密码库。 验证用 openssl s_client -connect example.com:443 -servername example.com -showcerts,输出 2-3 张证书且 SSL Labs 达到 A/A+,OCSP stapling 显示 Yes。
为什么在 DigiCert 后台找不到证书下载?先分清订单状态、证书格式与私钥归属
问:订单已经付款,为什么 CertCentral 里就是没有 “Download certificate” 按钮?这也是 digicert 证书下载 最常见的卡点。DigiCert 目前主要交付入口是 CertCentral(certcentral.digicert.com),只有订单状态为 Issued 时,订单详情页才会出现可点击的 Download certificate。处于 Pending、Processing、Waiting for domain validation 时,按钮置灰不可用,或只提供 Reissue。据 DigiCert 文档,DV 证书在 DCV 通过后通常几分钟到 24 小时内签发;OV/EV 需 1–3 个工作日的组织人工核验,这段时间反复刷新不会让按钮提前出现。DCV 本身最常见的失败是 DNS TXT/CNAME 未生效(受 TTL 影响,通常 5 分钟至 48 小时)、HTTP 验证文件被 WAF 拦截、验证邮箱无人查收。可用 dig 自查:
# 检查 DigiCert DCV 的 CNAME 是否已全球可见
dig +short _dnsauth.example.com CNAME
# 期望输出形如 xxxxx.dcv.digicert.com.;返回空说明记录未生效或主机名填错
dig +short _dnsauth.example.com TXT # 若使用 TXT 方式验证则查这一条
问:下载包里为什么没有私钥?因为 DigiCert 从未持有你的私钥。据 DigiCert 文档,私钥生成在你提交 CSR 的那台服务器上,CA 只对公钥部分签名,无法”代取”。所以一次 digicert 证书下载 拿到的 zip 里只有叶证书与中间证书链。若你使用了 DigiCert 的 CSR 生成工具或密钥托管(Key Management)服务,私钥才存在于对应订单页,需单独导出。换服务器重装时必须带上原机器的 .key,否则只能重新签发。
问:PEM、PFX、P7B、DER 该选哪个?
| 格式 | 编码 / 容器 | 含私钥 | 典型部署场景 |
|---|---|---|---|
| PEM(.pem/.crt/.cer) | Base64 文本,RFC 7468 | 否 | Nginx、Apache,需与 .key 配对 |
| PFX / P12 | PKCS#12 二进制容器,RFC 7292 | 是 | IIS、Tomcat、Windows 证书存储 |
| P7B | PKCS#7,仅证书链 | 否 | Java keystore 导入、Windows 中间证书 |
| DER(.der/.cer) | 二进制单证书 | 否 | 部分网络设备、Java 应用 |
选错的后果很具体:把 P7B 直接喂给 Nginx 会报 SSL_CTX_use_certificate_chain_file() failed (SSL: error:...PEM lib);把 PEM 导入 IIS 则提示找不到私钥。下载时务必勾选 Include intermediate certificates,否则只拿到叶证书。
问:怎么确认下到的文件是对的?
# 1) 数一数 PEM 里有几张证书(应为叶证书 + 中间证书,通常 2 张)
grep -c "BEGIN CERTIFICATE" fullchain.crt
# 2) 检查 PFX 是否含私钥:输出中出现 MAC 行即含私钥
openssl pkcs12 -in digicert.pfx -info -noout -passin pass:你的密码
# 3) 验证链是否完整;缺中间证书会报 unable to get local issuer certificate
openssl verify -untrusted chain.crt -CAfile /etc/ssl/certs/ca-certificates.crt server.crt
DigiCert 的链通常是 DigiCert Global Root G2 与 DigiCert Global G2 TLS RSA SHA256 2020 CA1 成对出现,只配叶证书会让部分 Android 与 Java 客户端报链不完整。另外续期订单签发的是全新证书,不会覆盖旧文件,旧证书到期前仍可正常使用——这一点常被误判成”下载失败”。
还有几类非技术原因:账户角色为 Limited 或 Finance 时没有下载权限,需 Admin 授权;订单在旧版 portal 或经销商(Reseller)平台下单,只能回原平台取;证书已吊销或过期,Download 会变为 Reissue。核对这几点后仍无按钮,可直接在 CertCentral 提交支持工单并附上订单号。
DigiCert 证书下载的 6 步实操:从登录 CertCentral 到拿到 fullchain.pem
Q:在 CertCentral 里点完 Download certificate,为什么还要选 Server type?选错会怎样? 选错不会让证书作废,但会让你拿到 Nginx 无法读取的 DER 二进制文件,或者缺少中间证书的“裸证书”,浏览器会报 unable to get local issuer certificate。Server type 只决定编码与打包方式;据 DigiCert 官方文档,PEM 是 Base64 ASCII 文本(编码规则见 RFC 7468),DER 是二进制 ASN.1(见 RFC 5280),二者是同一张证书的两种序列化形式。
| Server type | 输出格式 | 解压后典型文件 | 适用场景 |
|---|---|---|---|
| Apache/NGINX/OpenSSL | PEM (.crt) | example.com.crt、DigiCertCA.crt | Nginx、Apache httpd、HAProxy |
| Microsoft IIS | PFX (PKCS#12) | example.com.pfx | IIS 8+,私钥与链一并导入 |
| Java/Tomcat | PFX 或 JKS | example.com.pfx / .jks | Tomcat 8.5+ 建议用 PKCS12 |
| Other | PEM / DER / P7B | .der、.p7b | 老旧设备、Java keystore 中间产物 |
- 用管理员或拥有订单权限的账号登录
https://certcentral.digicert.com,左侧 Orders → Orders,筛选Status=Issued,或直接按订单号、Common Name 搜索。看不到订单,多半是它被分配到了你无权访问的子账户。 - 进入订单详情点 Download certificate。按钮灰色时,去 Users 确认角色是 Admin 或 Manager——这是 digicert 证书下载 环节最常见的权限问题。
- 选择 Server type,并务必勾选包含中间证书/证书链的选项(界面文案为 Include intermediate certificates)。
- PFX 需现场设置导入密码:建议 16 位以上,含大小写、数字与符号,记入密码库。下载的 .zip 解压后得到
example.com.crt与DigiCertCA.crt。不要用记事本打开 PEM 再“另存为”,Windows 会写入 UTF-8 BOM,OpenSSL 随即报错:PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)。 - 上传到服务器目录并收紧权限:
# 证书目录,属主 root:root,目录 755 sudo install -d -m 755 -o root -g root /etc/ssl/digicert # 私钥必须 600,否则 nginx 启动时可能静默降权或直接拒绝 sudo install -m 600 -o root -g root example.com.key /etc/ssl/digicert/ sudo install -m 644 -o root -g root example.com.crt DigiCertCA.crt /etc/ssl/digicert/ # SELinux 为 enforcing(CentOS/RHEL 默认)时必须打标签,否则 nginx 报 13: Permission denied sudo restorecon -Rv /etc/ssl/digicert sudo chcon -t cert_t /etc/ssl/digicert/* - 合并链并生效:
cd /etc/ssl/digicert # 服务器证书在前、中间证书在后,顺序颠倒部分客户端会校验失败 cat example.com.crt DigiCertCA.crt > fullchain.pem openssl verify -untrusted DigiCertCA.crt example.com.crt # 期望输出 example.com.crt: OK sudo nginx -t && sudo systemctl reload nginx # 必须先 -t 再 reload openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code' # 期望 0 (ok)Nginx 对应配置为
ssl_certificate /etc/ssl/digicert/fullchain.pem;与ssl_certificate_key /etc/ssl/digicert/example.com.key;;IIS 在 MMC 证书管理单元的“个人”存储中右键“所有任务 → 导入”PFX,或在 IIS 管理器中用“完成证书申请”绑定;Tomcat 则修改conf/server.xml,在<SSLHostConfig>中写入certificateKeystoreFile、certificateKeystorePassword、certificateKeystoreType="PKCS12"后重启,并在logs/catalina.out确认没有Keystore was tampered with, or password was incorrect。
如果你的证书是从 CSR 自行生成、而非 CertCentral 直接签发,同样的 6 步仍然适用——只是第 4 步的私钥来自你本地的 OpenSSL 而非下载包,据 Let’s Encrypt 与 Mozilla Server Side TLS 指南,私钥 600、链文件完整这两条是任何 CA 都通用的底线。
Nginx 1.24、IIS 10、Tomcat 10.1 的配置片段与 OpenSSL 3.0 校验命令
拿到从 CertCentral 导出的文件后,真正的风险点在“链是否完整、私钥是否匹配、协议是否合规”。下面按 Web 服务器逐项给出可直接粘贴的配置与校验命令。
Nginx 1.24/1.26 的最小可用配置怎么写?把 fullchain.pem(站点证书 + DigiCert 中间证书)和私钥放在同一目录,权限 600、属主 root。注意 ssl_protocols 自 1.23.4 起默认即为 TLSv1.2 TLSv1.3,ssl_prefer_server_ciphers 自 1.21.4 起默认为 off,写出来是为了显式固化行为:
# /etc/nginx/conf.d/example.conf —— Nginx 1.24 / 1.26 通用
server {
listen 443 ssl;
http2 on; # 1.25.1+ 新语法;1.24 用 listen 443 ssl http2;
server_name example.com;
ssl_certificate /etc/ssl/digicert/fullchain.pem; # 必须含中间证书
ssl_certificate_key /etc/ssl/digicert/private.key;
ssl_protocols TLSv1.2 TLSv1.3;
# ssl_ciphers 仅作用于 TLS1.2 及以下;TLS1.3 套件由 ssl_conf_command Ciphersuites 控制
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305';
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m; # 默认 none
ssl_session_timeout 1d; # 默认 5m
# OCSP stapling:缺 ssl_trusted_certificate 会失败,见下文
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/ssl/digicert/chain.pem; # 中间证书 + 根证书
resolver 8.8.8.8 1.1.1.1 valid=300s;
resolver_timeout 5s;
}
若只开了 ssl_stapling on 而漏掉 ssl_trusted_certificate,Nginx 在 error_log 中记录 "ssl_stapling" ignored, issuer certificate not found,握手仍成功但 stapling 静默失效。验证方式:openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -i "OCSP Response Status",期望 successful。据 Mozilla Server Side TLS 指南,OCSP stapling 已因隐私与性能原因成为推荐的吊销信息分发方式。
如何确认证书与私钥是一对?OpenSSL 3.0 下用公钥比对最通用(RSA/ECDSA 均适用):
openssl x509 -in example.com.crt -noout -pubkey > cert.pub
openssl pkey -in private.key -pubout > key.pub
diff cert.pub key.pub # 无输出=匹配;有输出则证书与私钥不配套
# 传统 RSA 等价做法(OpenSSL 3.0 仍可用):
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in private.key | openssl md5
怎么校验完整链?把 DigiCert Global Root G2 作为信任锚,中间证书用 -untrusted 传入:
openssl verify -CAfile DigiCertGlobalRootG2.crt
-untrusted DigiCertGlobalG2TLSRSASHA2562020CA1.crt example.com.crt
# 期望输出:example.com.crt: OK
# 若报 error 20 at 0 depth lookup: unable to get local issuer certificate
# → 根或中间证书缺失,多半是导出了单证书而非 fullchain
这也是 digicert 证书下载 时最容易踩的坑:CertCentral 提供 “Certificate only” 与 “Certificate + intermediates” 两种下载,Nginx/Tomcat 必须选后者。重新下载一次通常比手工拼接更快。
IIS 10 与 Tomcat 10.1 怎么配?三者差异集中在证书容器格式与中间证书处理方式上:
| 平台 | 推荐格式 | 中间证书处理 | 生效命令 |
|---|---|---|---|
| Nginx 1.24/1.26 | PEM(fullchain + key) | 拼接进 fullchain.pem | nginx -t && nginx -s reload |
| IIS 10(WinSrv 2019/2022) | PFX(PKCS#12) | 导入时勾选“包括所有中间证书” | iisreset |
| Tomcat 10.1 + Java 17 | PKCS12 或 JKS | PKCS12 内已含链 | 重启 Catalina |
IIS 侧可用图形界面(certlm.msc → 个人 → 导入 PFX → 勾选“包括所有中间证书”),也可脚本化:
# Windows Server 2019/2022 + PowerShell 5.1/7.x
Import-PfxCertificate -FilePath C:digicertexample.pfx `
-CertStoreLocation Cert:LocalMachineMy `
-Password (ConvertTo-SecureString -String 'P@ssw0rd!' -AsPlainText -Force)
Tomcat 10.1 的 Connector 直接吃 PFX,无需转换:
<!-- conf/server.xml,Tomcat 10.1 + Java 17 -->
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true"
keystoreFile="/opt/tomcat/conf/example.pfx"
keystoreType="PKCS12"
keystorePass="******" />
<!-- 若下游仍要求 JKS:
keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12
-destkeystore example.jks -deststoretype JKS -->
最后用 openssl s_client -connect example.com:443 -servername example.com -showcerts 复核线上实际下发的证书数量:返回 2 张(站点证书 + 中间证书)即链完整,仅 1 张说明服务器未正确加载中间证书,Android 与 Java 客户端会直接握手失败。
PEM、PFX、P7B、DER 怎么选?DigiCert 下载格式对比与选型表
在 CertCentral 里点“下载证书”时,你会看到 PEM、PFX、P7B、DER 甚至 JKS 等多个选项——选错的直接后果是私钥被拷到不该放它的机器上,或者 Nginx 启动时报 SSL_CTX_use_PrivateKey_file() failed。判断规则只有一条:证书要装在哪台机器上,私钥就必须生成/保存在哪台机器上。DigiCert 在签发时并不持有你的私钥(CSR 模式),所以“digicert 证书下载”拿到的 PEM/P7B/DER 天然不含私钥,只有你上传 PFX 或由工具打包时才带私钥。据 DigiCert 官方文档,CertCentral 的下载格式正是按“服务器类型”分类(Apache/Nginx → PEM,IIS/Tomcat → PFX,Java → JKS/P7B,其他设备 → DER/CRT)。
| 格式 | 扩展名 | 是否含私钥 | 典型场景 | 关键命令 |
|---|---|---|---|---|
| PEM | .pem/.crt/.cer | 否 | Nginx/Apache/HAProxy | cat leaf.crt intermediate.crt > fullchain.pem |
| PFX/P12 | .pfx/.p12 | 是 | IIS/Tomcat/Windows | openssl pkcs12 -in cert.pfx -info -nodes |
| P7B | .p7b | 否 | Java 信任链/IIS 中间证书 | openssl pkcs7 -in chain.p7b -print_certs |
| DER | .der/.cer | 否 | 网络设备/Java 单证书 | openssl x509 -inform DER -in cert.der -out cert.pem |
Nginx 用 PEM:为什么必须自己拼接? 因为 Nginx 的 ssl_certificate 只读取一个文件,且不会自动补中间证书,漏掉中间证书会让部分 Android、Java 客户端报 unable to get local issuer certificate。顺序固定为叶证书在前、中间证书在后。
# 1) 拼接完整链(叶证书必须在最前,DigiCert 中间证书在后)
cat example.com.crt DigiCert_TLS_RSA_SHA256_2020_CA1.crt > fullchain.pem
# 2) RSA 证书校验:两条命令输出的 MD5 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# 3) ECC(P-256) 证书改用公钥比对
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout -in example.com.key | openssl md5
# 4) 验证链是否可被系统信任库验证通过(-untrusted 传中间链)
openssl verify -untrusted DigiCert_TLS_RSA_SHA256_2020_CA1.crt fullchain.pem
# /etc/nginx/conf.d/example.conf —— Nginx 1.25.1+ 写法
server {
listen 443 ssl;
http2 on; # 1.25.1 之前写 listen 443 ssl http2;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 含叶+中间
ssl_certificate_key /etc/nginx/ssl/example.com.key; # chmod 600,属主 root
ssl_protocols TLSv1.2 TLSv1.3; # 双栈保留,兼容老客户端
}
# 校验:nginx -t && nginx -s reload
IIS 用 PFX:导入到哪里? 双击 PFX 导入时选“个人”存储,等价于 Cert:LocalMachineMy;若选“受信任的根证书颁发机构”则站点无法绑定。用 PowerShell 可验证:Get-ChildItem Cert:LocalMachineMy | Where-Object {$_.Subject -like "*example.com*"},输出中 HasPrivateKey 必须为 True。P7B 在这里的角色只是补中间证书到“中间证书颁发机构”存储,不能替代 PFX 完成站点绑定。
# 查看 PFX 结构(不导出私钥),确认包含叶证书与中间证书
openssl pkcs12 -in cert.pfx -info -nokeys -passin pass:'YourPass'
# 拆成 PEM 供 Tomcat/HAProxy 复用;-nodes 表示私钥不加密,输出文件务必 chmod 600
openssl pkcs12 -in cert.pfx -nodes -out all.pem -passin pass:'YourPass'
# OpenSSL 3.0 默认用 AES-256-CBC + PBKDF2 生成 PFX;旧版 Windows/Java 不认时报
# "Mac verify error: invalid password?",需降级算法重新打包
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out legacy.pfx -legacy -passout pass:'YourPass'
P7B 和 DER 什么时候才用? P7B 是纯证书容器,适合 Java keytool -importcert -trustcacerts 或给 IIS 补链;DER 是二进制单证书,多数路由器、防火墙、老式负载均衡只吃这个格式。两者都不含私钥,转换后仍需另配私钥。
# P7B → 查看并提取中间链
openssl pkcs7 -in chain.p7b -print_certs -text -noout
openssl pkcs7 -in chain.p7b -print_certs -out chain.pem
# DER → PEM,并核对主题/有效期
openssl x509 -inform DER -in cert.der -out cert.pem
openssl x509 -in cert.pem -noout -subject -issuer -dates
链完整性优先于格式。 无论 PEM 还是 PFX,都必须包含叶证书与至少一张中间证书;根证书通常已预置在客户端信任库(Windows/Android/macOS),不需要也不应该部署到服务器。DigiCert 的中间证书可在其官方仓库按 CA 名称下载,注意 RSA 与 ECC 链不同(如 DigiCert Global Root G2 对应 RSA,G3 对应 ECC)。
密码与合规。 PFX 口令建议 12–16 位以上,交给 Vault、AWS KMS 或 Ansible Vault 管理,绝不写进 Git;用 -passout env:PFX_PASS 从环境变量取值可避免口令出现在 ps 输出里。若使用 OpenSSL 3.0 生成的 PFX,Windows Server 2012 R2 及更早系统可能因不支持 PBKDF2/AES 而导入失败,此时用 -legacy 或改用 Windows 端 Export-PfxCertificate 打包。
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
兼容性与成本。 ECC P-256 证书的 digicert 证书下载格式与 RSA 完全相同,但 Nginx 需 OpenSSL 1.1.1+(建议 3.0)才能同时启用 TLS 1.3 与 X25519;Tomcat 8.5+ 建议显式写 keystoreType="PKCS12",不要依赖默认值。Java 8 早期版本对 SHA-256 中间链的校验路径需要实测。价格上,DV 约数百元/年、OV 约 1500–4000 元/年、EV 约 4000–10000 元/年(以 DigiCert 官网或授权经销商报价为准);按 CA/Browser Forum 基线要求,公开信任 TLS 证书有效期上限已降至 398 天,下载安装后仍须配置到期监控——这一点与 Let’s Encrypt 的 90 天免费证书策略只是周期不同,监控手段一致。
下载后部署报错怎么办?10 个真实错误信息与排查路径
报错不可怕,可怕的是把”格式问题”当成”配置问题”改到半夜。从 CertCentral 完成 digicert 证书下载 后,90% 的部署失败可以归到三类:文件不是 PEM、证书与私钥不配对、链不全。下面按真实报错原文逐条给排查路径。
1)nginx: [emerg] PEM_read_bio_X509_AUX() failed:几乎总是你把 DER 二进制、或者浏览器”另存为”下来的 HTML 页面当成了 .crt。先验格式,再转换:
# 期望输出 "ASCII text";若是 "data"/"DER Encoded" 说明是二进制 DER
file example.com.crt
head -1 example.com.crt # 期望:-----BEGIN CERTIFICATE-----
grep -c "BEGIN CERTIFICATE" example.com.crt # fullchain 应为 2(叶+中间)
# 若确为 DER,按 OpenSSL 文档用 -inform DER 转回 PEM
openssl x509 -inform DER -in cert.der -out cert.pem
2)SSL_CTX_use_PrivateKey: key values mismatch:证书和私钥不是一对,多见于续期后只换了证书、私钥还留着旧的。比对公钥指纹即可,两个 MD5 必须一致:
openssl x509 -in example.com.crt -noout -pubkey | openssl pkey -pubin -outform DER | openssl md5
openssl pkey -in example.com.key -pubout -outform DER | openssl md5
# RSA 密钥还可直接用 modulus 对比(OpenSSL 1.0.2 / 3.x 通用)
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
3)浏览器 NET::ERR_CERT_AUTHORITY_INVALID、Java 抛 PKIX path building failed:典型缺中间证书。RFC 5280 要求服务器发送”叶证书 → 中间证书”的顺序链,倒置同样会失败。用 s_client 看服务端到底发了什么:
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| grep -E "^ *[0-9]+ s:|^ *i:" # 应能看到 DigiCert 的中间 CA 出现在 i: 行
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 叶+中间,顺序不可倒置
ssl_certificate_key /etc/nginx/ssl/example.com.key; # 建议 chmod 600
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 仅供 OCSP stapling,只放中间证书
ssl_protocols TLSv1.2 TLSv1.3; # 参考 Mozilla SSL Configuration Generator
}
# nginx -t && systemctl reload nginx
4)IIS 导入 PFX 提示”指定的网络密码不正确”或”找不到与此证书关联的私钥”:三种成因——密码错、PFX 导出时未勾选”导出私钥”、IIS 应用池账号无读取权限。在 certlm.msc 的”个人”存储中,证书图标带钥匙才代表私钥存在;再授权:
# 管理员 PowerShell:确认私钥是否随证书进入本地计算机存储
Get-ChildItem Cert:LocalMachineMy | Select-Object Subject, Thumbprint, HasPrivateKey
# 授予 IIS_IUSRS 读取私钥(winhttpcertcfg 随 Windows SDK 提供)
winhttpcertcfg -g -c LOCAL_MACHINEMY -s "example.com" -a "IIS_IUSRS"
5)Tomcat 报 Keystore was tampered with, or password was incorrect:PFX 是 PKCS#12,而 Tomcat 的 keystoreType 不写时按 JKS 解析,必然报”被篡改”。先验证密码与别名,再在 Connector 里显式声明类型:
keytool -list -v -keystore example.pfx -storetype PKCS12 -storepass 'YourPassword'
# 需看到 Entry type: PrivateKeyEntry 才算含私钥
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="conf/example.pfx"
certificateKeystoreType="PKCS12" <!-- 关键:不写默认 JKS -->
certificateKeystorePassword="YourPassword" />
</SSLHostConfig>
</Connector>
6)openssl verify 报 unable to get local issuer certificate:本地验证时没把中间证书喂进去。据 OpenSSL 文档,-untrusted 用于提供非根 CA 的中间证书:
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem example.com.crt
# 期望输出:example.com.crt: OK
7)浏览器报 certificate is not yet valid / has expired:服务器时钟漂移或证书确实过期。Let’s Encrypt 与 DigiCert 均建议开启自动续期并监控到期日:
openssl x509 -in example.com.crt -noout -subject -issuer -dates
timedatectl status # 关注 "System clock synchronized: yes"
一张表把定位命令压缩成肌肉记忆:
| 报错原文 | 根因 | 一条命令定位 |
|---|---|---|
| PEM_read_bio_X509_AUX() failed | 文件是 DER 或 HTML | file example.com.crt |
| key values mismatch | 证书与私钥不配对 | openssl x509 -noout -modulus ... | openssl md5 |
| ERR_CERT_AUTHORITY_INVALID / PKIX path building failed | 缺中间证书或顺序倒置 | openssl s_client -showcerts |
| 找不到私钥 / 网络密码不正确 | PFX 无私钥、密码错、无权限 | Get-ChildItem Cert:LocalMachineMy |
| Keystore was tampered with | keystoreType 缺省为 JKS | keytool -list -v -storetype PKCS12 |
| unable to get local issuer certificate | 验证时未提供中间证书 | openssl verify -untrusted chain.pem |
如果你在 CertCentral 的 digicert 证书下载 环节就按”服务器类型”分别取件(Nginx 取 fullchain、IIS/Tomcat 取 PFX),上面前五类错误基本不会发生——导出格式选错,是后面所有排查的起点。
如何确认 DigiCert 证书下载与部署生效?本机、远程与监控三层验证
证书装完就算完事了吗?先在本机把文件读一遍。最省时的排错方式是先用 OpenSSL 读证书本身,别急着 reload 服务。OpenSSL 1.1.1 与 3.x 的 x509 子命令参数一致,-noout 抑制 base64 原文输出,-ext subjectAltName 专门打印 SAN 扩展(SAN 缺失是现代浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 的头号原因)。
# 本机文件自检:主体、签发者、有效期、SAN 一次看全
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
# 期望输出(DigiCert 典型值):
# subject=CN = example.com
# issuer=C = US, O = DigiCert Inc, CN = DigiCert Global G2 TLS RSA SHA256 2020 CA1
# notAfter=Mar 1 23:59:59 2026 GMT
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
# 若 issuer 显示 CN = example.com 自己,说明你下错了文件(把叶子证书当成链用)
怎么证明链是完整的、私钥没坏?据 OpenSSL 官方 verify(1) 文档,-CAfile 指定信任锚,-untrusted 提供中间证书,二者缺一就会得到 verify error:num=20:unable to get local issuer certificate 或 num=21:unable to verify the first certificate。DigiCert 的根 DigiCertGlobalRootG2.crt 可从 CertCentral 的“根证书和中间证书”页面下载,无需联网取 AIA。
# 1) 链验证:期望 example.com.crt: OK
openssl verify -CAfile DigiCertGlobalRootG2.crt
-untrusted DigiCertGlobalG2TLSRSASHA2562020CA1.crt example.com.crt
# 2) 私钥完整性(OpenSSL 1.1.1+ 支持 -check)
openssl pkey -in private.key -check -noout # 期望:Key is valid
# 3) 证书与私钥是否配对(比对模数,RSA 证书适用)
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in private.key | openssl md5 # 两行 md5 必须一致
从外网看,服务端到底发了什么?-servername 触发 SNI(RFC 6066),不带它可能拿到默认站点证书。-showcerts 打印服务端发送的全部证书,用 grep -c 数张数:2~3 张为正常(叶子 + 中间,或叶子 + 中间 + 根),只有 1 张就是漏配中间证书,安卓和老版本 Java 客户端会直接握手失败。
# 远程握手 + 只取叶子证书关键字段
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 数链上证书张数
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
# 协议与套件:两条都应成功(TLS 1.3 需 OpenSSL 1.1.1+,RFC 8446)
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep -E 'Protocol|Cipher'
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null | grep -E 'Protocol|Cipher'
# 枚举套件,确认 TLS 1.0/1.1 已禁用(输出应为 0 ciphers)
nmap --script ssl-enum-ciphers -p443 example.com
浏览器与第三方评级还要看什么?Chrome/Edge 地址栏无警告只是及格线;用 SSL Labs 冲 A/A+,关键是开 OCSP stapling 与 HSTS。Nginx 侧需 ssl_stapling on; ssl_stapling_verify on; 并用 ssl_trusted_certificate 指向含根与中间的文件,否则 stapling 静默失效。HSTS 由 RFC 6797 定义,典型值 max-age=31536000; includeSubDomains,先用短 max-age 灰度再加 preload。
curl -sI https://example.com | grep -i strict-transport-security
echo | openssl s_client -connect example.com:443 -servername example.com -status 2>/dev/null
| grep -i 'OCSP Response Status' # 期望:OCSP Response Status: successful (0x0)
| 验证层 | 命令 / 工具 | 通过标准 | 失败典型报错 |
|---|---|---|---|
| 本机文件 | openssl x509 / openssl verify |
issuer 为 DigiCert 中间 CA,SAN 含主域名,输出 OK |
unable to get local issuer certificate |
| 远程握手 | openssl s_client / nmap ssl-enum-ciphers |
链 2~3 张,TLS 1.2/1.3 均成功,TLS 1.0/1.1 为 0 ciphers | 服务端日志 SSL_do_handshake() failed |
| 外部评级与监控 | SSL Labs / blackbox_exporter / Zabbix | A 以上,OCSP stapling=Yes,剩余有效期 > 30 天 | probe_ssl_earliest_cert_expiry 逼近 time() |
怎么让证书过期这件事自己报警?Prometheus 的 blackbox_exporter 暴露 probe_ssl_earliest_cert_expiry(Unix 时间戳,秒),配一条 expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 30 即可;Zabbix 用内置 web.certificate.get[example.com,443],触发器写 last() < 2592000(30 天)。建议 30 天预警、14 天告警、7 天升级到值班,与 Let’s Encrypt 官方建议的续期节奏一致。服务端异常时用 tail -f /var/log/nginx/error.log | grep -Ei 'SSL_do_handshake|certificate' 观察,出现 key values mismatch 就是 ssl_certificate 与 ssl_certificate_key 不配对——回到上面的模数比对即可定位。
私钥在生成 CSR 的服务器上,DigiCert 只签发公钥证书与中间链,不能从订单下载私钥;若私钥丢失只能重新生成 CSR 并重签,PFX 里的私钥是你在导出时打包进去的。
先看订单状态是否 Issued,再查域名 DCV 是否完成、账户角色是否有下载权限、证书是否被吊销或过期;经销商订单需到经销商 portal 下载。
Nginx 用 PEM:下载 Apache/NGINX 格式,得到叶证书与中间链,合并为 fullchain.pem,私钥单独放 ssl_certificate_key;PFX 更适合 IIS/Tomcat,Nginx 也能用但需 openssl pkcs12 拆出私钥。
DigiCert 在 CertCentral 手动/API 下载,常见 1 年有效期,OV/EV 需人工核验;Let's Encrypt 通过 ACME 自动签发 90 天证书,certbot renew 自动续期,适合大量域名但无 OV/EV 组织核验。
这是客户端找不到中间证书,服务端要发送完整链;把叶证书与 DigiCert 中间证书按顺序合并到 fullchain.pem,重启 Nginx 后用 openssl s_client -showcerts 确认返回 2-3 张证书。
用 keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12 -destkeystore example.jks -deststoretype JKS,按提示输入 PFX 密码并设置 JKS 密码;Tomcat 10.1 也可直接 keystoreType='PKCS12'。
已签发且未吊销的证书在有效期内可重复下载,续期会生成新订单和新证书;不要直接覆盖生产文件,先下载到测试目录,用 openssl x509 -noout -dates 核对后再切换。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。