跳到主要内容
基础知识

x509证书结构详解:TBSCertificate 字段、扩展与 OpenSSL 3.x 解析命令

x509证书结构 — 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。