x509证书结构详解:TBSCertificate 字段、扩展与 OpenSSL 3.x 解析命令
1. x509 证书结构是一个 ASN.1 DER 编码的 SEQUENCE,外层由 tbsCertificate、signatureAlgorithm、signatureValue 三部分组成,TBSCertificate 再按 version、serialNumber、signature、issuer、validity、subject、subjectPublicKeyInfo、extensions 顺序排列。 2. 用 `openssl x509 -in cert.pem -noout -text -nameopt RFC2253`(OpenSSL 3.0.13)可一次看到 v3 字段与扩展;只看 SAN 用 `-ext subjectAltName`。 3. 证书链报 `error 20 at 0 depth lookup` 时,优先检查服务器是否发送中间证书:Nginx 的 `ssl_certificate` 应指向终端+中间的 fullchain.pem,顺序不能反。 4. 主机名校验以 SAN 为准,CN 在 Chrome 58+ 已被忽略;通配符 `*.example.com` 只覆盖一级子域,不匹配 `a.b.example.com`。 5. 30 天到期巡检用 `openssl x509 -checkend 2592000 -noout -in cert.pem`,返回 0 表示未进入 30 天窗口;结合 `s_client -status` 检查 OCSP stapling。
为什么线上 TLS 报错总绕不开 x509 证书结构?
因为几乎所有线上 TLS 失败的“最后一公里”,都是客户端在逐项比对 X.509 证书结构时发现某一项不合规而主动中止。先看三个高频报错分别卡在哪一步:
| 客户端报错原文 | 触发的校验项 | 最常见根因 |
|---|---|---|
NET::ERR_CERT_AUTHORITY_INVALID(Chrome) |
链构建 / issuer–subject 匹配(RFC 5280 §6.1) | 服务端只下发了 leaf,未拼中间证书 |
x509: certificate signed by unknown authority(Go crypto/x509) |
Verify() 的 Roots 池 |
镜像内无 CA 包,或未设置 RootCAs |
error 20 at 0 depth lookup: unable to get local issuer certificate(OpenSSL) |
找不到签发者 | -CAfile 指错,或 fullchain 顺序颠倒 |
x509: certificate relies on legacy Common Name field |
SAN 扩展缺失(Go 1.15+ 起强制) | 老证书只有 CN,没有 subjectAltName |
据 RFC 5280 §4.1,Certificate 是一个嵌套 SEQUENCE:外层三个元素 tbsCertificate、signatureAlgorithm、signatureValue,其中 TBSCertificate 内部字段顺序固定为 version[0]、serialNumber、signature、issuer、validity、subject、subjectPublicKeyInfo、issuerUniqueID[1]、subjectUniqueID[2]、extensions[3]。客户端实际做的事就是:用 issuer 去匹配上一张证书的 subject、验 signature 里的算法与签名值、检查 validity 时间窗、用 SAN 匹配主机名、按 KeyUsage/BasicConstraints 判断能否签发下级、再按 AIA 去拉 OCSP、按 CRLDP 找吊销列表。任何一项不满足即中止握手,所以“证书没坏但连不上”是常态。
想定位到底卡在哪一项,跑这组命令(OpenSSL 3.x 通用):
# 1) 按语义字段查看 tbsCertificate:输出顺序 = RFC 5280 定义顺序
openssl x509 -in leaf.pem -noout -text
# 2) 列出整条链的 subject/issuer,检查是否首尾相接(顺序错是最常见的部署事故)
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 3) 按 ASN.1 TLV 偏移查看原始 DER:偏移量 ≠ 字段序号,别拿它当字段索引
openssl x509 -in leaf.pem -outform DER -out leaf.der
openssl asn1parse -in leaf.der -i
# 4) 显式验证链,复现 error 20 / error 21 / error 10 等具体码
openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem
# 期望输出:leaf.pem: OK
这里有个反复被踩的坑:openssl x509 -text 按语义标签输出,openssl asn1parse 按 DER 的 TLV 字节偏移输出,两者顺序并不一一对应——extensions 在 -text 里排在末尾,但在 DER 里是 [3] EXPLICIT 上下文标签。另外 PEM 只是 Base64 + 头尾行的封装,真正的结构在 DER 里;把 PEM 直接喂给 asn1parse 会得到 Error: offset out of range,必须先 -outform DER。
版本层面有两个硬约束会直接把“结构合法”的证书判死:OpenSSL 3.0.13 的默认安全级别为 SECLEVEL=2(openssl.cnf 中 CipherString = DEFAULT@SECLEVEL=2),RSA 密钥小于 2048 位、SHA-1 签名会被拒绝;Let’s Encrypt 自 2024 年起默认签发 90 天 DV 证书,链为 ISRG Root X1(RSA)与 ISRG Root X2(ECDSA),其字段结构与商业 CA 完全一致,出问题几乎都在链拼接而非字段定义。据 Mozilla 服务器端 TLS 配置指南,中间证书必须随 leaf 一并下发,这正是浏览器报 ERR_CERT_AUTHORITY_INVALID 的首要原因。
影响面不止握手本身:OCSP stapling 依赖 AIA 扩展里的 OCSP URI,缺失则 stapling 永远为空、Nginx 报 ssl_stapling ignored, issuer certificate not found;HTTP/2 与 gRPC 走同一套校验,链错时 gRPC-Go 直接抛 transport: authentication handshake failed,把根因埋进多层包装里。所以排查顺序应是“先看链顺序,再看 issuer/subject 匹配,最后看扩展”,而不是急着换证书文件。
x509 证书结构里到底有哪些字段?TBSCertificate 逐项拆解
因为 openssl x509 -text 打印的是「解码后的人类可读视图」,而真正决定证书是否合法的是它的 ASN.1 骨架。先看外层,据 RFC 5280 §4.1,一个 x509 证书结构在最外层只有一个 SEQUENCE,且恰好三个元素:
Certificate ::= SEQUENCE {
tbsCertificate TBSCertificate,
signatureAlgorithm AlgorithmIdentifier,
signatureValue BIT STRING }
TBSCertificate ::= SEQUENCE {
version [0] EXPLICIT Version DEFAULT v1,
serialNumber CertificateSerialNumber,
signature AlgorithmIdentifier,
issuer Name,
validity Validity,
subject Name,
subjectPublicKeyInfo SubjectPublicKeyInfo,
issuerUniqueID [1] IMPLICIT UniqueIdentifier OPTIONAL,
subjectUniqueID [2] IMPLICIT UniqueIdentifier OPTIONAL,
extensions [3] EXPLICIT Extensions OPTIONAL }
用 OpenSSL 3.x(3.0.0 起支持,Ubuntu 22.04 自带 3.0.2)可以直接验证这个三段式,注意 hl/l 数值随证书长度变化:
# 只看 ASN.1 骨架,-i 按嵌套层级缩进
openssl asn1parse -in cert.pem -i | head -n 6
# 0:d=0 hl=4 l=1334 cons: SEQUENCE
# 4:d=1 hl=4 l= 942 cons: SEQUENCE <-- tbsCertificate
#946:d=1 hl=2 l= 13 cons: SEQUENCE <-- signatureAlgorithm(外层)
#961:d=1 hl=2 l= 257 prim: BIT STRING <-- signatureValue
为什么外层的 signatureAlgorithm 必须和 TBS 内的 signature 逐字节一致? 因为 RFC 5280 §4.1.1.2 明确要求两者 “MUST contain the same algorithm identifier”,否则证书判为无效。这是防篡改设计:TBS 是被签名的原文,外层算法若可单独改写,攻击者就能把 sha256WithRSAEncryption 降级成弱算法而不破坏签名。OpenSSL 3.x 在一致性检查失败时会直接抛错:
openssl verify -CAfile ca.pem cert.pem
# cert.pem: C = US, O = Example, CN = example.com
# error 7 at 0 depth lookup: certificate signature failure
# error cert.pem: verification failed
接下来按字段逐项拆解 TBS 内部(openssl x509 -text 输出对照):
| 字段 | ASN.1 类型 / 编码 | 硬性约束与默认值 | 读取命令 |
|---|---|---|---|
version |
[0] EXPLICIT INTEGER,DEFAULT v1 |
v1=0、v2=1、v3=2;只有 v3 能带 extensions(RFC 5280 §4.1.2.9) | openssl x509 -noout -text | grep Version → Version: 3 (0x2) |
serialNumber |
INTEGER,1–20 字节 | 同一 CA 内唯一、必须为正数;Let’s Encrypt 常见 16 字节随机值 | openssl x509 -noout -serial → serial=03:1A:... |
issuer / subject |
Name(RDNSequence) |
典型 C=US, O=Let's Encrypt, CN=R3;SAN 存在时 CN 不参与主机名校验,Chrome 58+ 已完全忽略 CN |
openssl x509 -noout -issuer -subject |
validity |
SEQUENCE { notBefore, notAfter } |
1950–2049 用 UTCTime(YYMMDD…Z),2050 起用 GeneralizedTime;LE 90 天,商业 OV 常见 1 年,根证书 20–25 年 |
openssl x509 -noout -dates |
subjectPublicKeyInfo |
SEQUENCE { algorithm, BIT STRING } |
RSA 2048 的模数为 256 字节;ECDSA P-256 未压缩点为 65 字节(04+32+32) |
openssl x509 -noout -pubkey |
几个容易踩的细节:version 带 DEFAULT v1 意味着 DER 编码时若值为 0 就必须省略,所以 v1 证书里看不到该字段——这也是老证书用 asn1parse 数偏移量时容易错位一格的原因。序列号上限 20 字节来自 RFC 5280 §4.1.2.2,超长的证书在严格校验器(如 Go 的 crypto/x509)里会被拒。有效期方面,据 CA/Browser Forum SC-081 决议,公开信任 TLS 证书的最长有效期将分阶段从 398 天压缩到 200 天(2026-03)、100 天(2027-03)、47 天(2029-03),这会直接推高自动化签发的需求。
一次拿到全部关键字段的完整命令序列:
# 适用于 OpenSSL 3.0+;1.1.1 亦可用,输出格式略有差异
openssl x509 -in cert.pem -noout -subject -issuer -serial -dates -fingerprint -sha256
# subject=C = US, O = Let's Encrypt, CN = R3
# issuer=C = ISRG Root X1, O = Internet Security Research Group, CN = ISRG Root X1
# serial=03:1A:... (十六进制,冒号分隔)
# notBefore=Feb 1 00:00:00 2024 GMT
# notAfter=Apr 30 23:59:59 2024 GMT
# SHA256 Fingerprint=1A:2B:...
# 导出公钥并确认长度(RSA 2048 → 256 字节模数)
openssl x509 -in cert.pem -noout -pubkey | openssl pkey -pubin -text -noout | head -n 3
# Public-Key: (2048 bit)
# Modulus:
# 00:...
剩下没展开的 [3] EXPLICIT extensions 才是现代 x509 证书结构里信息量最大的部分——SAN、Key Usage、Basic Constraints、CRL Distribution Points、SCT 列表都藏在这里,下一节单独讲。如果你现在就想确认某张证书是否 v3、是否真的带扩展,一条命令即可:
openssl x509 -in cert.pem -noout -text | grep -E "Version|X509v3 extensions"
# 若只输出 Version: 1 (0x0) 而无 extensions 行,说明这是 v1 证书,
# 不能用作 CA、也不含 SAN,浏览器会直接拒绝。
SAN、KeyUsage、BasicConstraints 这些扩展如何影响证书链校验?
证书没过期、签名也验得过,openssl verify 却还是失败——十有八九问题不在签名,而在扩展字段。X.509 证书结构里 TBSCertificate 的 extensions 序列决定了”这张证书被允许干什么”,校验链时每一层都会检查。先把六个关键扩展放在一张表里对照,再逐条看命令。
| 扩展 | OID | CA 证书要求 | 终端(服务器)证书要求 | 配错时的典型现象 |
|---|---|---|---|---|
| subjectAltName | 2.5.29.17 | 可选 | 必须,含全部 DNS/IP | 浏览器 ERR_CERT_COMMON_NAME_INVALID |
| basicConstraints | 2.5.29.19 | CA:TRUE,可带 pathlen |
CA:FALSE |
error 79 ... invalid CA certificate |
| keyUsage | 2.5.29.15 | keyCertSign, cRLSign |
digitalSignature[, keyEncipherment] |
链校验失败或握手被拒 |
| extendedKeyUsage | 2.5.29.37 | 通常省略 | serverAuth(双向 TLS 加 clientAuth) |
error 26 ... unsupported certificate purpose |
| authorityInfoAccess | 1.3.6.1.5.5.7.1.1 | 指向 OCSP/CA Issuers | 同左,供 stapling 用 | OCSP stapling 拿不到响应 |
为什么浏览器不再看 CN,只认 SAN?通配符能盖几级?
据 RFC 6125 与 CA/Browser Forum 基线要求,Chrome 58 起、Firefox 同样只以 subjectAltName 匹配主机名,Common Name 里的域名直接被忽略。通配符 *.example.com 只覆盖一级标签:匹配 www.example.com,不匹配 a.b.example.com,也不匹配裸域 example.com——所以生产证书通常把裸域和泛域名一起写进 SAN。OpenSSL 3.x 的 x509 子命令支持 -ext 单列某个扩展(该选项自 1.1.1 起提供):
# 只打印 SAN,不输出整份证书
openssl x509 -in server.pem -noout -ext subjectAltName
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:*.example.com, IP Address:203.0.113.10
# 查看 critical 标记:-text 会在扩展名后跟 "critical"
openssl x509 -in server.pem -noout -text | grep -A1 "Subject Alternative Name"
basicConstraints 缺失为什么直接断链?pathlen 怎么数?
据 RFC 5280 §4.2.1.9,只有断言了 CA:TRUE 的证书才允许签发下级证书;终端证书必须显式或隐式 CA:FALSE。pathlen:N 限制该 CA 之下还能再挂 N 层中间 CA,pathlen:0 表示只能直接签终端证书。自签根和中间 CA 通常把此扩展标为 critical。
# 检查中间 CA 的 CA 标志与层数限制
openssl x509 -in intermediate.pem -noout -ext basicConstraints
# X509v3 Basic Constraints: critical
# CA:TRUE, pathlen:0
# 完整链校验:-untrusted 传入中间 CA,-CAfile 传根
openssl verify -CAfile root.pem -untrusted intermediate.pem server.pem
# server.pem: OK
# 若中间 CA 漏了 basicConstraints:
# error 79 at 0 depth lookup: invalid CA certificate
keyUsage 和 EKU 到底该写哪几位?
CA 证书的 keyUsage 必须包含 keyCertSign(签证书)与 cRLSign(签 CRL),否则链校验在中间层就断。RSA 服务器证书常见 digitalSignature, keyEncipherment;但 ECDSA/Ed25519 证书不应带 keyEncipherment——密钥交换由 ECDHE 完成,客户端看到该位与密钥类型矛盾时可能直接拒绝。EKU 方面,服务器 TLS 需要 serverAuth(1.3.6.1.5.5.7.3.1),mTLS 客户端证书需要 clientAuth(…3.2);Java 8u181 之后对缺失 EKU 的证书会报 No extended key usage extension。用 -purpose 可以一次性验证用途:
# 按用途校验(sslserver / sslclient 会同时检查 KU 与 EKU)
openssl verify -purpose sslserver -CAfile root.pem -untrusted intermediate.pem server.pem
# 单列 EKU 与 KU
openssl x509 -in server.pem -noout -ext extendedKeyUsage,keyUsage
critical 标志写错会怎样?AIA 又有什么用?
RFC 5280 §4.2 规定:遇到不认识的 critical 扩展,客户端必须拒绝整张证书。所以 basicConstraints、keyUsage 在 CA 证书上标 critical 是常规做法,而终端证书的 SAN 一般为 non-critical,避免旧设备误判。authorityInfoAccess 提供 OCSP - URI 与 CA Issuers - URI,OCSP stapling 正是靠它定位响应源;Let’s Encrypt 曾使用 http://r3.o.lencr.org,但其已宣布停用 OCSP、转向 CRL,新签发证书的 OCSP URI 可能为空,排障时别默认它一定存在:
# 读取 AIA 中的 OCSP 地址(无输出说明该字段缺失)
openssl x509 -in server.pem -noout -ocsp_uri
回到 x509 证书结构本身:扩展位于 TBSCertificate 的 [3] EXPLICIT 包装内,每条由 extnID、可选的 critical 布尔值和 extnValue OCTET STRING 组成——校验链时真正参与判断的,就是这三个字段的组合。
完整实操步骤:用 OpenSSL 3.x 逐层解析一张证书
问:拿到一张 cert.pem,怎么用 OpenSSL 3.x 把 x509 证书结构一层层拆开?下面是一条从”版本”走到”扩展”的可复制命令序列,每一步都说明它落在 TBSCertificate 的哪个部分。
步骤 1:先确认工具版本与文件编码。版本决定参数是否可用(-ext 的多字段逗号语法是 OpenSSL 3.0 起才支持的),编码决定要不要加 -inform。
# 建议 3.0.13 / 3.1.7 / 3.2.2 及以上(含安全修复的 LTS 分支)
openssl version -a
# 输出示例:OpenSSL 3.2.2 3 Sep 2024 (Library: OpenSSL 3.2.2 3 Sep 2024)
file cert.pem # 看是 "PEM certificate" 还是 "data"(DER 二进制)
head -1 cert.pem # PEM 首行必为 -----BEGIN CERTIFICATE-----
| 特征 | PEM | DER |
|---|---|---|
| 编码 | Base64 + 头尾标记 | 原始 ASN.1 二进制 |
| OpenSSL 参数 | -inform PEM(默认值) |
-inform DER |
| 常见来源 | Nginx、Let’s Encrypt 签发结果 | Windows 证书存储、Java KeyStore 导出 |
报错 unable to load certificate(error:0480006C:PEM routines::no start line)九成是把 DER 当 PEM 读,补上 -inform DER 即可。
步骤 2:看整体字段。这一步把 TBSCertificate 的顶层字段全打印出来,据 RFC 5280 §4.1 它们依次是 version、serialNumber、signature、issuer、validity、subject、subjectPublicKeyInfo、extensions。
openssl x509 -in cert.pem -noout -text -nameopt RFC2253
# -nameopt RFC2253 让 DN 输出为 CN=example.com,O=... 的稳定顺序,便于脚本比对
重点抄下 Version(v3 才有扩展)、Serial Number、Signature Algorithm、Issuer/Subject、Validity 与 X509v3 extensions 段。
步骤 3:定位 ASN.1 边界。文本视图看不出 TLV 结构,用 asn1parse 找偏移:
openssl asn1parse -in cert.pem -inform PEM -i
# 0:d=0 hl=4 l=1234 cons: SEQUENCE <- Certificate 整体
# 4:d=1 hl=4 l= 987 cons: SEQUENCE <- tbsCertificate
openssl asn1parse -in cert.pem -inform PEM -i -strparse 4
# 进入 tbsCertificate 后再看 signature 字段的 OID,如
# OBJECT : sha256WithRSAEncryption (1.2.840.113549.1.1.11)
为什么是 -strparse 4?因为外层 SEQUENCE 的头部 hl=4(1 字节 tag + 3 字节长度),内容从第 4 字节开始。这正是理解 x509 证书结构的关键:证书 = 三个 SEQUENCE,签名算法在 tbsCertificate 内外各出现一次,必须一致。
步骤 4:核对信任链。
openssl verify -CAfile root.pem -untrusted intermediate.pem cert.pem
# 期望输出:cert.pem: OK
# 缺中间证书时报:error 20 at 0 depth lookup: unable to get local issuer certificate
步骤 5:有效期与序列号。
openssl x509 -in cert.pem -noout -dates -serial
openssl x509 -in cert.pem -checkend 2592000 -noout; echo $?
# 退出码 0 = 30 天内不过期,1 = 即将过期;2592000 = 30*24*3600 秒
CA/Browser Forum 基线要求序列号至少 64 位熵,实际观测多为 16–20 字节。
步骤 6:导出扩展与公钥。
openssl x509 -in cert.pem -noout
-ext subjectAltName,keyUsage,extendedKeyUsage,basicConstraints,authorityInfoAccess
openssl x509 -in cert.pem -noout -pubkey > pub.pem
-ext 在 3.0 之前只能单字段重复传参,3.0+ 才支持逗号分隔。据 Let’s Encrypt 文档,其证书的 SAN 同时含 DNS 与可选 IP,而 basicConstraints 在叶证书中应为 CA:FALSE——若解析出 CA:TRUE,说明签发的不是终端实体证书,需立即排查。
配置/命令示例:OpenSSL 3.0.13 下可直接复制的解析命令
只想快速看清一张证书,最短的命令是什么?
OpenSSL 3.0.13(2024 年 1 月发布,Debian 12 / Ubuntu 24.04 的默认版本)下,解析 Let’s Encrypt 风格的 fullchain.pem 用下面两条即可。注意 -noout 的作用是抑制把输入 PEM 原样回显,否则 -text 的解码结果后面会再跟一遍 base64 块,脚本里容易多读一次。
# 完整解码:TBSCertificate 的 version/serial/signature/validity/subject/issuer 与全部 X.509v3 扩展
openssl x509 -in fullchain.pem -noout -text -nameopt RFC2253
# 只取主体,验证 DN 的显示顺序:RFC2253 输出 CN=example.com,O=Example Inc,C=US(逆序、无空格)
openssl x509 -in fullchain.pem -noout -subject -nameopt RFC2253
# 不指定 -nameopt 时,OpenSSL 3.x 的 x509 默认等价于 oneline:
# subject=C = US, O = Example Inc, CN = example.com(正序、逗号后带空格)
openssl x509 -in fullchain.pem -noout -subject
据 OpenSSL 3.0 的 x509(1) 手册页,-nameopt 只影响显示,不参与任何校验或指纹计算;但它决定了 DN 字符串的字节形态,所以入库前必须固定,否则同一张证书在两次采集里会得到两条不同记录。RFC 5280 第 4.1.2.4 节只规定 DN 的编码(UTF8String/PrintableString 等),并未规定打印顺序,这正是需要显式指定 RFC2253 的原因。
要把字段写进 CMDB 资产表,怎么一次拿全且避免 SHA1?
openssl x509 -fingerprint 在 OpenSSL 3.x 中默认摘要算法仍是 SHA-1,输出前缀为 SHA1 Fingerprint=;不显式加 -sha256 的老脚本会一直产出 40 位十六进制串,与浏览器、CT 日志、证书透明度工具使用的 SHA-256 指纹对不上。
# -sha256 指定指纹算法;-dates 同时给出 notBefore/notAfter(GMT,ASN.1 GeneralizedTime)
openssl x509 -in cert.pem -noout -serial -subject -issuer -dates -fingerprint -sha256 -nameopt RFC2253
# 典型输出(可直接 awk -F= 切分入表)
# serial=03A1B2C3D4E5F6
# subject=CN=example.com,O=Example Inc,C=US
# issuer=C=US,O=Let's Encrypt,R=Let's Encrypt,CN=R11
# notBefore=Feb 10 00:00:00 2025 GMT
# notAfter=May 11 23:59:59 2025 GMT
# SHA256 Fingerprint=6F:1A:...:C2
怀疑字段被工具“美化”了,怎样看到原始 ASN.1 层级?
-text 是渲染后的视图,真正对应 RFC 5280 的 TBSCertificate ::= SEQUENCE 结构要用 asn1parse。DER 文件必须换成 -inform DER,否则报 Error: unable to load certificate。
# -i 按嵌套层级缩进;-dump 同时输出十六进制与 ASCII,便于定位 OID 与字符串
openssl asn1parse -in cert.pem -inform PEM -i -dump
# 输出首行形如:0:d=0 hl=4 l=1893 cons: SEQUENCE
# d=深度,hl=头部长度(字节),l=内容长度,cons=构造类型
openssl asn1parse -in cert.der -inform DER -i | head -5
本地验证链失败时,报错长什么样?
verify 用 -CAfile 给根、-untrusted 给中间证书(可重复出现以追加多级中间链)。据 Let’s Encrypt 文档,fullchain.pem 已含叶子与中间证书,拆成 cert.pem + chain.pem 才能这样验证。
openssl verify -verbose -CAfile isrgrootx1.pem -untrusted chain.pem cert.pem
# 成功:cert.pem: OK
# 缺中间证书:error 20 at 0 depth lookup: unable to get local issuer certificate
# 根不在信任集:error 18 at 0 depth lookup: self-signed certificate
线上握手与格式转换还有哪些必备命令?
# 在线握手:-servername 触发 SNI;-status 请求 OCSP stapling;-verify_return_error 让校验失败返回非 0
openssl s_client -connect example.com:443 -servername example.com
-showcerts -status -verify_return_error </dev/null
# 关注输出:OCSP Response Status: successful (0x0) / Verify return code: 0 (ok)
# DER → PEM,-inform/-outform 必须成对出现
openssl x509 -in cert.der -inform DER -out cert.pem -outform PEM
# 打包 PKCS#12:OpenSSL 3.x 默认 PBES2 + AES-256-CBC + PBKDF2;
# 老设备(Windows Server 2008、Java 8 早期版本)不认 PBES2,才需要追加 -legacy
openssl pkcs12 -export -in cert.pem -inkey key.pem -certfile chain.pem
-out bundle.p12 -name example.com
| 任务 | 关键选项 | 默认值 / 取值范围与坑 |
|---|---|---|
| DN 显示 | -nameopt RFC2253 |
默认 oneline;RFC2253 逆序无空格,multiline 换行缩进 |
| 指纹算法 | -fingerprint -sha256 |
不指定时为 SHA-1(40 位十六进制),SHA-256 为 64 位 |
| ASN.1 输入 | -inform PEM|DER |
默认 PEM;DER 需显式声明,否则解析失败 |
| PKCS#12 加密 | -legacy |
3.x 默认 PBES2/AES-256-CBC;-legacy 回落 RC2-40/3DES |
最后提一个易忽略点:-text 里 X509v3 Subject Alternative Name 的 DNS: 顺序就是证书 GeneralNames 的原始顺序,OpenSSL 不做排序;脚本提取时建议改用 openssl x509 -in cert.pem -noout -ext subjectAltName,避免从 -text 的多段文本里正则截取。
参数对比与方案选型:openssl x509、asn1parse、certinfo 该用哪个?
先给结论:人工排障用 openssl x509 -text;要给程序或数据库消费就用 certinfo -json 或 cfssl certinfo;需要追到 DER 字节偏移、排查“为什么某字段解析歪了”才动 asn1parse;验证线上链路顺序与 OCSP 装订则必须用 s_client -showcerts -status。下表把六个常用入口放在一起(版本实测:OpenSSL 3.0.13 LTS、certinfo 1.0.6、cfssl 1.6.4、Python cryptography 42.0):
| 工具/命令 | 版本 | 主要用途 | 输出可读性 | 显示扩展 | 适用场景 |
|---|---|---|---|---|---|
openssl x509 -text |
3.0.13 | 整体字段巡检 | 高 | 是 | 人工排障 |
openssl asn1parse -i |
3.0.13 | ASN.1 层级/偏移 | 低 | 否(需 -strparse) |
编码排查 |
openssl s_client -showcerts |
3.0.13 | 线上链顺序 | 中 | 是 | 握手排障 |
certinfo -json |
1.0.6 | JSON 输出 | 高 | 是 | 自动化入库 |
cfssl certinfo |
1.6.4 | JSON/CA 集成 | 高 | 是 | 内部 CA |
Python cryptography |
42.0 | 编程解析 | 中 | 是 | 平台开发 |
关键差异在于是否保留编码层信息。x509 -text 把 TBSCertificate 的 version、serialNumber、signature、issuer、validity、subject、subjectPublicKeyInfo 逐段渲染成人类可读文本,扩展也翻译成 X509v3 Subject Alternative Name: 这类段落,但它丢掉了原始偏移;asn1parse 反过来只给 d=2 hl=2 l=3 prim: INTEGER :02 这种 TLV 结构,适合定位某个 OCTET STRING 的起止字节。据 OpenSSL 3.x 的 x509(1) 手册页,-ext 自 3.0 起才支持逗号分隔的多扩展名。
# 1) 整体巡检:-noout 抑制重复的 PEM 回显
openssl x509 -in cert.pem -noout -text
# 2) 只看关键扩展(3.0+ 支持逗号分隔;1.1.1 会解析失败)
openssl x509 -in cert.pem -noout -ext subjectAltName,basicConstraints,keyUsage
# 3) 追 DER 偏移:-i 缩进层级,-strparse 深挖指定偏移
openssl asn1parse -in cert.pem -i | head -20
openssl asn1parse -in cert.pem -strparse 4 -i # 展开 TBSCertificate 段
# 4) 线上链路顺序 + OCSP 装订状态(SNI 必须显式给)
openssl s_client -connect example.com:443 -servername example.com -showcerts -status </dev/null
# 5) 机器可读:JSON 直接入库
certinfo -json cert.pem
cfssl certinfo -cert cert.pem
# 6) 内网自签根 CA(RSA 3072、10 年、无口令私钥)
openssl req -x509 -newkey rsa:3072 -days 3650 -nodes
-keyout ca.key -out ca.pem -subj "/CN=Internal Root CA"
常见报错:把 DER 文件喂给默认 PEM 解析器会得到 unable to load certificate … no start line,需显式加 -inform DER;在 OpenSSL 1.1.1 上执行多扩展的 -ext,会报扩展名无法解析(v3_conf.c 中 extension name not found)。1.1.1 已于 2023-09-11 结束公共支持,生产环境建议 3.0.13 LTS 或 3.2.x。
选型还要先认清容器格式,同一个 x509 证书可以装进四种常见容器:
| 格式 | 结构 | 扩展名 | 常见使用者 |
|---|---|---|---|
| PEM | Base64 + -----BEGIN CERTIFICATE----- 头尾 |
.pem .crt |
OpenSSL 默认、Nginx ssl_certificate(需 fullchain) |
| DER | 二进制 ASN.1 | .der .cer |
Java、Windows 证书存储 |
| PKCS#7 | 只含证书链,无私钥 | .p7b |
Windows 导入链、部分中间件 |
| PKCS#12 | 私钥 + 证书,需口令 | .pfx .p12 |
Tomcat JKS 之外的主流选择、IIS 导出 |
# PEM 与 DER 互转
openssl x509 -in cert.pem -outform DER -out cert.der
openssl x509 -in cert.der -inform DER -noout -text
# 打包 PKCS#12(Tomcat/Spring Boot 可直接用)
openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem
-name myapp -out bundle.p12
# 从 p7b 提取证书链回 PEM
openssl pkcs7 -in chain.p7b -inform DER -print_certs -out chain.pem
成本与周期:Let’s Encrypt 免费、90 天有效期、支持 ACME 自动续期;DigiCert、GlobalSign 的 OV 证书约 1000–3000 元/年,EV 约 3000–8000 元/年(以官方公开报价为准)。内网可用上面的自签命令,但必须把 ca.pem 通过组策略或镜像预置分发到所有客户端,否则会触发 x509: certificate signed by unknown authority。想继续深入 TBSCertificate 各字段的 ASN.1 定义,可对照 RFC 5280 第 4.1 节逐项核对 asn1parse 的偏移输出。
常见错误与排查:这些真实报错分别对应证书结构的哪一层?
这六条报错分别落在 x509 证书结构的不同层次上。按 RFC 5280 的定义,一张证书由三段组成:TBSCertificate(包含 serialNumber、issuer、validity、subject、subjectPublicKeyInfo 与扩展区)、signatureAlgorithm 和 signatureValue。先判断报错命中的是“链/信任锚”“扩展”“有效期”“密钥绑定”还是“编码”,再去查对应的字段,比盲目替换证书快得多。下面每条命令均适用于 OpenSSL 3.x(3.0–3.2 输出一致),其中 -ext 需 1.1.1 及以上。
| 报错片段 | 命中的结构层 | 首查命令 |
|---|---|---|
error 20 ... unable to get local issuer certificate |
链:issuer 指向的中间证书未随包下发 |
openssl s_client -showcerts |
x509: certificate signed by unknown authority |
信任锚:回溯不到自签根 | openssl verify -CAfile |
does not match certificate's altnames |
扩展:subjectAltName |
openssl x509 -ext subjectAltName |
has expired or is not yet valid |
validity 的 notBefore/notAfter |
openssl x509 -dates + date -u |
key values mismatch |
subjectPublicKeyInfo 与私钥不配对 |
两端导出公钥 SHA256 比对 |
expect: TRUSTED CERTIFICATE |
编码层:PEM/DER 或多余文本 | file cert.pem |
为什么 Nginx 配了证书还是报 error 20?这是链层问题:服务器只发了终端证书。先用下面命令数证书条数,正常应 ≥2 条(终端 + 中间):
# OpenSSL 3.x:列出服务器实际下发的证书链,s: 是 subject,i: 是 issuer
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null
| grep -E '^ *[0-9]+ s:'
# 只有一条 s: 即缺中间证书;本地再补验一次
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
据 Let’s Encrypt 文档,fullchain.pem 才是“终端 + 中间”,cert.pem 仅终端。ssl_certificate 应指向前者,且顺序为终端在前、中间在后:
# /etc/nginx/conf.d/example.conf(nginx 1.18+ 均支持)
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 终端+中间,顺序不可颠倒
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # 私钥单独一行
Go 程序报 certificate signed by unknown authority 怎么办?这属于信任锚层,与证书结构本身无关。Go 在 Linux 上读取 /etc/ssl/certs/ca-certificates.crt,也可用 SSL_CERT_FILE/SSL_CERT_DIR 覆盖;容器镜像里 ca-certificates 包过旧同样会触发。SSL_CERT_FILE 的默认值是空(回落到系统路径)。
# 用系统信任库复现/排除
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt cert.pem
# 把自签根装进系统库后刷新(Debian/Ubuntu 路径)
sudo cp my-root.crt /usr/local/share/ca-certificates/ && sudo update-ca-certificates
# 仅对单个进程临时指定
SSL_CERT_FILE=/usr/local/share/ca-certificates/my-root.crt ./app
域名明明签了,为什么还报 altnames 不匹配?命中的是扩展层 subjectAltName(RFC 5280 §4.2.1.6;CN 已退化为兜底,现代客户端只认 SAN)。注意通配符只覆盖一级:*.example.com 不匹配 a.b.example.com,也不匹配裸 example.com(RFC 6125)。
openssl x509 -in cert.pem -noout -ext subjectAltName
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:*.example.com
时间报错怎么确认是证书过期还是本机时钟漂移?读 validity 两个时间戳并与 UTC 当前时间对比,容器时钟偏差超过 5 分钟就足以触发 notBefore 未到:
openssl x509 -in cert.pem -noout -dates -subject
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=May 30 23:59:59 2025 GMT
date -u # 与上面比较,差值 > 5min 先查 NTP
证书和私钥不配对怎么快速判定?两者都必须导出同一个 subjectPublicKeyInfo 的 SHA256,两值一致才算配对:
openssl x509 -in cert.pem -noout -pubkey | openssl pkey -pubin -outform der | openssl sha256
openssl pkey -in key.pem -pubout -outform der | openssl sha256
# 两行输出必须完全相同,否则就是配错文件
unable to load certificate ... expect: TRUSTED CERTIFICATE 是什么原因?这是编码层错误:OpenSSL 在 PEM 解析时没找到 -----BEGIN CERTIFICATE----- 行。常见于文件实际是 DER、混入 BOM/前导空格、或粘贴时带了多余文本。file 输出 data 即 DER,需显式 -inform DER;输出 ASCII text 再检查首行与行尾。
file cert.pem # PEM: ASCII text;DER: data
head -1 cert.pem # 必须是 -----BEGIN CERTIFICATE-----
openssl x509 -in cert.pem -inform DER -noout -subject # DER 文件必须带 -inform DER
把这六类错误与 TBSCertificate 的字段一一对齐后,排查顺序就固定了:先 s_client -showcerts 看链是否完整,再 openssl verify 看信任锚,最后用 -ext subjectAltName、-dates、公钥 SHA256 分别核对扩展、有效期与密钥绑定——每一步都有确定性的命令输出,不需要靠猜测换证书。
效果验证:如何确认 x509 证书结构解析与链配置已生效?
验证 x509 证书结构解析是否正确、链配置是否真正生效,不能只看浏览器地址栏的锁图标——那只能说明”某条路径”成功了。下面按”本地静态验证 → 线上握手 → HTTP 层 → 字段抽查 → 自动化巡检 → 客户端兼容”六层递进,每层都给可复制命令与判定标准。
1. 本地链验证(最快、最确定)
把服务器证书、中间证书、根证书分开存放,让 OpenSSL 从零构建链。据 OpenSSL 3.x 手册页 verify(1),-untrusted 提供候选中间证书,-CAfile 是唯一信任锚:
# OpenSSL 3.0+ 适用;-verify_hostname 在 1.1.0 起提供
openssl verify -CAfile root.pem -untrusted intermediate.pem
-verify_hostname example.com server.pem
# 期望输出:server.pem: OK
# 若 SAN 不匹配会输出:error 62 at 0 depth lookup: hostname mismatch
注意 -verify_hostname 检查的是 SAN 扩展而非 CN(RFC 6125 已废弃 CN 匹配),这正好反向验证了你对 TBSCertificate 扩展字段的解析是否正确。
2. 线上握手与 OCSP stapling
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error -status </dev/null
# 关键三行:
# Verify return code: 0 (ok)
# OCSP Response Status: successful (0x0)
# Protocol : TLSv1.3 Cipher : TLS_AES_256_GCM_SHA384
-verify_return_error 让验证失败时直接终止而非仅打印警告,这是把它接入 CI 的前提;-status 请求 stapling。若显示 OCSP response: no response sent,说明服务端未配置 ssl_stapling on;(Nginx)或证书链缺少签发者证书。
3. HTTP 层与协议兼容
curl -vI https://example.com --cacert root.pem # 看 "SSL certificate verify ok"
curl -vI --tlsv1.2 --tls-max 1.2 https://example.com # 强制 TLS 1.2 回归测试
4. 字段抽查(对照解析结果)
openssl x509 -in cert.pem -noout -subject -issuer -dates
-ext subjectAltName -serial
openssl x509 -in cert.pem -noout -text | grep -E "Signature Algorithm|Public-Key"
判定基线:notAfter 剩余 > 30 天;签名算法为 sha256WithRSAEncryption 或 ecdsa-with-SHA256(SHA-1 已被 CA/B Forum 基线要求淘汰);序列号熵 ≥ 64 位(RFC 5280 要求正整数且唯一,CA/B Forum 要求至少 64 位熵)。
5. 自动化巡检
# 退出码 0 = 30 天内不过期;1 = 即将/已过期
openssl x509 -checkend 2592000 -noout -in cert.pem && echo "OK" || echo "EXPIRING"
Prometheus blackbox_exporter 0.24+ 暴露 probe_ssl_earliest_cert_expiry(Unix 时间戳),配合 probe_ssl_earliest_cert_expiry - time() < 86400*14 即可告警。
6. 客户端兼容性差异
| 客户端 | 验证命令 / 配置 | 常见失败原因 |
|---|---|---|
| GnuTLS | gnutls-cli --x509cafile root.pem -p 443 example.com |
缺少中间证书 |
| Java | java -Djavax.net.debug=ssl:handshake ... |
JDK 8u301 前不校验证书链顺序 |
| Android 7+ | 需 network_security_config 显式信任用户 CA |
默认只信任系统 CA |
据 Let’s Encrypt 文档,其默认链已切换至 ISRG Root X1,但老 Android(<7.1.1)仍可能因缺少交叉签名而失败——这就是为什么第 6 层必须单独测。至此,x509 证书结构的解析结论才算被真实验证,而不是停留在 -text 的输出里。
X.509 是证书的数据模型,PEM 与 DER 是编码/封装方式。DER 是 ASN.1 二进制,PEM 是 DER 的 Base64 文本加 `—–BEGIN CERTIFICATE—–` 头尾;OpenSSL 默认读写 PEM,Java KeyStore/Windows 常见 DER。
先确认证书是 v3 且包含 extensions,v1/v2 证书没有扩展字段。其次确认 OpenSSL 版本,3.0.13 可用 `-ext subjectAltName` 单列;1.1.1 对多扩展逗号分隔支持不完整,建议升级。
SAN 优先。RFC 6125 与 CA/Browser Forum 基线要求使用 subjectAltName 校验主机名,Chrome 58+ 已忽略 CN;通配符 `*.example.com` 只覆盖一级子域,不匹配 `a.b.example.com`。
通常是链中缺中间证书,或 `-CAfile` 没包含根。用 `-untrusted intermediate.pem` 补中间链,`-CAfile root.pem` 指定根;Nginx 的 `ssl_certificate` 要指向终端+中间的 fullchain.pem,顺序终端在前。
结构都遵循 RFC 5280,字段与 ASN.1 编码一致;差异在有效期(Let's Encrypt 90 天 vs 商业 OV 常见 1 年)、扩展策略(Let's Encrypt 含 SCT、AIA OCSP)、信任链(ISRG Root X1/X2 vs DigiCert Global Root G2)和价格(0 vs 约 1000-8000 元/年)。
运行 `openssl x509 -checkend 2592000 -noout -in cert.pem`,返回 0 表示 30 天内不会过期,返回 1 表示即将过期。配合 `echo $?` 可在脚本中直接判断。
RFC 5280 要求同一 CA 内序列号唯一、正数、最多 20 字节;Let's Encrypt 使用 16 字节随机数。重复会导致 CRL/OCSP 定位错误,因此不要把序列号当业务主键,也不要在不同 CA 之间比较唯一性。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。