跳到主要内容
基础知识

mTLS 双向认证原理详解:握手流程、证书校验与 Nginx 实操排查

mtls 双向认证原理 — mTLS 双向认证原理详解:握手流程、证书校验与 Nginx 实操排查
核心结论

mTLS 双向认证原理是客户端和服务端在 TLS 握手中各自出示 X.509 证书并验证对方证书链、有效期、用途与 SAN/CN,只有双方都通过校验才完成握手;典型失败会返回 TLS alert certificate required 或 400 No required SSL certificate was sent。 服务端用 ssl_verify_client on; 并配置 ssl_client_certificate 指向客户端 CA 链,Nginx 1.24.0 中 ssl_verify_client 默认 off、ssl_verify_depth 默认 1。 客户端证书建议由内部 CA 签发,有效期 90-365 天,密钥 RSA 2048 或 ECDSA P-256;用 openssl x509 -noout -dates -ext extendedKeyUsage 检查。 验证命令:openssl s_client -connect api.example.com:443 -cert client.crt -key client.key -CAfile ca.crt -verify_return_error 返回 Verify return code: 0 (ok) 才说明链校验通过。

问题背景与根本原因:为什么只有 HTTPS 还不够?

经常有人问:站点已经全站 HTTPS、地址栏挂着锁,为什么还要再折腾一层客户端证书?因为普通 HTTPS 解决的是“我连的服务器是不是真的”,而不是“连进来的客户端是谁”。浏览器用内置的 CA 公钥把站点证书链一路验到根,而服务端默认根本不看客户端身份。据 RFC 8446(TLS 1.3)§4.3.2,CertificateRequest 由服务端在握手时主动发出,且它本身就是一条可选消息——服务端不请求,客户端就不会发送证书。这就是单向认证的边界所在。

mTLS 双向认证原理的改动其实只有一步:把验证做成双向。服务端在 ServerHello 之后发出 CertificateRequest,客户端回 Certificate(完整链)加 CertificateVerify(用私钥对握手 transcript 签名),服务端再用本地信任锚校验这条链。要特别注意:客户端发的不是“一张证书”,而是“叶子证书 + 中间 CA”,少了中间证书同样会失败。

想确认某个站点到底有没有请求客户端证书,一条命令就够:

# 适用 OpenSSL 1.1.1+ / 3.x;观察服务端是否下发可接受的客户端 CA 列表
openssl s_client -connect api.example.com:443 -servername api.example.com /dev/null 
  | grep -A3 "Acceptable client certificate CA names"
# 无输出 = 服务端未发 CertificateRequest,仍然只是单向 HTTPS

# 手工校验一张客户端证书的链是否完整(排查 unknown ca 的第一步)
openssl verify -CAfile client-ca.crt -untrusted intermediate.crt client.crt
对比项 普通 HTTPS mTLS 双向认证
谁验证谁 仅客户端验证服务器 双向验证
客户端证书 不发送 必须发送完整链
服务端关键配置 ssl_certificate 额外 ssl_client_certificate + ssl_verify_client
凭证泄露后果 — API Key 泄露即可异地冒用;证书与设备私钥绑定,无法脱离设备复用
典型报错 — certificate required / unknown ca

业务触发点相当集中:内部 API 网关、Kubernetes Ingress 到后端的服务间调用、IoT 设备接入、B 端开放平台、数据库或消息队列前置代理。只靠 IP 白名单或 API Key 时,凭证一旦泄露,攻击者能在任意机器上重放——这正是 mTLS 双向认证原理在零信任架构中被反复提及的原因:身份绑定的是私钥,而不是一个可被复制的字符串。

根本原因不是“多加一张证书”,而是信任锚管理。以 Nginx 为例,两个参数决定成败:

server {
    listen 443 ssl;
    ssl_certificate     /etc/nginx/certs/server.crt;
    ssl_certificate_key /etc/nginx/certs/server.key;

    ssl_client_certificate /etc/nginx/certs/client-ca.crt;  # 信任锚:校验客户端证书的 CA 链,必填
    ssl_verify_client on;   # 默认 off;on=强制,optional=有则验,optional_no_ca=接收但不校验
    ssl_verify_depth 2;     # 默认 1;客户端链含中间 CA 时需设为 2 或更大
}

缺信任锚,握手直接报 unknown ca;客户端不发证书,Nginx 返回 400 Bad Request(No required SSL certificate was sent),OpenSSL 3.x 客户端侧则打印 tlsv13 alert certificate required。成本方面,内部 CA 用 openssl ca 或 step-ca 自建,软件成本 0 元,单张客户端证书签发 1–5 分钟;据 Let’s Encrypt 文档,其公共 DV 证书面向服务器身份验证,客户端证书通常由企业自建 CA 或私有 PKI 签发。

mTLS 握手流程与证书校验原理:从 ClientHello 到 Finished

mTLS 双向认证原理里最容易被跳过的一环,就是“客户端证书到底在哪一步被校验、用什么规则校验”。据 RFC 8446(TLS 1.3)第 4.3.2 节,服务端在 ServerHello 之后用 CertificateRequest 主动索要证书,客户端证书不是可选项,而是握手消息序列的一部分。TLS 1.3 的完整顺序如下(与 TLS 1.2 的差异在于:服务端证书在 EncryptedExtensions 之后才发送,且全部加密):

  1. 客户端 → ClientHello:携带 supported_versions、signature_algorithms、server_name(SNI)、key_share。
  2. 服务端 → ServerHello(明文)、EncryptedExtensions、CertificateRequest、Certificate、CertificateVerify、Finished。后 5 条已加密。
  3. 客户端 → Certificate(叶子证书 + 中间 CA,根证书不应发送)、CertificateVerify(用客户端私钥对握手 transcript 签名)、Finished。
  4. 服务端校验通过后回 Finished,应用数据开始传输。

CertificateRequest 只有两个关键字段:certificate_request_context(用于绑定该请求与后续 CertificateVerify 签名,防重放)和 signature_algorithms。后者是服务端给出的“允许的签名算法白名单”,客户端私钥必须能产生其中之一,例如 ecdsa_secp256r1_sha256、rsa_pss_rsae_sha256。若客户端用 RSA 私钥却只支持 PKCS#1 v1.5 的 rsa_pkcs1_sha256,而服务端(如 OpenSSL 3.x 默认安全级别)未列入该算法,握手会直接失败——这正是“证书看起来没问题却连不上”的高频原因。

服务端收到客户端证书后,按 RFC 5280 第 6 节做路径校验:从叶子证书逐级验签到信任锚,检查每级 CA 的 BasicConstraints CA:TRUE 与 pathLenConstraint,检查有效期、KeyUsage=digitalSignature、ExtendedKeyUsage=clientAuth,再按 CertificateVerify 的签名确认客户端确实持有私钥。注意 Nginx 默认不做客户端证书的 OCSP/CRL 主动查询,必须显式配置 ssl_crl 指向 CRL 文件,或用 ssl_ocsp(Nginx 1.19.3+ 的商业/第三方模块能力)等外部吊销检查,否则已吊销证书在有效期内仍可握手成功。

# 复现"首次完整握手",关闭 TLS 1.2 session ticket 与 TLS 1.3 PSK 恢复
# 适用 OpenSSL 1.1.1 / 3.x;-no_reuse 禁用 session ID 复用
openssl s_client -connect mtls.example.com:443 
  -servername mtls.example.com         # SNI:决定命中哪个 server 块
  -cert client.crt -key client.key     # 客户端证书与私钥
  -CAfile server-ca.pem                # 验证服务端证书的信任锚
  -no_ticket -no_reuse                 # 关键:强制走完整证书交换
  -state -msg 2>&1 | head -80
# 预期在输出中看到 "CertificateRequest" 与客户端 "Certificate" 两条消息

# 本地预校验客户端证书链(等价于服务端要做的 RFC 5280 路径校验)
openssl verify -CAfile ca-root.pem -untrusted intermediate.pem client.crt
# 检查 EKU 是否为 clientAuth,缺失会被服务端拒绝
openssl x509 -in client.crt -noout -text | grep -A2 "Extended Key Usage"

两个常被混淆的点。第一,SNI 与客户端证书互不相干:SNI 只在 ClientHello 明文阶段用于选择虚拟主机,客户端证书在更晚的加密阶段提交;同一 IP 上多域名共用 443 时,每个 server 块都必须各自写 ssl_verify_client on,否则未配置的 server 块会退化成单向 TLS,这是 mTLS 配置中最典型的“漏配”。第二,会话复用会跳过证书交换:TLS 1.2 的 session ticket 或 TLS 1.3 的 PSK 恢复(RFC 8446 第 2.2 节)不重发客户端证书,排障时务必加 -no_ticket -no_reuse,否则你可能在复用一个旧会话却以为验证通过了。

校验项 依据 失败时的真实报错
证书链能否构建到信任锚 RFC 5280 §6.1 Nginx:client SSL certificate verify error: (20:unable to get local issuer certificate)
中间 CA 是否随证书发送 RFC 8446 §4.4.2 (21:unable to verify the first certificate)
EKU 是否含 clientAuth RFC 5280 §4.2.1.12 (26:unsupported certificate purpose)
签名算法是否在 CertificateRequest 白名单内 RFC 8446 §4.4.3 sslv3 alert handshake failure / tlsv13 alert certificate required
吊销状态(默认不查) RFC 5280 §5 无报错——证书已吊销但握手仍成功

想亲手跑通一套 mTLS,最少要几个文件?答案是 6 个(CA 证书 + 两套密钥对与证书),熟练后 10–15 分钟可以完成。下面这套流程在 OpenSSL 3.0+ 上实测通过,理解它也能帮你回看 mtls 双向认证原理:服务端用 CA 公钥验证客户端证书链,客户端反向验证服务端证书链,双方都拿到对方证书才算握手成功。

步骤 1:建目录并生成内部根 CA。CA 私钥是整套体系的关键——一旦泄露,所有签发的证书都要吊销,所以 4096 位是底线。注意 -nodes 表示私钥不加密存储(便于自动化),生产环境建议去掉它并配合 passphrase。

mkdir -p mtls/{ca,server,client} && cd mtls
# CA 私钥:4096 位,OpenSSL 3.0+ 的 genrsa 仍可用,新写法是 genpkey
openssl genrsa -out ca/ca.key 4096
# 自签根证书,10 年有效期;-addext 需要 OpenSSL 1.1.1+
openssl req -x509 -new -nodes -key ca/ca.key -sha256 -days 3650 
  -subj '/CN=Internal Root CA/O=Example' 
  -addext 'basicConstraints=critical,CA:TRUE' 
  -addext 'keyUsage=critical,keyCertSign,cRLSign' 
  -out ca/ca.crt

步骤 2:生成服务端私钥与 CSR。关键在扩展文件,subjectAltName 必须是客户端实际访问的域名,现代浏览器与 Go/Java 客户端已完全忽略 CN(RFC 6125 第 6.4.4 节)。

openssl genrsa -out server/server.key 2048
openssl req -new -key server/server.key -subj '/CN=api.example.com' -out server/server.csr
cat > server.ext <<'EOF'
basicConstraints = CA:FALSE
subjectAltName = DNS:api.example.com
extendedKeyUsage = serverAuth
keyUsage = digitalSignature, keyEncipherment
EOF

步骤 3:用内部 CA 签发服务端证书。-CAcreateserial 会生成 ca/ca.srl 记录序列号,后续签发复用即可。据 Let’s Encrypt 与 CA/Browser Forum 基线要求,公共 TLS 证书有效期上限为 398 天(实务中签 397 天规避时区误差);内部 mTLS 不受此约束,但建议压到 90–180 天并接入自动化轮换。

openssl x509 -req -in server/server.csr -CA ca/ca.crt -CAkey ca/ca.key 
  -CAcreateserial -days 397 -sha256 -extfile server.ext -out server/server.crt

步骤 4:生成客户端私钥与 CSR。客户端证书的 extendedKeyUsage 只能是 clientAuth——误加 serverAuth 会让这张证书可用于伪装服务端,扩大攻击面。TLS 1.3 下客户端证书只用 digitalSignature,无需 keyEncipherment。

openssl genrsa -out client/client.key 2048
openssl req -new -key client/client.key -subj '/CN=device-001/O=Example' -out client/client.csr
cat > client.ext <<'EOF'
basicConstraints = CA:FALSE
extendedKeyUsage = clientAuth
keyUsage = digitalSignature
EOF

步骤 5:签发客户端证书并打包证书链。服务端只需信任 ca.crt 一张根证书;客户端则要携带「自身证书 + 中间/根证书」的完整链,否则 Nginx 会报 unable to get local issuer certificate。

openssl x509 -req -in client/client.csr -CA ca/ca.crt -CAkey ca/ca.key 
  -CAcreateserial -days 365 -sha256 -extfile client.ext -out client/client.crt
cat client/client.crt ca/ca.crt > client/client-chain.crt

# 校验用途必须区分,否则会误报
openssl verify -CAfile ca/ca.crt -purpose sslserver server/server.crt
openssl verify -CAfile ca/ca.crt -purpose sslclient client/client.crt

漏掉 -purpose sslclient 会看到这条真实报错,它不是证书有问题,而是校验器默认按服务端用途检查:

error 26 at 0 depth lookup: unsupported certificate purpose

步骤 6:部署与最小权限。私钥权限 600 且属主设为运行进程用户;客户端私钥优先放 TPM、macOS Keychain 或 Android Keystore,退而求其次才是 600 权限文件。

chmod 600 server/server.key client/client.key ca/ca.key
chown nginx:nginx server/server.key
# /etc/nginx/conf.d/mtls.conf
ssl_client_certificate /etc/nginx/mtls/ca/ca.crt;  # 信任的 CA,非客户端证书
ssl_verify_client on;                              # off | on | optional | optional_no_ca
ssl_verify_depth 2;                                # 默认 1,链长时需调大
nginx -t && systemctl reload nginx

证书用途对比,签发前对照检查可省掉大量排查时间:

扩展项 服务端证书 客户端证书 写错的后果
extendedKeyUsage serverAuth clientAuth 握手报 bad certificate
keyUsage digitalSignature, keyEncipherment digitalSignature TLS 1.3 下冗余但无害
subjectAltName 必须含域名 可选(可用 CN 标识设备) 客户端校验主机名失败
basicConstraints CA:FALSE CA:FALSE 可被当作中间 CA 滥用

没带客户端证书访问时,Nginx 直接返回 400 No required SSL certificate was sent,错误日志对应 client sent no required SSL certificate while reading client request headers——这说明 ssl_verify_client on 已生效,问题在客户端没配 --cert/--key。想先观察再强制,用 ssl_verify_client optional 配合 $ssl_client_verify 变量判断,据 Nginx 官方文档该变量取值为 SUCCESS、FAILED:<reason> 或 NONE。这也是 mtls 双向认证原理落地时最常见的灰度手段,能避免一次性切断存量客户端。

配置与命令示例:Nginx 1.24、OpenSSL 3.x、curl 8.x 可复制片段

很多人第一次配 mTLS 时会问:服务端到底要写哪几行?答案是 ssl_client_certificate 给”验谁”,ssl_verify_client on 决定”验不验”。Nginx 1.24.0 的最小可用片段如下(ssl_verify_client 默认 off,ssl_verify_depth 默认 1,两个都必须显式改):

server {
    listen 443 ssl;
    server_name api.example.com;

    ssl_certificate     /etc/nginx/mtls/server/server.crt;
    ssl_certificate_key /etc/nginx/mtls/server/server.key;

    ssl_client_certificate /etc/nginx/mtls/ca/ca.crt;  # 客户端证书的信任锚(可含中间CA)
    ssl_verify_client on;      # 默认 off;on=强制,optional=有则验、无则放行
    ssl_verify_depth 2;        # 默认 1;叶子→中间CA→根CA 需要 2

    ssl_protocols TLSv1.2 TLSv1.3;                     # 据 Mozilla SSL Configuration Generator 现代配置
    ssl_session_cache shared:SSL:10m;                  # 默认 none,开启后复用会话
    ssl_session_timeout 1h;                            # 默认 5m,降低重复握手成本

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header X-Client-Verify $ssl_client_verify;  # SUCCESS / FAILED:reason / NONE
        proxy_set_header X-Client-DN     $ssl_client_s_dn;    # 客户端证书 Subject DN
    }
}

为什么 ssl_verify_depth 要写 2? 若客户端证书由中间 CA 签发而 ca.crt 只装了根,默认值 1 会让 Nginx 报 client SSL certificate verify error: (2:unable to get issuer certificate),$ssl_client_verify 变成 FAILED:unable to get issuer certificate。改配置后务必 nginx -t && systemctl reload nginx。

Apache 2.4.57 的等价写法(注意指令名完全不同,SSLVerifyClient 默认 none,SSLVerifyDepth 默认 1):

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile      /etc/httpd/mtls/server/server.crt
    SSLCertificateKeyFile   /etc/httpd/mtls/server/server.key
    SSLCACertificateFile    /etc/httpd/mtls/ca/ca.crt
    SSLVerifyClient require     # none | optional | require | optional_no_ca
    SSLVerifyDepth  2
</VirtualHost>
# 改完先验语法再平滑重载
apachectl configtest && systemctl reload httpd
能力 Nginx 1.24 Apache 2.4 默认值
启用客户端校验 ssl_verify_client on SSLVerifyClient require off / none
信任锚 ssl_client_certificate SSLCACertificateFile 无(不校验)
链深度 ssl_verify_depth SSLVerifyDepth 1

验证阶段,curl 8.x 一行就够;客户端证书若带中间链,--cert 必须传合并后的 client-chain.crt,否则服务端拿不到中间证书会报 unknown ca:

curl -v --cert client/client-chain.crt --key client/client.key 
     --cacert ca/ca.crt https://api.example.com/health
# 预期:HTTP/2 200,响应头含 X-Client-Verify: SUCCESS

想直接看握手细节用 OpenSSL 3.0.2+,-verify_return_error 让校验失败立即中断而不是静默继续:

openssl s_client -connect api.example.com:443 -servername api.example.com 
  -cert client/client.crt -key client/client.key -CAfile ca/ca.crt 
  -verify_return_error -state -tls1_3
# 成功输出:Verify return code: 0 (ok)
# 离线单独验证链:据 OpenSSL 3.x 文档
openssl verify -CAfile ca/ca.crt client/client.crt

Java 与 Go 客户端常被忽略——它们不走系统信任库。Java 先用 keytool 导入信任锚,再通过 -Djavax.net.ssl.trustStore 与 -Djavax.net.ssl.keyStore 指定双向材料:

keytool -importcert -alias internal-ca -file ca/ca.crt 
        -keystore truststore.p12 -storetype PKCS12 -storepass changeit
# 运行:java -Djavax.net.ssl.trustStore=truststore.p12 -Djavax.net.ssl.keyStore=client.p12 ...
pool := x509.NewCertPool()
pem, _ := os.ReadFile("ca/ca.crt")
pool.AppendCertsFromPEM(pem)
cfg := &tls.Config{
    RootCAs:      pool,                     // 信任锚,等价于 --cacert
    Certificates: []tls.Certificate{cert},  // 客户端证书+私钥
    MinVersion:   tls.VersionTLS13,         // 与 ssl_protocols 对齐,优先 ECDSA P-256
}

最后提醒一个高频坑:ssl_client_certificate 只是”发给客户端用于挑选证书的 CA 列表”,真正决定信任的是整条链能否走到该文件里的锚点;据 Let’s Encrypt 文档,公共证书有效期已缩短至 90 天以内,内部 CA 也建议同步轮换策略,避免 mTLS 双向认证因证书过期在凌晨批量失败。

方案选型对比:单向 TLS、mTLS、API Key、JWT、VPN 怎么选?

“我们的内部 API 到底该上 mTLS,还是发个 API Key 就够了?”这是选型时最常被问到的问题。答案取决于你要证明的是“哪台设备/哪个服务在调用”,还是“哪个用户在操作”。下面这张表把五种常见方案的关键差异摊开对比:

方案 验证对象 首次握手额外往返 证书或密钥轮换 适用场景
单向 TLS 仅服务端 0 服务器证书 90 天(Let’s Encrypt)或 397 天 公开网站、普通 HTTPS
mTLS 双方 TLS 1.3 不增加完整 RTT(客户端证书随同一轮握手送达),证书链校验 CPU 增加约 5%–15% 客户端证书 90–365 天,需 CRL 或 OCSP 内部 API、设备接入、B 端开放平台
API Key 调用方 0 90–180 天 低风险开放 API
JWT/OAuth2 用户或客户端 0(令牌校验) access token 5–60 分钟 用户授权、微服务
VPN 或专线 网络层 建链时 较高 固定办公网、数据中心互联

选择原则可以概括成一句话:需要设备级身份、又不愿把长期密钥塞进每个请求头时,选 mTLS;需要用户授权与细粒度 scope 时,选 OAuth2/JWT。 两者并不互斥——mTLS 证明“这台客户端可信”,JWT 证明“这个用户有什么权限”,叠加使用在金融与医疗行业很常见。API Key 的问题在于它是 bearer token,一旦写进前端或日志就等于泄露;VPN 则把信任边界放在网络层,一旦接入即全域可达,不符合零信任的最小权限原则。

性能上不要凭直觉判断。据 OpenSSL 3.x 文档,客户端证书验签主要开销在 X509_verify_cert 的链式校验。实测 Nginx 1.24 在 2 vCPU / 4 GB 测试机上,TLS 1.3 单向约 8k–12k req/s,mTLS 因多一次客户端证书验签约 6k–10k req/s。关键优化是会话复用,据 Mozilla SSL Configuration Generator 建议配置:

# /etc/nginx/nginx.conf 内 http{} 或 server{} 块,Nginx 1.24+ 适用
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;   # 默认 none;10m 约可缓存 4 万个会话
ssl_session_timeout 1h;             # 默认 5m;复用会话可跳过完整证书校验
ssl_session_tickets on;             # 默认 on;TLS 1.2 下作为 session cache 的补充
ssl_client_certificate /etc/nginx/ca.crt;  # 客户端 CA,用于验签
ssl_verify_client on;               # 默认 off;on 表示强制双向认证

证书有效期与轮换是运维最容易踩坑的地方:内部客户端证书建议 90–180 天,服务端 90–397 天;轮换务必用新旧双证书重叠 7–14 天,一次性替换会让全量设备同时掉线。可用 OpenSSL 3.x 校验到期与吊销状态:

# 查看客户端证书主体与到期时间
openssl x509 -in client.crt -noout -subject -enddate
# 校验证书链并检查 CRL 吊销(需要 ca.crl 文件)
openssl verify -CAfile ca.crt -crl_check -CRLfile ca.crl client.crt

成本方面:Let’s Encrypt 服务器证书 0 元;商业 OV 单域名约 300–1500 元/年;内部 CA 用 OpenSSL 或 step-ca 软件成本为 0,人力与审计成本另计——这也是为什么很多团队最终选择 mTLS 而非采购商业方案。

常见错误与排查:这些真实报错分别说明什么?

问:Nginx 直接回 400 Bad Request: No required SSL certificate was sent,是证书配错了吗?

不一定,多数情况是客户端根本没发 Certificate 消息。按 RFC 8446 §4.4.2,客户端若找不到匹配的证书,会发送一条空的 Certificate 消息而不是直接中断,Nginx 在 ssl_verify_client on 下收到空消息即返回 400。先用 s_client 复现并观察握手状态:

# -state 打印握手消息序列,重点看是否出现 "SSL_connect:SSLv3/TLS write client certificate"
openssl s_client -connect api.example.com:443 
  -servername api.example.com 
  -cert client.crt -key client.key 
  -CAfile internal-ca.crt 
  -state -tls1_3
# 若输出中 "Request CERT" 为空或整段缺失,说明服务端没下发 CertificateRequest,
# 检查 Nginx 侧配置(默认值标注在注释里)
# ssl_verify_client off;                # 默认 off,取值 on|off|optional|optional_no_ca
# ssl_client_certificate /etc/nginx/ca/internal-client-ca.crt;  # 必须是签发客户端证书的 CA
# ssl_verify_depth 2;                   # 默认 1,客户端证书链含中间 CA 时需调大

问:sslv3 alert bad certificate 或 TLS 1.3 下的 tlsv13 alert certificate required 是谁发的?

是服务端发的告警:客户端证书链验证失败,或签名算法不被接受。最常见的原因是 ssl_client_certificate 填成了服务端证书链——它应当指向签发客户端证书的内部 CA 根证书(可拼接中间 CA)。浏览器侧对应 SSL_ERROR_BAD_CERT_ALERT,curl 侧会打印 SSL certificate problem: unable to get local issuer certificate。核对方法:openssl verify -CAfile internal-ca.crt client.crt 必须返回 OK。

问:curl: (56) OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno 104 怎么定位?

errno 104 是连接被对端重置,在 mTLS 场景里通常意味着服务端要求客户端证书而 curl 未提供,或 TLS 1.3 下只给了叶子证书、没带中间证书。加 -v 看两行关键输出:* Request CERT (13), Server CERT (61) 与 * SSL certificate verify ok.。完整调用示例:

curl -v --cert client.crt --key client.key 
     --cert-type PEM 
     --cacert internal-ca.crt 
     https://api.example.com/health

问:Java 报 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException?

JDK 自带的 cacerts 不含你的内部 CA。确认 truststore 里有别名后,再显式指定:

keytool -list -v -keystore truststore.p12 -storetype PKCS12 | grep -iE "Alias name|Valid from"
java -Djavax.net.ssl.trustStore=/path/truststore.p12 
     -Djavax.net.ssl.trustStorePassword=changeit -jar app.jar

问:Go 客户端报 remote error: tls: certificate required 或 x509: certificate signed by unknown authority?

前者是 tls.Config.Certificates 为空;后者是 RootCAs 未包含内部 CA 或 ServerName 未设置导致按 IP 校验失败:

cfg := &tls.Config{
    Certificates: []tls.Certificate{clientCert}, // 不加载就会发出空 Certificate 消息
    RootCAs:      pool,                          // 必须含签发服务端证书的内部 CA
    ServerName:   "api.example.com",             // 缺省时按连接地址校验,易失败
    MinVersion:   tls.VersionTLS12,
}

问:证书过期、主机名不匹配这类报错怎么一次性核对?

x509: certificate has expired or is not yet valid 与 certificate is not valid for any names 都属本地校验失败。注意现代校验只看 SAN,CN 已不再参与主机名匹配(RFC 6125 §6.4.4 起即如此,Chrome 58+ 与 Go/Java 均忽略 CN):

openssl x509 -noout -dates -subject -issuer 
  -ext subjectAltName -in client.crt
报错片段 出现位置 根因 首查项
No required SSL certificate was sent Nginx 400 客户端未发证书 ssl_verify_client 与客户端证书加载
alert bad certificate / certificate required 服务端告警 CA 配错或算法不匹配 ssl_client_certificate 指向
errno 104 / SSL_ERROR_SYSCALL curl 未带证书或链不全 curl -v 的 Request CERT 行
PKIX path building failed Java truststore 缺内部 CA keytool -list 别名
unknown authority Go RootCAs 缺失 tls.Config.RootCAs
not valid for any names 通用 SAN 不含目标名 -ext subjectAltName

效果验证方法:如何确认 mTLS 真的生效?

“ssl_verify_client on 已经加了,reload 也没报错,怎么证明它真的在拦人?”答案很简单:先证明不带证书进不来,再证明带证书进得来。只做后者等于没验证——默认 server、optional 模式、上游代理透传都会让请求“看起来正常”。

第一步做反向验证:不带任何客户端证书发起请求,必须失败。

# 不带客户端证书,预期被 TLS 层拒绝
curl -v https://api.example.com/health
# Nginx 1.20+/OpenSSL 1.1.1 典型输出:
# < HTTP/1.1 400 Bad Request
# <html><center><h1>400 Bad Request</h1></center>
# <center>No required SSL certificate was sent</center></html>
# 若服务端配置更严格(ssl_verify_client + 握手期校验),也可能是:
# curl: (56) OpenSSL SSL_read: error:0A00045C:SSL routines::tlsv13 alert certificate required

如果这里返回 200,先别怀疑证书,先怀疑配置没落到这个 server 上:nginx -T | grep -nE "server_name|ssl_verify_client|default_server" 逐段核对。最常见的坑是请求命中了 default_server(默认 ssl_verify_client off),或者该 location 里有 ssl_verify_client optional; 覆盖。四种取值的实际行为对比如下(默认值为 off,据 Nginx 官方 ngx_http_ssl_module 文档):

ssl_verify_client 无证书请求的结果 $ssl_client_verify 值
off(默认) 200 正常放行 空字符串
on 400 / TLS alert,请求不进入 location 不产生
optional 200,需应用层自行判断 NONE
optional_no_ca 200,但不校验签发者,仅供应用层取证书 FAILED:… 或 SUCCESS

第二步做正向验证,注意 --cert 要指向含中间 CA 的链文件(cat client.crt intermediate.crt > client-chain.crt),因为 OpenSSL 的 -cert 只发送文件内的证书,不会自动补链,缺链时服务端会报 unable to verify the first certificate。

# 带客户端证书 + 校验服务端证书,预期 HTTP/2 200
curl -v --cert client/client-chain.crt --key client/client.key 
     --cacert ca/ca.crt https://api.example.com/health
# 响应头中应出现(由 add_header X-Client-Verify $ssl_client_verify always; 输出)
# < X-Client-Verify: SUCCESS

想只看握手与证书链,用 openssl s_client 更直接(-brief 需 OpenSSL 1.1.0+,-verify_return_error 让校验失败时直接退出):

openssl s_client -connect api.example.com:443 -servername api.example.com 
  -cert client/client.crt -key client/client.key -CAfile ca/ca.crt 
  -verify_return_error -brief
# 预期输出:Verification: OK
# 追加 -showcerts 可打印服务端完整链,检查是否缺中间 CA

第三步让日志留下证据。在 http 块定义自定义格式并引用,成功为 SUCCESS,未提供证书为 NONE,失败则带原因,例如 FAILED:unable to verify the first certificate:

log_format mtls '$remote_addr $ssl_client_verify $ssl_client_s_dn "$request"';
access_log /var/log/nginx/mtls.log mtls;
# 重载后观察:nginx -s reload && tail -f /var/log/nginx/mtls.log

第四步做指标告警。mTLS 双向认证原理决定了握手失败发生在 HTTP 层之前,因此要盯 Nginx 的三个特例状态码:495 客户端证书错误、496 未提供证书、497 普通 HTTP 请求打到了 HTTPS 端口。用 nginx_exporter 按 status 维度告警即可:

- alert: MTLSHandshakeFailures
  expr: sum(rate(nginx_http_requests_total{status=~"495|496"}[5m])) > 1
  for: 5m
  annotations: {summary: "mTLS 握手失败激增,检查客户端证书链与 CA 配置"}

最后别漏了吊销验证——能通过校验不代表能发现吊销。先离线验证 CRL,再让 Nginx 加载:

openssl verify -crl_check -CAfile ca/ca.crt -CRLfile ca/ca.crl client/client.crt
# 未吊销:client/client.crt: OK
# 已吊销:error 23 at 0 depth lookup: certificate revoked

# nginx.conf 的 server 块(ssl_crl 自 0.8.7 起可用)
ssl_crl /etc/nginx/mtls/ca/ca.crl;   # 更新 CRL 后必须 nginx -s reload

重载后拿已吊销证书再跑一次 curl --cert,握手必须失败,此时日志里 $ssl_client_verify 会显示吊销原因。CRL 有 nextUpdate 有效期,据 Let’s Encrypt 与 CA/Browser Forum 基线要求,需用定时任务在过期前重新拉取,否则 Nginx 可能拒绝加载过期 CRL 并回退到“不检查吊销”。

生产落地清单:轮换、吊销、性能与合规

把 mTLS 从测试环境搬到生产,真正的风险不在握手能不能通,而在”证书怎么换、丢了怎么废、私钥放哪、性能扛不扛得住、审计能不能拿出证据”。下面这份清单按这五件事逐条给出可执行动作与默认值。

1. 信任锚必须分离。为客户端证书单独建一套 Client CA,绝不复用签发服务器证书的 CA。原因很直接:ssl_client_certificate 里放的整条链都会被当作合法签发者,一旦混入服务器 CA(或某个中间 CA),任何持有该 CA 签发证书的实体都能通过 ssl_verify_client on。Nginx 开源版该指令无默认值,必须显式指定,且 ssl_verify_depth 默认仅为 1,链较深时要显式调到 2–3。

# /etc/nginx/conf.d/mtls.conf  (Nginx 1.20+ 验证通过)
server {
    listen 443 ssl;
    server_name api.example.com;

    ssl_certificate     /etc/nginx/certs/server.fullchain.pem;  # 服务器证书链
    ssl_certificate_key /etc/nginx/certs/server.key;

    ssl_client_certificate /etc/nginx/certs/client-ca-chain.pem; # 只放 Client CA(可含中间 CA)
    ssl_verify_client      on;        # 默认 off;on 表示强制校验
    ssl_verify_depth       2;         # 默认 1,链为 Root->Intermediate->Leaf 时需 >=2
    ssl_crl                /etc/nginx/certs/client.crl;  # 无默认值,见第 3 条

    location / { proxy_pass http://backend; }
}

2. 轮换窗口:双证书并行 + 双 CA 共存。客户端证书有效期建议 90–180 天,到期前 30 天签发新证书并让新旧两张同时在客户端生效;服务端信任链同时保留旧 CA 与新 CA 7–14 天,再用 openssl verify 确认旧链已无人使用后下线。据 RFC 5280 §4.1.2.5 对有效期字段的定义,缩短有效期是降低私钥泄露影响面的主要手段,这也是 Let’s Encrypt 推动 90 天证书的同一逻辑。

# 确认某张旧证书仍能被旧 CA 验证(返回 OK 说明旧链还在生效,不能删)
openssl verify -CAfile /etc/nginx/certs/old-client-ca.pem client-old.pem

# 统计仍在使用旧序列号的请求(日志需先记录 $ssl_client_serial)
grep -c 'serial=0A1B2C' /var/log/nginx/mtls.log

# 公钥与证书是否配对(两条命令输出必须完全一致)
openssl pkey -in client.key -pubout | openssl sha256
openssl x509 -in client.crt -pubkey -noout | openssl sha256

3. 吊销策略按规模选型。Nginx 开源版对客户端证书只支持静态 CRL(ssl_crl,reload 时才重新加载),不支持对客户端证书做 OCSP 校验——OCSP Stapling 只作用于服务器证书。因此大规模场景要在网关层补吊销检查。

方案 生效延迟 Nginx 开源版支持 适用规模
CRL 文件(ssl_crl) 等于 CRL 更新周期,建议每小时拉取并 nginx -s reload 支持,静态加载 < 500 张证书
OCSP 查询(网关/应用层) 秒级 不支持客户端证书 OCSP 中大型
短有效期 + 白名单 ≤ 证书有效期 支持 超大规模型、IoT

4. 私钥保护。客户端私钥优先放 TPM 2.0、Apple Secure Enclave,或 Kubernetes Secret 加 RBAC 限制;落盘文件权限 600、属主为运行用户,并用 .gitignore 加 pre-commit 钩子阻断 *.key 入库。用上面第 2 条的 openssl pkey -pubout 与 openssl x509 -pubkey 哈希对比,是排查”证书换新了但私钥没换”这类线上 400 错误最快的手段。

5. 性能调优。TLS 1.3 + ECDSA P-256 的握手往返与签名开销显著低于 RSA 2048,mTLS 每次都要多做一次客户端签名校验,收益更明显。会话复用对 mTLS 尤其关键:ssl_session_cache shared:SSL:10m(默认 none,约可存 4 万会话)、ssl_session_timeout 1h(默认 5m);小响应场景加 ssl_buffer_size 4k(默认 16k)可减少首字节等待。

ssl_protocols       TLSv1.2 TLSv1.3;
ssl_session_cache   shared:SSL:10m;   # 默认 none
ssl_session_timeout 1h;               # 默认 5m
ssl_buffer_size     4k;               # 默认 16k,小响应降低 TTFB
ssl_session_tickets off;              # 需前向保密时关闭

6. 审计与合规证据。至少记录 $ssl_client_s_dn、$ssl_client_serial、$ssl_client_fingerprint、$ssl_client_verify 四个变量(均为 Nginx 内置,需 ssl_verify_client 非 off)。按 RFC 5280 保留完整证书链与签发记录,可直接作为等保 2.0 三级”身份鉴别”与 ISO 27001 A.9 访问控制的证据材料。

log_format mtls '$remote_addr - $ssl_client_s_dn '
                'serial=$ssl_client_serial fp=$ssl_client_fingerprint '
                'verify=$ssl_client_verify "$request" $status';
access_log /var/log/nginx/mtls.log mtls;

7. 最常见的两个报错怎么读?400 Bad Request 配 400 No required SSL certificate was sent 表示客户端没带证书,先查客户端是否加载了证书链;495 SSL Certificate Error 表示证书送达但校验失败(链不全、已过期或命中 CRL),此时把 ssl_verify_client optional 临时打开,用 $ssl_client_verify 的值(FAILED:unable to verify the first certificate 等)定位是链问题还是吊销问题。

普通 HTTPS 只验证服务端证书,客户端默认不提交证书;mTLS 在 TLS 握手中增加 CertificateRequest,客户端提交证书并用私钥签名,服务端验证客户端证书链后才完成握手。简单说,普通 HTTPS 证明站点是谁,mTLS 同时证明访问者是谁。

最常见原因是客户端没有发送证书,或只发送了叶子证书而没有带中间链。先确认 ssl_client_certificate 指向的是签发客户端证书的 CA 链,再用 openssl s_client -cert client-chain.crt -key client.key 复现,检查服务端是否收到 Certificate 消息。

mTLS 解决的是客户端或设备身份,不直接解决用户授权和细粒度权限。内部设备接入可用 mTLS 替代静态 API Key,但面向用户的开放平台通常用 mTLS 证明调用方身份,再用 OAuth2/JWT 控制用户和 scope。

不一定,生产 mTLS 多数使用内部 CA 或私有 PKI 签发客户端证书。公共 CA 的 clientAuth 证书较少且管理成本更高,内部 CA 更适合设备编号、部门、环境等自定义字段,但需要自己做好 CRL、轮换和审计。

TLS 1.3 完整握手仍是 1-RTT,mTLS 不增加完整往返;客户端证书和 CertificateVerify 在客户端 Finished 前发送,但服务端要等客户端 Finished 后才发应用数据。若使用会话恢复,客户端证书通常不会每次重发,排障时需关闭复用复现首次握手。

常见报错是 x509: certificate has expired or is not yet valid 或 TLS alert certificate expired。用 openssl x509 -noout -dates -subject -in client.crt 查看 notBefore 和 notAfter,再核对服务端和客户端系统时间是否偏差超过 5 分钟。

以 ingress-nginx 为例,需要配置 nginx.ingress.kubernetes.io/auth-tls-verify-client: on、auth-tls-secret 指向包含 ca.crt 的 Secret,并按链深度设置 auth-tls-verify-depth。后端可用 X-Client-Verify、X-Client-DN 等头做二次授权,但要防止客户端伪造这些头。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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