证书透明度 CT 是什么?SCT、CT 日志与运维排错实战指南
证书透明度(CT)是 RFC 6962/9162 定义的公开只追加证书日志机制,浏览器用 SCT 证明证书已被公开记录;Chrome 对 2018-04-30 后签发的公开证书要求至少 2 个 SCT(有效期≤180 天)或 3 个(>180 天)。 公开站点优先选默认内嵌 SCT 的 CA,Let's Encrypt + certbot 2.11+ 会自动提交 CT,无需在 Nginx 加 CT 指令;用 openssl x509 -text | grep -A6 'CT Precertificate SCTs' 可检查。 SCT 缺失时 Chrome 报 ERR_CERTIFICATE_TRANSPARENCY_REQUIRED;先确认部署的是最终证书而非含 poison 扩展的 precert,再检查证书链与日志多样性。 CT 日志 API 的 get-sth 返回 tree_size 与签名,get-proof-by-hash 可做包含证明;生产环境应每日用 crt.sh 与日志 API 双源监控未知证书。
证书透明度 CT 是什么?为什么会出现证书误签发与浏览器拦截
证书透明度 CT 是什么?一句话回答:它是一套公开、只追加(append-only)的证书日志机制,由 RFC 6962(CT v1)和 RFC 9162(CT v2)定义。CA 在签发公开信任证书之前,先把 precertificate(带 poison 扩展的预证书)提交给多个 CT 日志;日志接受后返回 SCT(Signed Certificate Timestamp,签名证书时间戳)。SCT 是”某张证书在某时刻已被某日志收录”的可验证承诺,随后以三种方式之一随证书下发:嵌入 X.509 扩展、作为 TLS 扩展在握手时发送,或通过 OCSP stapling 附带。
为什么会出现误签发与浏览器拦截?传统 PKI 的可信基础主要是 CA 自律,加上 CRL 与 OCSP 这两种”吊销”机制——但吊销只在事后生效,且 OCSP 存在隐私与可用性问题(这也是 OCSP stapling 被广泛采用的原因)。当 CA 被入侵、配置错误或被迫签发时,站点所有者往往数月后才发现。CT 把签发行为变成可被任何人审计的公开记录,浏览器强制校验证书是否已入日志,从而把”影子证书”的生存窗口压缩到分钟级。据 Let’s Encrypt 文档,其所有公开信任证书在签发时都会提交到多个 CT 日志。
如何自查一张线上证书的 SCT?OpenSSL 1.1.1 及以上版本可直接解析该扩展(1.0.2 不显示):
# 适用 OpenSSL 1.1.1 / 3.x;1.0.2 不解析 CT 扩展,会无输出
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -text
| sed -n '/CT Precertificate SCTs/,/^$/p'
# 只统计 SCT 条数,对照 Chrome 的 2/3 条要求
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -text | grep -c "Signed Certificate Timestamp:"
# 输出示例:2
三种”证书状态”机制的定位差异,决定了 CT 不可被替代:
| 机制 | 发布者 | 回答的问题 | 能否发现误签发 | 浏览器强制 |
|---|---|---|---|---|
| CRL(RFC 5280) | CA | 证书是否已被吊销 | 否(被动、滞后) | 部分场景 |
| OCSP / OCSP stapling(RFC 6960) | CA / 站点 | 证书当前是否有效 | 否 | 逐渐弱化 |
| CT(RFC 6962 / 9162) | 独立日志运营方 | 证书是否被公开记录 | 是(可主动监控) | Chrome 强制 |
浏览器到底要求几条 SCT?Chrome 自 2018-04-30 起对公开信任证书执行 CT 策略,按证书有效期分档:
| 证书有效期 | 合格 SCT 数 | 附加条件 |
|---|---|---|
| ≤ 180 天 | ≥ 2 | 需来自 Chrome 认可的合格日志,并满足运营方多样性要求 |
| > 180 天 | ≥ 3 | 同上,具体以 Chrome CT 政策页面为准 |
不满足时,Chrome 会直接拦截并报 ERR_CERTIFICATE_TRANSPARENCY_REQUIRED(net 层同名错误码),页面无法通过”继续访问”绕过。这正是许多运维同学遇到的现象:证书链校验通过、域名匹配、有效期正常,浏览器仍然拒绝加载。
哪些证书不受约束?内网私有 CA 与自签名证书不在 Chrome 公开 CT 策略范围内;但企业完全可以自建 CT 日志(如 Google 的 Trillian)做内部审计与资产发现。反之,Let’s Encrypt、DigiCert、Sectigo 等公开 CA 签发的证书都涉及 CT。
三个高频误区:① 地址栏有锁标不等于 CT 合规,锁标只反映 TLS 与证书链状态;② CT 不做加密,也不替代 OCSP/CRL,三者职责正交;③ SCT 数量够但签名无效、或日志后来被撤销资格,Chrome 同样可能拦截——排查时要同时看 SCT 条数、Log ID 是否为合格日志、以及时间戳是否落在证书有效期内。
CT 的核心机制:SCT、Merkle 树与日志生命周期
CT(Certificate Transparency,证书透明度)不是一个新的加密算法,而是一套”公开可审计的证书账本”机制。理解证书透明度 CT 是什么,关键要抓住三条链路:CA 怎么把证书提交进日志、浏览器怎么验证日志确实接收了它、日志本身怎么被持续监督。这三条链路分别由 precertificate、SCT 和 Merkle 树承载,缺一不可。
Precertificate 与 poison 扩展:为什么最终证书里看不到提交过程?
CA 在签发正式证书前,先生成一张 precertificate:它与最终证书的 TBSCertificate 几乎一致,但额外带一个临界扩展 CT Poison(OID 1.3.6.1.4.1.11129.2.4.3,值为 NULL)。这个扩展的作用是让任何正常 TLS 客户端拒绝该证书——它是”半成品”标记,防止预签发的中间产物被误用。CA 随后把 precert 链提交给日志的 add-pre-chain 接口,日志返回一个 SCT(Signed Certificate Timestamp)承诺。CA 最终签发的正式证书会去掉 poison 扩展,并把 SCT 列表嵌入 SCT List 扩展(OID 1.3.6.1.4.1.11129.2.4.2)。据 RFC 6962 §3.1,正是”去掉 poison 前后 TBSCertificate 的哈希”构成了 SCT 签名所覆盖的内容,因此 SCT 对最终证书同样有效。
可以直接用 OpenSSL 查看这两个扩展:
# 查看证书中是否内嵌 SCT(正常应为非空,且通常是若干条 SCT)
openssl x509 -in fullchain.pem -noout -text | grep -A3 "1.3.6.1.4.1.11129.2.4.2"
# 若看到 CT Precertificate Poison,说明拿到的是 precert,绝不能部署到线上
openssl x509 -in cert.pem -noout -text | grep -A1 "CT Precertificate Poison"
# 输出示例(不该出现在生产证书中):
# X509v3 CT Precertificate Poison: critical
# NULL
# 更精确地解析 SCT 二进制(OpenSSL 3.x 支持 -tls1_2 输出更完整)
openssl asn1parse -in fullchain.pem -inform PEM | grep -i "11129"
SCT 里到底有什么?浏览器凭什么相信它?
一个 v1 SCT 的结构(RFC 6962 §3.2)包含:version(v1 为 0)、log_id(32 字节,即日志公钥经 SHA-256 的哈希)、timestamp(毫秒级 Unix 时间)、extensions(长度前缀,通常为空)、以及 DigitallySigned 签名。浏览器拿到内嵌 SCT 后,会用日志公钥验证签名,并核对三件事:签名覆盖的证书哈希是否与当前证书匹配、时间戳是否在合理窗口内、log_id 是否属于当前合格的日志列表。只要通过,就说明”该证书在某个时刻已被某合格日志接收”,从而无法事后悄悄补签一张不被察觉的证书。
Merkle 树:单条 SCT 如何升级为”全网可验证”?
日志按 RFC 6962 把所有条目哈希成叶子节点,两两向上哈希构建 Merkle Tree,最终得到一个根哈希。客户端调用 get-sth 可获得:
tree_size:当前日志条目总数;timestamp:该树头生成时间;sha256_root_hash:Merkle 根;tree_head_signature:日志对上述字段的签名。
任何人只要保存了历史 STH,就能检测”日志是否改写了历史”;而 get-proof-by-hash 返回一条审计路径(audit path),第三方无需下载整棵树即可验证某证书确实被包含。这正是 CT 能抵抗”分裂视图”的数学基础。据 Chrome 的 CT 政策,日志若出现分裂视图、合并延迟过长或私钥泄露,会被移出合格日志列表;CA 因此必须选择仍在有效期内的日志提交,否则 SCT 将不被接受。
SCT 的三种交付方式怎么选?
| 交付方式 | 载体 | 典型场景 | 运维成本 |
|---|---|---|---|
| 证书内嵌 SCT | X.509 扩展 1.3.6.1.4.1.11129.2.4.2 | 绝大多数公有证书,Let’s Encrypt、DigiCert 默认内嵌 | 最低,无需配置 |
| TLS 扩展 | signed_certificate_timestamp(ExtensionType 18) |
证书本身未内嵌时由服务器补发 | 需 Web 服务器支持,Nginx/OpenSSL 支持有限 |
| OCSP 装订 | OCSP 响应中的 SCT 扩展 | 部分 CDN 与旧客户端兼容路径 | 需稳定维护 OCSP Stapling |
据 Let’s Encrypt 文档,其签发的证书默认将 SCT 内嵌进证书,因此使用 ACME 自动化的运维人员通常不需要手工向日志提交;只有在自建 CA 或使用不支持内嵌的签发流程时,才需要主动调用日志 API。排查时可先用上面的 openssl x509 -text 确认扩展存在,再结合 openssl s_client -connect example.com:443 -status 检查 OCSP 与 SCT 的实际下发情况。
完整实操步骤:从申请证书到确认 CT 收录(分步编号)
搞清楚证书透明度 CT 是什么只是第一步——CT 的价值在于”可被审计”,前提是证书真的把 SCT 嵌进去了、并且能在线验证。下面 6 步把”选型 → 申请 → 验 SCT → 部署 → 补救 → 监控”整条链路跑通,命令可直接复制执行。
步骤 1:选 CA 与证书类型——先确认 SCT 从哪来。SCT(Signed Certificate Timestamp)有两条来源:CA 签发时直接内嵌进证书(RFC 6962 §3.3 的扩展 OID 1.3.6.1.4.1.11129.2.4.2),或由 TLS 服务器通过 signed_certificate_timestamp 扩展在握手时下发。前者是运维唯一省心的路径。
| 场景 | 推荐 CA / 工具 | SCT 来源 | 典型 SCT 数 | 注意点 |
|---|---|---|---|---|
| 公网站点(免费) | Let’s Encrypt + certbot ≥ 2.11 | 证书内嵌 | 2 | 默认提交多个合格日志,无需额外配置 |
| 公网站点(泛域名) | acme.sh ≥ 3.0 + ZeroSSL / Let’s Encrypt | 证书内嵌 | 2 | ZeroSSL 需 EAB 凭据;泛域名走 DNS-01 |
| 公网站点(商业) | DigiCert / Sectigo / GlobalSign | 证书内嵌 | 2–3 | 下单前书面确认”CT logging 默认开启” |
| 内网 / 私有 PKI | step-ca、EJBCA 自建 | 通常无 | 0 | 浏览器不强制,但合规场景需自建 CT 日志(Trillian + ctfe) |
据 Let’s Encrypt 官方文档,其签发的所有证书都会提交到 CT 日志并内嵌 SCT;据 Google 的 Chrome Certificate Transparency Policy,有效期 ≤ 180 天的证书至少需要 2 个合格日志的 SCT,> 180 天需要 3 个——这就是你看到”2 个 SCT”的原因。
步骤 2:申请证书。Let’s Encrypt 证书有效期为 90 天(官方已公布逐步缩短路线图),certbot 会自动完成 precert 提交:
# certbot ≥ 2.11(Python 3.9+);--webroot 无默认值,必须显式给 -w
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--agree-tos -m ops@example.com
# 产物目录:/etc/letsencrypt/live/example.com/
# cert.pem(叶子证书)、chain.pem(中间证书)、fullchain.pem、privkey.pem
# acme.sh ≥ 3.x 等价写法,默认同样提交 CT
acme.sh --issue -d example.com -d www.example.com -w /var/www/html
步骤 3:检查 SCT 是否内嵌。OpenSSL 1.1.1 起 x509 -text 会解析该扩展(OpenSSL 3.x 输出格式相同):
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text
| grep -A6 'CT Precertificate SCTs'
# 只看数量(每个 SCT 一条 Signed Certificate Timestamp)
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text
| grep -c 'Signed Certificate Timestamp'
CT Precertificate SCTs:
Signed Certificate Timestamp:
Version : v1 (0x0)
Log ID : 48:B0:E3:6B:DA:A6:47:34:...
Timestamp : Apr 1 09:12:33.000 2025 GMT
Extensions: none
Signature : ecdsa-with-SHA256
计数 ≥ 2 即合规;为 0 说明该 CA 未默认提交,进入步骤 5。
步骤 4:部署证书链。ssl_certificate 在 Nginx 中没有默认值、必须显式配置,且必须指向含中间证书的 fullchain.pem——只配 cert.pem 会让部分客户端(尤其 Android 旧版本)链验证失败:
# /etc/nginx/conf.d/example.conf(Nginx ≥ 1.15.9 建议写法)
server {
listen 443 ssl;
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_protocols TLSv1.2 TLSv1.3; # 需 OpenSSL 1.1.1+ 才支持 TLSv1.3
}
# 校验并热加载
nginx -t && systemctl reload nginx
# 线上复核:链证书数应 ≥ 2,且叶子证书带 SCT
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
| grep -c 'BEGIN CERTIFICATE'
步骤 5:SCT 缺失怎么补救。不要手工把最终证书提交到日志的 add-pre-chain 接口——RFC 6962 §3.1 规定该接口只接受带 CT Poison 扩展(OID 1.3.6.1.4.1.11129.2.4.3)的 precertificate,最终证书没有该扩展:
curl -s -X POST https://oak.ct.letsencrypt.org/2025h1/ct/v1/add-pre-chain
-H 'Content-Type: application/json'
-d "{"chain":["$(openssl x509 -in cert.pem -outform DER | base64 -w0)"]}"
# 返回:{"error_message":"Certificate is not a precertificate","success":false}
运维上更现实的两条路:一是换到默认提交 CT 的 CA 后 certbot renew --force-renewal 重签;二是自建日志时用 certificate-transparency-go 的客户端提交真正的 precert。可用 openssl x509 -noout -text | grep -c 'CT Precertificate Poison' 判断手头文件是不是 precert。
步骤 6:建立 CT 监控。CT 日志是公开的,别人给你域名签的证书你也能看到——这正是 CT 对误签发与域名抢注的防护价值:
# 每天落盘一份 JSON,保留 ≥ 90 天用于回溯(crt.sh 有速率限制,生产建议换 Cert Spotter API)
mkdir -p /var/log/ct
curl -s "https://crt.sh/?q=%25.example.com&output=json"
-o /var/log/ct/$(date +%F).json
# 提取 issuer 与域名,与 CA 白名单比对,出现未知 issuer 立即告警(目标 15 分钟内)
jq -r '.[] | "(.not_before) (.issuer_name) (.name_value)"' /var/log/ct/$(date +%F).json
| sort -u | grep -v -E 'Let.s Encrypt|ZeroSSL'
把这条脚本挂进 cron 或 systemd timer,告警阈值设为”任意非白名单 issuer”——比等到浏览器报错再排查要早得多。
配置与命令示例:Nginx 1.25、OpenSSL 3.0 与 certbot 2.x 的具体参数
先说结论:Nginx 1.25 没有任何与 CT 相关的指令,因为 SCT 是随证书一起下发的 X.509 v3 扩展(OID 1.3.6.1.4.1.11129.2.4.2),据 RFC 6962 §3.3 的定义,它由 CA 在签发时写入,运维侧只要保证 ssl_certificate 指向含叶证书的完整链文件即可。以下配置在 Nginx 1.25.x 上可直接使用,ssl_stapling 默认 off、ssl_stapling_verify 默认 off,必须显式开启并配置 resolver,否则会报 nginx: [emerg] no resolver defined to resolve ... 或在 reload 后静默不回填 OCSP。
server {
listen 443 ssl;
server_name example.com;
# fullchain.pem = 叶证书 + 中间证书;叶证书里已内嵌 SCT,无需额外 CT 指令
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # Mozilla 中间配置建议值
ssl_stapling on; # 默认 off
ssl_stapling_verify on; # 默认 off,校验 OCSP 响应签名
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
resolver 1.1.1.1 8.8.8.8 valid=300s; # 不配 resolver 时 stapling 不工作
resolver_timeout 5s;
}
验证 SCT 是否真的在证书里,用 OpenSSL 3.0.13 实测(输出含 Log ID、Timestamp、Extensions、Signature Algorithm 与签名值):
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text
| sed -n '/CT Precertificate SCTs/,+12p'
# 期望看到 2 条以上 SCT(Chrome 要求同一日志列表内至少 2 个独立日志)
想确认服务器在 TLS 握手中是否通过扩展下发 SCT(signed_certificate_timestamp,RFC 6962 §3.3),加 -tlsextdebug 观察:
openssl s_client -connect example.com:443 -servername example.com -status -tlsextdebug &1
| grep -i -E 'signed certificate timestamp|OCSP Response Status'
| SCT 交付方式 | 验证命令 | 客户端可见性 | 运维要点 |
|---|---|---|---|
| 证书内嵌扩展(OID …11129.2.4.2) | openssl x509 -text |
全部 TLS 客户端 | Let’s Encrypt 默认写入,无需配置 |
| TLS 扩展 signed_certificate_timestamp | s_client -tlsextdebug |
仅解析该扩展的客户端 | Nginx 无指令控制,通常不出现 |
| OCSP Stapling 携带 SCT | s_client -status |
支持 status_request 的客户端 | 依赖 ssl_stapling on 与可达 resolver |
直接查 CT 日志本身,据 Let’s Encrypt 文档,oak.ct.letsencrypt.org/2024h1 提供 RFC 6962 标准 API,get-entries 单次分页上限以各日志文档为准(常见 32 或 1000 条,超限返回 HTTP 400):
curl -s https://oak.ct.letsencrypt.org/2024h1/ct/v1/get-sth
| jq '{tree_size,timestamp,sha256_root_hash}'
curl -s 'https://oak.ct.letsencrypt.org/2024h1/ct/v1/get-entries?start=0&end=31'
| jq '.entries | length'
certbot 2.x 侧有两个常见误解:--must-staple 只往证书里加 OCSP Must-Staple 扩展(TLS Feature 1.3.6.1.5.5.7.1.24),不生成也不控制 SCT;--preferred-challenges 只影响 ACME 域名验证走 http-01 还是 dns-01,CT 提交由 CA 在签发时完成,客户端无法干预。
# 演练续期并热加载,避免 dry-run 触发真实限流
certbot renew --dry-run --deploy-hook 'systemctl reload nginx'
把 crt.sh 作为被动监控源,定期比对新出现的证书(crt.sh 数据来自公开 CT 日志,存在分钟级延迟):
#!/usr/bin/env bash
# /usr/local/bin/ct-watch.sh
curl -s 'https://crt.sh/?q=%25.example.com&output=json'
| jq -r '.[] | [.issuer_name,.not_before,.serial_number] | @tsv' | sort -u
# crontab: 17 3 * * * /usr/local/bin/ct-watch.sh (输出接入告警系统比对新增行)
方案选型对比:内置 SCT、TLS 扩展、OCSP 装订与仅监控
想让浏览器不报 CT 错误,SCT 到底该走哪条路?先给判断口诀:能重签证书,就选 CA 内置 SCT;不能重签,才考虑握手时动态下发;OCSP 装订只是“顺带可能带 SCT”的旁路;crt.sh 那类仅监控方案解决的是资产发现问题,跟浏览器拦截无关。先看四种路径的硬指标对比:
| 方案 | 兼容性 | 运维成本 | 适用场景 | 关键参数/限制 |
|---|---|---|---|---|
| CA 内置 SCT | Chromium、Safari 等主流支持 | 低,CA 自动完成 | 绝大多数公网站点 | 证书扩展 OID 1.3.6.1.4.1.11129.2.4.2;按 Chrome CT 政策常规证书需至少 2 个 SCT,EV 更严 |
| TLS 扩展 SCT | 依赖客户端与服务器同时支持 | 中,需动态提供 | 无法重签的老系统 | ExtensionType 18(signed_certificate_timestamp),RFC 6962 §3.3;Nginx 开源版不原生生成 |
| OCSP 装订 SCT | 依赖 OCSP 与客户端 | 中高,需稳定 OCSP | 特定合规环境 | 需 ssl_stapling on;OCSP 超时会让装订失败 |
| 仅 CT 监控 | 不解决浏览器拦截 | 低 | 资产发现与应急响应 | crt.sh / 日志 API;只能“发现”未知证书,不能替代重签 |
1)首选内置 SCT——部署时你唯一要改的是证书链文件。据 Let’s Encrypt 文档,其签发的证书默认预嵌 SCT,你只要保证 Nginx 的 ssl_certificate 指向包含完整链的 fullchain.pem(而不是只含叶证书的 cert.pem),无需任何额外指令。上线后用 OpenSSL 1.1.1 及以上版本验证:
# 统计证书中嵌入的 SCT 数量,返回值 ≥2 表示浏览器 CT 合规基本无虞
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -text
| grep -c "Signed Certificate Timestamp"
2)TLS 扩展 SCT——退路,不是首选。RFC 6962 §3.3 定义了扩展类型 18,由服务器在 ServerHello 中携带。现实约束是:Nginx 开源版没有对应指令(Tengine 等分支才有),OpenSSL 的 CT 相关 API 主要面向验证侧(如 SSL_CTX_set_ct_validation_callback),并不负责在服务端生成 SCT。因此这条路通常意味着应用层自行实现,或依赖支持该扩展的 CDN。验证时抓一次握手即可:
# 抓取 ServerHello,确认是否携带 signed_certificate_timestamp 扩展
tshark -i eth0 -f "tcp port 443"
-Y "tls.handshake.type == 2 && tls.handshake.extensions.signed_certificate_timestamp" -c 1
3)OCSP 装订——别把它当 CT 唯一方案。ssl_stapling on 装订的是 OCSP 响应,与 SCT 是两条独立链路。Nginx 中 ssl_stapling 与 ssl_stapling_verify 默认均为 off,resolver_timeout 默认 30s:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 必须含签发者证书,否则验签失败
resolver 1.1.1.1 8.8.8.8 valid=300s;
resolver_timeout 10s; # 默认 30s;调到 5s 时上游稍慢就会装订失败
典型报错是 ssl_stapling_responder failed ... while requesting certificate status, responder: r3.o.lencr.org,需对该关键字做日志告警。另据 Let’s Encrypt 官方公告,其 OCSP 服务已于 2025 年 8 月停止、转为 CRL,因此 LE 证书再做 OCSP 装订已无意义——这本身就是“不要把装订当 CT 方案”的最好注脚。
4)仅 CT 监控——回答的是“证书透明度 CT 是什么”的另一半:可审计性。用 crt.sh 做资产发现,适合不能改证书的内部系统,能揪出私签或影子证书,但它不会让浏览器放行:
# 查询所有 SAN 含 .example.com 的证书(% 为通配),--max-time 防止大查询超时
curl -s --max-time 60 "https://crt.sh/?q=%25.example.com&output=json"
| jq -r '.[].name_value' | sort -u
把这条命令放进每日定时任务,与自家证书清单做 diff,新增条目即触发人工复核——这才是“证书透明度 CT 是什么”在运维侧最实用的落地形式。
常见错误与排查:从 SCT missing 到 CT 日志 429
排查 CT 相关报错时,先建立一个判断:绝大多数 CT 报错的原因在于 SCT(Signed Certificate Timestamp)没有正确送达客户端,而不在 TLS 握手本身。据 RFC 6962,SCT 有三条送达路径:嵌入证书、通过 TLS 扩展(status_request 对应的 OCSP 方式)传递,或通过 OCSP 响应携带。Chrome 的 CT 政策要求由受信任日志签发的证书必须满足其中一种,否则直接拦截。先用下表定位:
| 报错信息 | 根因 | 一条命令定位 |
|---|---|---|
| ERR_CERTIFICATE_TRANSPARENCY_REQUIRED | 证书无 SCT,且 TLS/OCSP 也未提供 | openssl x509 -in cert.pem -noout -text | grep -A6 'CT Precertificate SCTs' |
| Certificate is not a precertificate | 向 add-pre-chain 提交了最终证书 |
openssl x509 -in cert.pem -noout -text | grep -c '1.3.6.1.4.1.11129.2.4.3' |
| x509: unhandled critical extension | precert 被部署到线上 | 同上,结果非 0 即含 CT Poison |
| SCT signature verification failed | SCT 的 log_id 与校验用公钥不匹配 | openssl pkey -pubin -in log_pubkey.pem -outform der | openssl dgst -sha256 |
| ssl_stapling_responder failed | 链文件不完整或 resolver 不可达 | openssl ocsp -issuer chain.pem -cert cert.pem -url "$(openssl x509 -in cert.pem -noout -ocsp_uri)" -resp_text |
Chrome 报 ERR_CERTIFICATE_TRANSPARENCY_REQUIRED 怎么办? 先确认证书里到底有没有 SCT:
# 无任何输出 = 证书未嵌入 SCT,Chrome 会直接拦截
openssl x509 -in cert.pem -noout -text | grep -A6 'CT Precertificate SCTs'
# 若想批量检查线上站点(OpenSSL 1.1.1+)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -text | grep -c 'CT Precertificate SCTs'
如果结果为 0,有两条路可走:向 CA 申请带 SCT 的证书并重新签发(Let’s Encrypt 自 2018 年起默认通过其 CT 日志嵌入 SCT);或者在服务器侧开启 OCSP stapling,让 OCSP 响应携带 SCT。
为什么 add-pre-chain 报 Certificate is not a precertificate? 因为 RFC 6962 定义了两个不同接口:add-chain 接收最终证书链,add-pre-chain 只接收带 CT Poison 扩展(OID 1.3.6.1.4.1.11129.2.4.3,critical)的 precert。据 OpenSSL 文档,该扩展一旦存在,客户端必须拒绝该证书,所以它绝不能出现在生产链里。部署前务必执行:
# 返回 0 才说明是最终证书,可以上线
openssl x509 -in fullchain.pem -noout -text | grep -c '1.3.6.1.4.1.11129.2.4.3'
CT 日志返回 429 Too Many Requests 怎么退避? 先读响应头 Retry-After(单位为秒),再按指数退避重试,并把并发控制在 2–4 个连接以内:
# 指数退避:1s → 2s → 4s → 8s → 16s → 32s,上限 60s
for i in 1 2 3 4 5 6; do
code=$(curl -s -o /dev/null -w '%{http_code}' -X POST
-H 'Content-Type: application/json' --data @add-chain.json
https://ct.example-log.org/ct/v1/add-chain)
[ "$code" = "200" ] && break
wait=$(( 2 ** (i-1) > 60 ? 60 : 2 ** (i-1) ))
sleep "$wait"
done
SCT signature verification failed 说明什么? 按 RFC 6962 §3.2,log_id 就是日志公钥的 SHA-256 摘要。用上面的 openssl pkey ... | openssl dgst -sha256 算出摘要,与 SCT 中的 log_id 逐字节比对;同时确认 SCT 时间戳落在该日志的可用期内(Chrome 日志列表会标注 retired 状态),以及提交时的证书哈希与当前证书一致——中间证书换过一次,哈希就变了。
OCSP stapling 失败导致 SCT 也没送到? 这往往是链文件问题。Nginx 需要完整的信任链(含根与中间证书),并放行 UDP 53 出站:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/chain.pem; # 必须含根证书,否则 verify failure
resolver 1.1.1.1 8.8.8.8 valid=300s; # 默认 30s,过短会频繁回源
resolver_timeout 5s;
提示:
ssl_trusted_certificate与ssl_certificate是两回事,前者只用于 stapling 校验,不发给客户端。这是证书透明度 CT 部署中最容易被忽略的一处配置。
效果验证方法:如何确认 SCT 与 CT 日志收录真正生效
很多人部署完证书就默认”CT 已经生效了”,但证书透明度(CT)的生效其实分三层:证书里有没有内嵌 SCT、握手时服务器会不会下发 SCT、公开日志里到底有没有收录。下面按这三层逐一验证。顺带说一句,想先搞清楚”证书透明度 CT 是什么”,可以把它理解为一份只追加、可公开审计的证书签发流水账,而 SCT 就是日志给这张证书盖的收讫章。
第一层:证书文件里到底有没有 SCT?先做本地静态检查,这一步不依赖网络:
# 1) 统计内嵌 SCT 条数;DV/OV 证书正常应 ≥2(Chrome CT 政策要求)
openssl x509 -in fullchain.pem -noout -text
| grep -c 'Signed Certificate Timestamp'
# 2) 确认部署的是服务端证书而非客户端证书
openssl x509 -in fullchain.pem -noout -text
| grep -A1 'X509v3 Extended Key Usage'
# 期望输出包含:TLS Web Server Authentication
# 若只有 TLS Web Client Authentication,用该证书做服务端会校验失败,
# OpenSSL 报 verify error:num=26:unsupported certificate purpose
# 3) 看 SCT 对应的日志 ID(log_id)与签名算法,便于后续核对日志
openssl x509 -in fullchain.pem -noout -text
| grep -A3 'Signed Certificate Timestamp' | head -20
第 1 步返回 0 说明证书根本没带 SCT,多半是 CA 提交日志失败,或你用的是自签、内网 CA 签发的证书(据 Let’s Encrypt 文档,其签发的证书默认会提交到多个公开日志,不会出现 0 条)。
第二层:握手时服务器有没有把 SCT 传下来?
# -servername 走 SNI,-tlsextdebug 打印 TLS 扩展,-status 同时取 OCSP
openssl s_client -connect example.com:443 -servername example.com
-status -tlsextdebug &1
| grep -i 'signed certificate timestamp'
有输出说明 TLS 扩展形式的 SCT 可用。这里有一个常见误解:TLS 1.3 下这条命令往往看不到 SCT,因为 RFC 8446 把 SCT 放进了 Certificate 条目的扩展里(OID 1.3.6.1.4.1.11129.2.4.2),而 -tlsextdebug 只解析 ServerHello 层。此时改用下面这条,直接检查服务器实际下发的证书内嵌 SCT:
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -text | grep -c 'Signed Certificate Timestamp'
| 验证维度 | 入口 | 能证明什么 | 盲区 | 典型失败表现 |
|---|---|---|---|---|
| 证书文件 | openssl x509 -text |
内嵌 SCT 条数、EKU 是否正确 | 日志是否真的收录 | grep 计数为 0 |
| TLS 握手 | s_client -tlsextdebug |
服务器是否下发 SCT 扩展 | TLS 1.3 下不显示 | 无任何输出 |
| 浏览器 | DevTools → Security → 查看证书 | 客户端实际接受的 SCT | 无法批量、无法审计 | NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED(EV 证书缺 SCT) |
| 公开日志 | crt.sh / get-sth | 是否被收录、日志是否健康 | 不反映浏览器策略 | 签发后数小时仍查不到记录 |
第三层:日志真的收录了吗?先查聚合搜索,再直连日志 API 核对一致性:
# 列出该域名最近的证书记录(id / 生效时间 / 签发者)
curl -s 'https://crt.sh/?q=example.com&output=json'
| jq -r '.[] | [.id,.not_before,.issuer_name] | @tsv' | sort -k2 | tail -5
# 直连日志的 get-sth,取签名树头(STH)
curl -s https://oak.ct.letsencrypt.org/2025h2/ct/v1/get-sth | jq '.tree_size, .timestamp'
sleep 60
curl -s https://oak.ct.letsencrypt.org/2025h2/ct/v1/get-sth | jq '.tree_size'
# tree_size 必须单调递增;若两次相同属正常(该秒内无新证书),
# 若长期不增长或返回 403/404,说明该日志已只读或被取消资格,需换日志核对
注意日志 URL 要对应证书 SCT 里的 log_id,别拿 2024h1 这类已进入只读状态的日志验证新证书。要严格证明”我的证书在这棵树里”,需用 get-proof-by-hash 提交叶哈希(base64(SHA256(0x00 || MerkleTreeLeaf)))拿包含证明;生产上更省事的做法是用 ct-woodpecker、certspotter 这类工具自动做包含性校验,并把每次 STH 的签名落盘存档,供事后审计(RFC 9162 定义的 CT v2 与 RFC 6962 的 v1 接口路径相同,参数略有差异)。
怎么把它变成持续监控而不是一次性检查?
- 未知证书告警:每天拉一次 crt.sh 的 JSON,与资产清单比对,出现 24 小时内未登记的证书立即告警;同时用
s_client抓线上实际证书做双源交叉,避免 crt.sh 索引延迟造成误判。 - SCT 数量与有效期联动:按 Chrome CT 政策,有效期 ≤180 天需 2 个 SCT、>180 天需 3 个,且日志运营方要分散。每季度抽查 10% 证书,若发现有效期超过 180 天但 SCT 少于 3 个,直接重签而不是等浏览器报错。
- 日志健康度:把关键日志的
tree_size与timestamp纳入拨测,STH 时间戳超过 24 小时未更新即视为异常。
CT 不参与加密,它解决的是公开审计问题:证书是否被公开日志记录、是否可被第三方发现。HTTPS 加密仍由 TLS 握手完成,CT 只是浏览器校验证书合规性的附加条件。
Chromium 系浏览器可能直接拦截并报 ERR_CERTIFICATE_TRANSPARENCY_REQUIRED;其他客户端不一定强制。最稳妥的做法是重签带内嵌 SCT 的证书,或通过 TLS 扩展/OCSP 装订提供有效 SCT。
不需要。Let's Encrypt 在签发流程中自动向合格 CT 日志提交 precert,并把 SCT 嵌入证书;用 certbot 2.11+ 或 acme.sh 3.x 正常签发即可,无需额外 CT 参数。
不需要。Chrome 的公开 CT 策略针对公开信任证书,内网私有 CA 与自签名证书不受该策略约束;如果企业需要审计内部证书,可自建 CT 日志,但要评估域名泄露与运维成本。
CT 记录证书是否被公开日志收录,OCSP Stapling 提供证书吊销状态;两者可同时使用。Nginx 的 ssl_stapling on 只影响 OCSP,不会生成 SCT,不能拿它替代 CT 合规。
先检查证书是否含有效 SCT,再确认部署的是最终证书而非含 poison 扩展的 precert,最后检查证书链与日志多样性。若使用商业 CA,可提交证书序列号让 CA 核查 CT 提交记录。
会。公开 CT 日志中的证书条目包含域名、颁发者、序列号与时间等信息,任何人可通过 crt.sh 或日志 API 查询;敏感内部域名不建议使用公开 CA,可考虑私有 CA 或通配符证书降低暴露面。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。