修复 NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED:证书缺少 CT 日志记录的排查与解决
问题背景:Chrome 为什么因 CT 拒绝握手
在 Chrome、Edge 或 Safari 中打开站点,地址栏显示「您的连接不是私密连接」,错误码为 NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED,且「高级」里没有「继续前往」的入口——这不是普通的证书过期或域名不匹配,而是证书透明度(Certificate Transparency,CT,RFC 6962)校验失败。
CT 的核心机制是:CA 签发证书前,必须把「预证书」(precertificate)提交到一个或多个公开、可审计的 CT 日志,日志返回签名证书时间戳(SCT,Signed Certificate Timestamp)。浏览器验证服务器证书时,会检查证书是否附带足够数量的有效 SCT,并且这些 SCT 来自浏览器认可的日志。Chrome 自 68 版起对所有由公开信任根 CA 签发的 TLS 证书强制执行 CT 策略;Apple 平台从 iOS 11 / macOS 10.13 起也对有效期超过 398 天的证书执行类似策略(当前 CA/B Forum 规定证书最长有效期 398 天,因此这条规则实际影响所有公开证书)。
一旦证书没有合格 SCT,Chrome 直接终止连接,不会给用户绕过选项。典型触发场景有四类:
- 使用了未接入 CT 日志的小型 CA 或自建 CA 签发的证书,却被部署在公网域名上;
- 证书链不完整,浏览器拿不到完整的签发链,无法把 SCT 与证书关联;
- 企业防火墙、负载均衡或 SSL 解密设备在中间替换了证书,替换后的证书没有 SCT;
- 证书本身带 SCT,但服务器没有通过 TLS 扩展或 OCSP stapling 把 SCT 传给客户端(多见于老版本 Nginx/Apache 或自建 TLS 终止层)。
需要区分的是:如果站点使用完全私有的 CA 且客户端没有安装该根证书,Chrome 报的是 NET::ERR_CERT_AUTHORITY_INVALID;只有「证书被浏览器视为公开信任,但缺少 CT 证明」时,才会出现 NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED。因此排查第一步不是换证书,而是先确认证书的信任链和 SCT 状态。
根因定位:用三条命令确认 SCT 到底缺在哪
CT 失败可能发生在三个环节:证书内没有 SCT 扩展、服务器没有下发 SCT、客户端拿不到 OCSP 响应。先在生产环境实际使用的域名上抓取握手信息,不要只看本地证书文件。
命令一:检查线上握手是否携带 SCT 与 OCSP stapling。
echo | openssl s_client -connect example.com:443 -servername example.com -tlsextdebug -status 2>/dev/null | grep -iE 'signed certificate timestamp|OCSP Response Status|Verify return code'
期望看到 TLS server extension 'signed certificate timestamp' (id=18) 或 OCSP Response Status: successful (0x0),并且 Verify return code: 0 (ok)。如果三行都没有,说明服务器既没有下发 SCT 扩展,也没有启用 OCSP stapling。
命令二:检查证书文件里是否内嵌 SCT。
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text | grep -A3 -i 'CT Precertificate SCTs'
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text | grep -c 'Signed Certificate Timestamp'
第一条有输出说明证书内嵌了 SCT 列表;第二条输出 0 表示没有内嵌。注意:不同 OpenSSL 版本对 SCT 扩展的显示名称不同,1.1.1 以上通常显示为 CT Precertificate SCTs,部分版本显示 1.3.6.1.4.1.11129.2.4.2 这个 OID。
命令三:用 crt.sh 反查该域名的历史签发记录。
curl -s 'https://crt.sh/?q=%25.example.com&output=json' | jq -r '.[] | [.id, .not_before, .not_after, .issuer_name] | @tsv' | sort -k2 | tail -20
重点看两件事:一是最近一张证书的 issuer_name 是否为你认识的公共 CA;二是是否存在你不认识的签发记录(说明域名曾被误签或证书被滥用)。如果 crt.sh 里根本查不到当前这张证书,基本可以确定它没有进入 CT 日志。
把三条命令的结果对照后文的传递方式表,即可定位根因,再决定是重新签发还是补配置。
实操步骤一:用公共 CA 重新签发带 SCT 的证书
如果确认当前证书不是由接入 CT 的公共 CA 签发,或者 crt.sh 查不到记录,唯一可靠的做法是重新签发。下面以 Let’s Encrypt + Certbot 为例,命令可直接执行。
1. 安装并确认版本。建议 Certbot ≥ 2.0:
sudo apt update && sudo apt install -y certbot python3-certbot-nginx
certbot --version
2. 用 webroot 方式签发,避免改动现有 Nginx 配置。确保 http://example.com/.well-known/acme-challenge/ 可访问:
sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --cert-name example.com --key-type ecdsa --elliptic-curve secp256r1 --preferred-chain 'ISRG Root X1' --force-renewal
参数说明:--cert-name 固定证书目录,便于后续续期;--key-type ecdsa 生成 P-256 密钥,握手更快,TLS 1.2/1.3 均支持;--preferred-chain 指定根链,避免拿到交叉签名链导致部分老客户端校验异常;--force-renewal 用于替换已有证书。生产环境不要频繁使用该参数,正常续期交给 certbot renew --dry-run 验证即可。
3. 如果使用商业 CA(DigiCert、Sectigo、GlobalSign 等),用 CSR 提交。不要在服务器上自签后直接部署:
openssl req -new -newkey rsa:2048 -nodes -keyout /etc/ssl/private/example.com.key -out /etc/ssl/certs/example.com.csr -subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example Ltd/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
把 CSR 交给 CA,正规 CA 在签发流程中会自动把 precertificate 提交到多个 CT 日志,并在最终证书中写入 SCT 扩展。签发完成后务必下载完整证书链(服务器证书 + 中间 CA),不要只下载叶子证书。
4. 验证新证书确实带 SCT。
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text | grep -A2 'CT Precertificate SCTs'
如果这里仍为空,先不要急着上线:检查是否拿错了文件(cert.pem 是叶子证书,chain.pem 是中间链),以及 CA 是否真的接入了浏览器认可的日志。某些廉价 CA 只把证书提交到自建日志,浏览器不认,依然会报 CT 错误。
实操步骤二:让 Nginx/Apache 正确下发 SCT 与 OCSP 响应
证书带 SCT 只是第一步。浏览器获取 SCT 有三条路径:证书内嵌扩展、TLS 握手扩展(signed_certificate_timestamp,id=18)、OCSP stapling 响应。服务器配置不当时,即使证书本身合格,客户端仍可能拿不到 SCT。以下 Nginx 配置已在 1.20+ 验证可用。
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+ 写法;老版本用 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 1.1.1.1 valid=300s;
resolver_timeout 5s;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}
关键点:ssl_trusted_certificate 必须指向中间 CA 链,否则 Nginx 无法验证 OCSP 响应,日志会出现 ssl_stapling' ignored, issuer certificate not found;resolver 必须配置,Nginx 需要解析 OCSP 响应器域名;ssl_stapling_verify on 要求同时提供可信链。
Apache 2.4 对应配置:
SSLUseStapling on
SSLStaplingCache 'shmcb:/var/run/ocsp(128000)'
SSLStaplingResponderTimeout 5
SSLStaplingReturnResponderErrors off
如果站点前面还有 CDN、WAF 或四层负载均衡,TLS 通常终止在边缘节点,源站的 stapling 配置不生效。此时要在边缘节点开启 OCSP stapling,或直接使用云厂商托管的证书服务——它们默认会处理 CT 与 stapling。用 SSL 解密设备做中间人检查时,必须确保设备替换的证书同样带 SCT,否则内网用户访问公网站点也会报 CT 错误。
配置完成后执行 nginx -t && systemctl reload nginx,再回到第 2 节的命令复测握手。
SCT 传递方式与证书来源对比
理解三种 SCT 传递方式的差异,能快速判断「换证书」还是「改配置」。下表按实际运维场景整理:
| 传递方式 | 标准位置 | 谁负责 | 服务器要求 | 兼容性 | 检查方法 |
|---|---|---|---|---|---|
| X.509 扩展内嵌 | 证书 1.3.6.1.4.1.11129.2.4.2 |
CA 签发时写入 | 无 | 最好,TLS 1.2/1.3、老客户端均支持 | openssl x509 -text 查 SCT |
| TLS 扩展 | 握手扩展 id=18 | 服务器从证书读取后发送 | Nginx/Apache 自动处理,需证书带 SCT | 依赖客户端支持,现代浏览器均支持 | openssl s_client -tlsextdebug |
| OCSP Stapling | OCSP 响应扩展 | 服务器定期获取并缓存 | 需 ssl_stapling on + 可信链 + resolver |
依赖 OCSP 响应器可达,国内网络需注意 | openssl s_client -status |
再看证书来源。很多团队误以为「只要不是自签就行」,实际边界如下:
| 证书来源 | 是否强制 CT | 典型报错 | 建议 |
|---|---|---|---|
| 公共 CA(DigiCert、Sectigo、GlobalSign、Let’s Encrypt 等) | 是 | 正常不报错;链不完整时可能报 CT 错误 | 部署 fullchain,开启 stapling |
| 私有 CA / 自建 CA 用于公网 | 浏览器视为非公开信任 | NET::ERR_CERT_AUTHORITY_INVALID |
公网站点立即更换为公共 CA 证书 |
| 私有 CA 用于内网(客户端已装根) | 通常不触发 CT 检查 | 无(但外网用户无法访问) | 仅限内网,禁止暴露公网 |
| SSL 解密设备替换的证书 | 取决于替换证书 | NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED |
设备证书也需公共 CA 签发并带 SCT |
结论很明确:面向公网的服务,一律使用公共 CA 签发、带完整链、带 SCT 的证书;内网私有 CA 不要混用到公网入口。把这张表贴到变更评审里,能避免大部分 CT 类故障。
常见错误与真实报错排查
报错 1:Chrome 显示 NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED,但证书有效期和域名都正常。先跑第 2 节的 openssl s_client -tlsextdebug -status。如果既没有 SCT 扩展也没有 OCSP 响应,说明证书没带 SCT 或服务器没下发。检查是否用了自建 CA、是否被中间设备替换、fullchain.pem 是否只放了叶子证书。
报错 2:Nginx error.log 出现 ssl_stapling' ignored, issuer certificate not found for certificate '/etc/nginx/ssl/example.com.crt'。原因是缺少 ssl_trusted_certificate,或该文件里只有根证书没有中间 CA。修复:
grep -c 'BEGIN CERTIFICATE' /etc/letsencrypt/live/example.com/chain.pem
# 应输出 1 或更多;为 0 说明链文件为空
openssl crl2pkcs7 -nocrl -certfile chain.pem | openssl pkcs7 -print_certs -noout
报错 3:OCSP Response Status: tryLater (3) 或 ocsp verify failed。多为 DNS 解析失败、OCSP 响应器被网络策略拦截,或系统时间偏差超过允许窗口。先 dig ocsp.example-ca.com 确认解析,再 timedatectl status 检查 NTP。国内服务器访问境外 OCSP 响应器不稳定时,可改用支持 OCSP 代理的 CA,或依赖证书内嵌 SCT(不依赖 stapling)。
报错 4:verify error:num=20:unable to get local issuer certificate。链不完整。浏览器拿不到中间 CA,就无法把 SCT 与证书绑定,部分场景会直接报 CT 错误。用 openssl s_client -showcerts 数一下证书数量,正常应为 2~3 张。Nginx 必须用 fullchain.pem,不能用 cert.pem。
报错 5:只有部分用户报错,开发者本机正常。典型原因是本机装了私有根证书或走了代理。让用户打开 chrome://net-export/ 抓包,或访问 chrome://net-internals/#events 搜索 CERTIFICATE_TRANSPARENCY,对比 issuer 是否一致。企业 SSL 解密是最常见的原因。
效果验证:命令行、浏览器与 CT 日志三方确认
改完后不要只看浏览器是否放行,按下面四步验证。
第一步:握手层验证。
openssl s_client -connect example.com:443 -servername example.com -status -tlsextdebug </dev/null 2>/dev/null | grep -iE 'Verify return code|OCSP Response Status|signed certificate timestamp'
期望输出包含 Verify return code: 0 (ok)、OCSP Response Status: successful (0x0),以及 TLS server extension 'signed certificate timestamp'。三者至少满足「验证通过 + 一种 SCT 来源」。
第二步:证书层验证 SCT 数量。
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -text | grep -c 'Signed Certificate Timestamp'
Chrome 通常要求至少 2 个有效 SCT,输出 ≥2 最稳妥;输出 0 说明只能依赖 TLS 扩展或 OCSP stapling,需确认第 4 节配置已生效。
第三步:CT 日志收录验证。签发后几分钟到几小时,crt.sh 应能查到新证书:
curl -s 'https://crt.sh/?q=example.com&output=json' | jq -r '.[0] | "(.id) (.not_before) (.issuer_name)"'
如果长时间查不到,联系 CA 确认是否提交了 CT 日志。也可以直接访问 https://crt.sh/?q=example.com 人工核对。
第四步:浏览器与评分工具。Chrome DevTools → Security 面板应显示 Certificate - valid and trusted,展开证书可见 Certificate Transparency 条目;访问 https://www.ssllabs.com/ssltest/analyze.html?d=example.com,确认 Protocol Support、Key Exchange 正常,且没有 CT 相关告警。生产环境建议加一条巡检脚本,每天检查 SCT 与证书剩余天数:
#!/usr/bin/env bash
DOMAIN='example.com'
SCT=$(echo | openssl s_client -connect "$DOMAIN:443" -servername "$DOMAIN" 2>/dev/null | openssl x509 -noout -text | grep -c 'Signed Certificate Timestamp')
DAYS=$(echo | openssl s_client -connect "$DOMAIN:443" -servername "$DOMAIN" 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2 | xargs -I{} date -d {} +%s | awk -v now="$(date +%s)" '{print int(($1-now)/86400)}')
echo "SCT=$SCT days_left=$DAYS"
[ "$SCT" -ge 1 ] && [ "$DAYS" -gt 15 ] || echo 'ALERT: check certificate'
常见问题
不能。CT 校验失败时 Chrome 不提供绕过入口,这一点与证书过期不同。唯一办法是让服务器返回带合格 SCT 的证书:使用公共 CA 重新签发,或补全证书链并开启 OCSP stapling。临时可用其他浏览器访问,但不建议向用户推荐。
会。Let’s Encrypt 签发时把 precertificate 提交到多个浏览器认可的 CT 日志,SCT 通过证书扩展、TLS 扩展或 OCSP stapling 传递。只要用 certbot 正常签发并部署 fullchain.pem,通常不会触发 CT 错误;若仍报错,优先检查链是否完整、是否被中间设备替换。
严格说,私有 CA 未被客户端信任时报的是 NET::ERR_CERT_AUTHORITY_INVALID;只有当证书链被浏览器视为公开信任、但缺少 SCT 时才会报 CT 错误。把私有 CA 证书部署到公网是高风险做法,外网用户必然无法验证,应改用公共 CA 证书。
有。CA/B Forum 规定公开 TLS 证书最长有效期 398 天;Apple 对有效期超过 398 天的证书强制 CT,而 Chrome 对所有公开信任证书强制 CT。有效期缩短后,SCT 需要覆盖新证书,续期后要重新验证 SCT 是否随新证书下发。
先确认 ssl_trusted_certificate 指向中间 CA 链,resolver 可解析 OCSP 域名,且 openssl s_client -status 返回 successful。若证书本身没有内嵌 SCT,而客户端又不支持 OCSP 中的 SCT,最稳妥的做法仍是换用签发时内嵌 SCT 的公共 CA 证书。