CSR 在线生成怎么做?WebCrypto 原理、OpenSSL 命令对照与报错排查
CSR 在线生成指的是在浏览器里用 WebCrypto 生成密钥对并导出 PKCS#10 请求文件(RFC 2986),私钥不出本机、单次生成通常不到 1 秒,产出的 .csr 交给 CA 即可签发证书。 判断工具是否安全只看一处:打开 DevTools → Network,提交时请求体里不应出现 "-----BEGIN PRIVATE KEY-----",出现即说明私钥被上传到服务端。 SAN 是必填项,Chrome 58(2017-04)起忽略 CN;命令行写法为 openssl req -new -addext "subjectAltName=DNS:example.com,DNS:www.example.com",需 OpenSSL 1.1.1 及以上。 密钥规格建议 RSA 2048 位(CA/Browser Forum 自 2014 年起的最低要求)或 ECDSA P-256,签名算法 sha256WithRSAEncryption,SHA-1 自 2016 年起被主流 CA 停发。 两条命令即可自检:openssl req -in example.com.csr -noout -verify 输出 "self-signature verify OK",再比对 openssl pkey -pubout 与 openssl req -pubkey 的 SHA-256 指纹是否一致。
为什么“CSR 在线生成”容易踩坑:问题背景与根本原因
“把 CSR 交给 CA,会不会把私钥一起交出去?”不会。CSR 的格式是 PKCS#10(由 RFC 2986 定义),里面只有四样东西:主体公钥、Subject DN、扩展请求(SAN、EKU 等),以及一段用对应私钥做的自签名——自签名的作用只是证明“我确实持有这把私钥”。私钥永远不进入 CSR,所以风险并不在“提交”环节,而是全部集中在“生成”环节:密钥对在谁的机器上生成、页面有没有被篡改、参数是否满足 CA 的准入规则。
根因一:页面名义上是在线生成,实际由服务端代生成。部分工具在你点击“生成”时,会把浏览器刚生成的私钥和表单一起 POST 到后端。判断方法很直接:按 F12 打开 Network 面板,重新提交一次,查看该请求的 Form Data / Payload,只要出现 -----BEGIN PRIVATE KEY-----,就说明私钥已经离开你的设备,应立即弃用并重新生成密钥对。
根因二:页面走 HTTP,或者 HTTPS 缺失 HSTS。此时中间人可以替换页面 JS,让“本地生成”变成“上传生成”。检查两点:地址栏证书主体是否为该工具域名;响应头是否带 HSTS。据 Mozilla 的 MDN 文档,max-age=31536000 是一年,是最常见的推荐值。
# 检查目标站点是否下发 HSTS(任意 curl 7.x 均可)
curl -sI https://tool.example.com/ | grep -i strict-transport-security
# 期望:strict-transport-security: max-age=31536000; includeSubDomains
# 无输出 = 未启用 HSTS,降级/替换 JS 的风险显著上升
根因三:只填 CN,不填 SAN。Chrome 58(2017 年)起不再回退到 CN 匹配,Safari 同样处理。结果是 CA 正常签发,浏览器却报 NET::ERR_CERT_COMMON_NAME_INVALID,这是运维群里最高频的“证书装了却打不开”。据 Let’s Encrypt 文档,其签发的证书一律以 SAN 为准,CN 字段已不再作为匹配依据。
根因四:RSA 1024 位或 SHA-1 签名。CA/Browser Forum 的 Baseline Requirements 要求 RSA 密钥不低于 2048 位(2014 年起生效),SHA-1 证书自 2016 年起被主流浏览器拒绝。这类 CSR 在 CA 端会直接被拒,ACME 场景下通常返回 urn:ietf:params:acme:error:badCSR(key too small),而不是等到部署时才暴露。
根因五:CSR 与私钥不配对。常见于 A 机器生成 CSR、B 机器生成私钥。部署时 Nginx 直接起不来:SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),只能重签,白白消耗一次签发额度。
# 一条命令看清 CSR 里到底有什么(OpenSSL 1.1.1+ 实测输出)
openssl req -in example.csr -noout -text
# Subject: CN = example.com ← 只有 CN 不够
# Public-Key: (2048 bit) ← 低于 2048 会被 CA 拒绝
# Signature Algorithm: sha256WithRSAEncryption ← 出现 sha1WithRSAEncryption 直接作废
# X509v3 Subject Alternative Name: DNS:example.com ← 必须存在,否则浏览器报 CN 不匹配
# 比对 CSR 与私钥的公钥指纹,两行必须完全一致
openssl req -in example.csr -noout -pubkey | openssl sha256
openssl pkey -in example.key -pubout | openssl sha256
# OpenSSL 1.0.x 无 pkey 子命令时改用:openssl rsa -in example.key -pubout | openssl sha256
| 根因 | 现场表现 / 真实报错 | 一条判定命令 |
|---|---|---|
| 服务端代生成,私钥被 POST | Payload 中出现 -----BEGIN PRIVATE KEY----- |
F12 → Network → 请求 Payload |
| HTTP 或无 HSTS | JS 可被中间人替换 | curl -sI https://… | grep -i strict-transport-security |
| 只填 CN 无 SAN | NET::ERR_CERT_COMMON_NAME_INVALID |
openssl req -text | grep DNS: |
| RSA 1024 / SHA-1 | CA 端 badCSR(key too small) |
openssl req -text | grep -E "Public-Key|Signature Algorithm" |
| CSR 与私钥不配对 | Nginx key values mismatch |
比对两侧公钥 SHA-256 指纹 |
把上表当成提交前的四项检查:确认私钥没离开浏览器、页面有 HSTS、SAN 已写入、位长与签名算法达标——这四点决定了“csr 在线生成”到底是省事,还是把问题推迟到部署当天才暴露。
在线生成 CSR 的完整操作步骤(8 步)
把 CSR 在线生成拆成 8 步,前 2 步完全在本地完成,中间 3 步在浏览器里操作,最后 3 步回到命令行核验。CSR 的格式由 RFC 2986(PKCS#10)规定,所以任何工具产出的内容都应能被 OpenSSL 直接解析——这一点正是下面自检命令有效的前提。
- 建目录、收紧权限。默认 umask 通常是 022,新建文件是 644,同机其他用户可读,先改掉。
- 选密钥类型,勾选”包含 SAN / 多域名”。这一步决定了后面所有命令的参数,事后无法改,只能重签。
- 填写主题信息。C=CN、ST=Zhejiang、L=Hangzhou、O=Example Co., Ltd.、CN=example.com,CN 写主域名。注意 RFC 5280 规定 CN 上限 64 字节,超长会直接报错:
error:0D07A780:asn1 encoding routines:ASN1_mbstring_ncopy:string too long:maxsize=64。 - 填 SAN。至少包含 CN 本身、
www子域和实际要覆盖的域名。泛域名写DNS:*.example.com,它只覆盖一级,匹配a.example.com但不匹配a.b.example.com。对应的完整命令(OpenSSL ≥ 1.1.1,-addext为 1.1.1 新增;-nodes在 3.x 中等价于-noenc,表示私钥不加密): - 点生成后先看结果区。必须出现
-----BEGIN CERTIFICATE REQUEST-----与-----END CERTIFICATE REQUEST-----。再确认工具是否允许导出私钥:如果只能下载 CSR,说明密钥对在服务端生成——按 MDN Web Crypto API 文档,generateKey()的extractable参数为false时私钥不可导出,浏览器端的 CSR 在线生成工具若这样配置,你就永远拿不到私钥,等于把密钥托管给了对方,直接换工具。 - 立即保存两个文件。私钥
example.com.key建议离线保管或放进 KMS/HSM,绝不能放在 web 根目录;CSR 可明文存档,便于日后比对。落盘后再确认一次权限: - 提交给 CA。把 .csr 全文粘贴到下单页或上传文件。按 Let’s Encrypt 与主流 CA 的公开说明,DV 证书通常 1–10 分钟签发,OV 需人工核验企业资料约 1–3 个工作日,EV 约 3–7 个工作日。提交前先跑一遍第 8 步的自检。
- 签发后先做匹配性校验再部署。两串公钥指纹必须一致:
# 目录权限一步到位:700,仅当前用户可进入
mkdir -p -m 700 ~/csr/example.com && cd ~/csr/example.com
# umask 077 让本会话新建的文件默认 600、目录默认 700;只对当前 shell 生效
umask 077
| 选项 | OpenSSL 等价参数 | CSR 体积 | 兼容性 | 适用场景 |
|---|---|---|---|---|
| RSA 2048(最常用,多数工具默认值) | -newkey rsa:2048 |
约 1 KB | 全平台,含老旧客户端与部分硬件设备 | 不确定对端支持什么时选它 |
| RSA 4096 | -newkey rsa:4096 |
约 1.7 KB | 同上,但每次握手签名运算明显更慢 | 合规强制更长密钥且不介意 CPU 开销 |
| ECDSA P-256 | -newkey ec -pkeyopt ec_paramgen_curve:P-256 |
约 0.6 KB | 需 TLS 1.2+ 与较新客户端;Let’s Encrypt 及主流 CA 均可签发 | 面向现代浏览器,追求握手性能与更短证书链 |
openssl req -new
-newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co., Ltd./CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:*.example.com"
chmod 600 example.com.key # 属主读写,组与其他无权限
ls -l example.com.key # 期望看到 -rw-------
# 证书里的公钥指纹
openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
# 私钥推导出的公钥指纹
openssl pkey -in example.com.key -pubout | openssl sha256
# 顺带核对 CSR 与证书的 SAN 是否一致
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
openssl x509 -in example.com.crt -noout -text | grep -A1 "Subject Alternative Name"
若第 8 步报
unable to load certificate … PEM routines:get_name:no start line,几乎都是文件里混进了网页 HTML 或首尾多余空行——用head -1 example.com.crt看第一行是不是-----BEGIN CERTIFICATE-----即可定位。
配置与命令示例:OpenSSL 3.0.13 / 3.2.2 参数逐条对照
把“CSR 在线生成”的流程搬到命令行,等价操作就是一次 openssl req。先确认版本,3.0.13 LTS 与 3.2.2 的参数行为一致:
openssl version -a
# 输出示例:OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)
RSA 一行命令(OpenSSL 3.0.13 LTS 实测)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co., Ltd./CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# -nodes 私钥不加密,等价于 3.x 的 -noenc;不加则交互输入密码
# -addext 需 OpenSSL ≥ 1.1.1;-subj 中 CN 必须与首个 SAN 一致,否则部分 CA 拒签
# 默认摘要为 SHA-256(default_md = sha256),2048 位为 default_bits 默认值
ECDSA 写法(曲线名可写 P-256、prime256v1 或 secp384r1):
openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:P-256 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/O=Example Co., Ltd./CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
| 对比项 | RSA 2048 | ECDSA P-256 |
|---|---|---|
| CSR 签名算法 | sha256WithRSAEncryption | ecdsa-with-SHA256 |
| 兼容性 | 全平台通吃,老 Windows/IoT 无风险 | 需 TLS 1.2+ 与较新客户端 |
| 等效强度 | 约 112 位 | 约 128 位 |
| 适用场景 | 通用、兼容优先 | 握手性能敏感、移动端 |
多 SAN 与自动化:配置文件法。据 OpenSSL 文档,req_extensions 指向的段名必须存在,否则报 Error loading request extension section v3_req。
# csr.cnf
[req]
default_bits = 2048
prompt = no
distinguished_name = dn
req_extensions = v3_req
[dn]
C = CN
ST = Zhejiang
L = Hangzhou
O = Example Co., Ltd.
CN = example.com
[v3_req]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
openssl req -new -key example.com.key -config csr.cnf -out example.com.csr
# 已有私钥补 CSR 时严禁带 -newkey,否则重新生成密钥并覆盖 -keyout 文件
cp example.com.key example.com.key.bak # 3.x 对已存在输出文件直接覆盖,先备份
格式转换与自检。多数 CA 收 PEM(首行 -----BEGIN CERTIFICATE REQUEST-----),个别老平台只收 DER;不要用记事本另存,CRLF 混入会导致 CA 端解析失败。
openssl req -in example.com.csr -outform DER -out example.com.der
openssl req -in example.com.csr -noout -text | grep -E "Signature Algorithm|Public-Key"
# 期望:sha256WithRSAEncryption 与 Public-Key: (2048 bit)
# 若为 sha1WithRSAEncryption 或 1024 bit,说明参数写错,需重新生成
在线工具、本地 OpenSSL、certbot 怎么选:参数与成本对比
选型不必纠结,固定用 6 个维度打分就够了:私钥存放位置、上手耗时、能否自动化、SAN/泛域名支持、工具成本、适用场景。据 Let’s Encrypt 文档,ACME 签发的证书有效期统一为 90 天,这意味着“能不能自动化续期”通常比“首次签发有多快”更影响长期成本。
| 维度 | 浏览器在线工具(纯前端) | 本地 OpenSSL 3.0.13 | certbot 2.x(ACME) |
|---|---|---|---|
| 私钥存放位置 | 本机浏览器内存或下载目录 | 本机磁盘(你指定的路径) | /etc/letsencrypt/live/<域名>/privkey.pem |
| 上手耗时 | 2–3 分钟 | 5–10 分钟 | 15–30 分钟(含安装与验证方式配置) |
| 能否自动化 | 不可自动化 | 可,脚本与 CI 均可调用 | 可,cron/systemd timer 自动续期 |
| SAN/泛域名 | 视工具而定,多数支持 SAN,泛域名较少 | 均支持,subjectAltName 任意扩展 |
支持 SAN;泛域名必须走 DNS-01 |
| 工具成本 | 0 元 | 0 元 | 0 元 |
| 适用场景 | 一次性签发、使用者非运维 | 批量签发、需留痕审计 | 长期在线服务、能改 DNS 或放行 80 端口 |
需要批量生成 CSR 或把它接入流水线时,关键不在于敲 openssl req,而在于先写好 csr.cnf 模板。OpenSSL 3.0 起必须显式声明 req_extensions,否则生成的 CSR 里没有 SAN,CA 会直接拒签(现代浏览器也只校验 SAN,不看 CN):
# csr.cnf —— OpenSSL 3.0.13 验证通过;3.x 默认不自动带扩展,务必写 req_extensions
[req]
default_bits = 2048
prompt = no
distinguished_name = dn
req_extensions = v3_req
[dn]
CN = example.com
[v3_req]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = *.example.com
# 生成私钥 + CSR 一条命令完成(-nodes 表示私钥不加密,注意文件权限设 600)
openssl req -new -newkey rsa:2048 -nodes -keyout example.key -out example.csr -config csr.cnf
# 提交前自检:确认 SAN 已写入
openssl req -in example.csr -noout -text | grep -A1 "Subject Alternative Name"
证书本身的价格(2025 年国内常见报价,仅作预算参考):DV 单域名 0–150 元/年(Let’s Encrypt 免费、ZeroSSL 免费档 90 天);DV 通配符 300–900 元/年;OV 单域名 400–1500 元/年;OV 通配符 3000–8000 元/年。也就是说,工具成本几乎恒为 0,真正花钱的是证书类型和人工运维时间。
还有一种常见混合方案:用在线工具生成私钥与 CSR(csr 在线生成 只在前端完成,私钥不出浏览器),再把 CSR 交给 ACME 账户手工 finalize。此时 certbot --csr 模式不允许再写 -d,域名全部来自 CSR 内的 SAN,多写会直接报参数冲突:
# certbot 2.x:用已有 CSR 签发,域名从 CSR 的 SAN 读取
certbot certonly --csr ./example.csr --webroot -w /var/www/html
--cert-path ./cert.pem --fullchain-path ./fullchain.pem
# 若误加 -d,会得到类似报错:
# Error: Cannot specify both --csr and domains
# 处理方式:删掉 -d,改为在 csr.cnf 的 [alt_names] 里补 DNS 条目后重新生成 CSR
一句话判断:一次性、非运维人员用纯前端在线工具最快;要批量或纳入审计,用 OpenSSL 脚本加 csr.cnf 模板;长期运行且能改 DNS 或放行 80 端口,用 certbot 自动续期最省人力。注意 --webroot 走 HTTP-01 只支持单域名与多 SAN,泛域名必须切到 --dns-* 插件走 DNS-01,这也是选型时最容易被忽略的一条硬约束。
常见报错与排查:从 OpenSSL 到 Nginx 的真实错误信息
OpenSSL 的错误栈是由内向外打印的:最后一行才是真正的失败原因,前面几行只是调用链。据 OpenSSL 3.x 文档,每行格式为 library:function:reason,看懂这个结构,下面六个高频报错基本都能自己定位,不必再从头重做一遍 CSR。
问:req: Error adding extensions from section v3_req 是怎么回事?
十有八九是 csr.cnf 里 [v3_req] 段名拼错,或 req_extensions = v3_req 指向了一个不存在的段(写成 v3-req、V3_REQ 都算错,段名区分大小写且方括号内不能有空格)。用 -reqexts 显式指定段名,能把”整个配置文件解析失败”缩小到”某一个段找不到”:
# csr.cnf:段名必须与 -reqexts 参数完全一致
[ req ]
default_md = sha256
req_extensions = v3_req # 指向下方段名,大小写敏感
distinguished_name = dn
[ v3_req ]
subjectAltName = @alt_names
[ alt_names ]
DNS.1 = example.com
DNS.2 = www.example.com
IP.1 = 203.0.113.10
# OpenSSL 3.0 / 1.1.1 通用:显式指定扩展段,段名写错会立刻报在这里
openssl req -new -config csr.cnf -reqexts v3_req
-key example.com.key -out example.com.csr
问:problems making Certificate Request ... v2i_GENERAL_NAME:no supported names 怎么修?
这是 openssl req 解析 SAN 时 v2i(value to internal)转换失败。RFC 5280 规定 SAN 只认 DNS:、IP:、email:、URI: 等类型前缀。中文域名(未转 punycode)、全角逗号 ,、裸 IP(203.0.113.10 缺 IP:)、用分号分隔多值,都会命中这条;多个值之间只能用半角逗号。
问:unable to load certificate ... PEM routines:get_name:no start line?
你把 CSR 喂给了 openssl x509。两者头部标识不同:CSR 是 -----BEGIN CERTIFICATE REQUEST-----,证书是 -----BEGIN CERTIFICATE-----。CSR 用 openssl req -in example.com.csr -noout -text 读,证书才用 openssl x509。
问:CA 下单页提示 “CSR Decode Failed / The CSR is invalid”?
多半是粘贴时丢了首尾 ----- 行、行内混入空格,或被输入框截断。先在本地验证,看到 self-signature verify OK 再重新粘贴:
# 验证 CSR 结构 + 自签名;输出 self-signature verify OK 才算合格
openssl req -in example.com.csr -noout -verify
# 顺带确认 SAN 是否真的写进去了
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
问:Nginx 启动报 SSL_CTX_use_PrivateKey_file() failed ... key values mismatch?
证书与私钥不配对,X509_check_private_key 校验失败。别靠肉眼比对,直接比公钥 SHA-256 指纹:
# 两行输出必须完全一致,否则证书与私钥不是一对
openssl x509 -in fullchain.pem -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
问:证书链正常,浏览器却报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH?
典型场景是只部署了 ECDSA 证书,而 ssl_ciphers 仍是纯 RSA 套件列表。ECDSA 证书必须配 ECDHE-ECDSA-AES128-GCM-SHA256 一类条目(TLS 1.3 套件由 OpenSSL 内置、不受 ssl_ciphers 影响,所以故障只在 TLS 1.2 握手暴露)。Nginx 1.25 的默认 ssl_ciphers 不含 ECDSA 套件,可用 nginx -T | grep ssl_ciphers 确认,并以 Mozilla SSL Configuration Generator 的 intermediate 配置做基线。
| 报错关键字 | 出错环节 | 一条命令定位 |
|---|---|---|
| Error adding extensions from section | cnf 段名 / 大小写 | openssl req -new -config csr.cnf -reqexts v3_req |
| v2i_GENERAL_NAME:no supported names | SAN 语法 | openssl req -in x.csr -noout -text |
| PEM routines:get_name:no start line | 子命令用错 | 改用 openssl req,而非 x509 |
| CSR Decode Failed | 粘贴截断 / 空白字符 | openssl req -in x.csr -noout -verify |
| key values mismatch | 证书与私钥不配对 | openssl x509 -pubkey | openssl sha256 |
| ERR_SSL_VERSION_OR_CIPHER_MISMATCH | ECDSA 缺 ECDHE 套件 | nginx -T | grep ssl_ciphers |
用 csr 在线生成 工具产出的文件,拿到本地后同样建议先跑一遍 openssl req -verify:浏览器端 WebCrypto 拼装的 SAN 扩展一旦编码有偏差,错误往往延迟到 Nginx 或 CA 下单页才暴露,此时已很难回溯到生成环节。
效果验证:4 条命令确认 CSR、私钥与线上配置都生效
签发前后到底该跑哪几条命令,才能确认 CSR 没被改动、SAN 没漏域名、私钥没配错、线上也没少中间证书?下面这套四步验证适用于 OpenSSL 1.1.1 与 3.x(3.x 默认安全级别 SECLEVEL=2、SHA-256 签名),也是把 csr 在线生成工具产出的文件与命令行产出对齐的最快方式。
第一步:CSR 自签名是否完整。CSR 内含用私钥对自身内容的签名,任何字节改动都会破坏它。据 OpenSSL 文档,req -verify 就是校验这段签名:
# OpenSSL 3.x 通过时输出:Certificate request self-signature verify OK
openssl req -in example.com.csr -noout -verify
# 若提示 verify failure / verify error,说明文件被文本编辑器改过或传输时换行符被转换,必须重新生成
第二步:SAN 条数必须与订单完全一致。CA 只按 CSR 里的 SAN 签发,多写一条等于白买,少写一条上线就报域名不匹配:
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 期望:DNS:example.com, DNS:www.example.com
# 注意 -A1 只取一行,SAN 超过 4 个域名时 OpenSSL 会折行,建议改用
openssl req -in example.com.csr -noout -text | sed -n '/Alternative Name/,/Signature Algorithm/p'
第三步:私钥、CSR、证书三者公钥指纹一致。CSR 里只含公钥,所以比对的是公钥摘要而非私钥本身:
# 两条输出的 sha256 十六进制串必须完全相同
openssl req -in example.com.csr -pubkey -noout | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
# 证书下发后,用同一基准再比一次
openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
第四步:有效期与线上实际链。公网 TLS 证书有效期上限现为 398 天;据 CA/Browser Forum SC-081 表决结果,2026-03-15 起缩至 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天——续期脚本里的告警阈值要跟着改,别写死 365。
# 本地看起止时间
openssl x509 -in example.com.crt -noout -dates
# 线上取回实际下发的叶证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates
# 完整链与信任评估(testssl.sh 3.2+)
testssl.sh --fast https://example.com # 关注 Chain of trust / OCSP stapling 两行
| 验证项 | 通过标准 | 典型失败输出与含义 |
|---|---|---|
| CSR 自签名 | self-signature verify OK |
verify failure:文件被改动 |
| SAN 列表 | 条数与订单逐一对应 | 缺项 → 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID |
| 公钥指纹 | 三串 sha256 相同 | 不同 → 用了别的私钥生成 CSR,证书装上也握手失败 |
| 线上证书链 | Chain of trust: OK |
verify error:num=20:unable to get local issuer certificate:漏配中间证书 |
为什么自签名验证不能省?很多 csr 在线生成流程在浏览器 WebCrypto 里完成密钥对与 DER 编码,用户复制粘贴或另存时极易引入 BOM 或 CRLF,签名随之失效。CA 通常只会返回一句模糊的 “CSR invalid”,而本地一条 openssl req -verify 就能定位问题,比来回提交工单快得多。
延伸:CSR 通过之后,证书链、OCSP 与续期怎么衔接
Q1:CSR 通过、拿到证书文件后,第一件容易做错的事是什么?
拼证书链。顺序必须是叶子证书在前、中间证书在后,根证书不要放。根证书早已内置在客户端信任库中,放进 fullchain 只会增加 1–2 KB 握手开销,还可能让部分校验器报重复证书。据 CA/Browser Forum 基线要求与 RFC 5280 的路径构建规则,服务端应下发除根外的完整链,缺失中间证书正是 Java、旧版 Android 报 PKIX path building failed 的典型原因。如果你是用 WebCrypto 做的 csr 在线生成,拿到的通常只有叶子证书,中间证书需从 CA 的仓库(如 Let’s Encrypt 的 chains 目录)单独下载。
# 按 叶子 → 中间 的顺序拼接,根证书不要写入
cat example.com.crt intermediate.crt > fullchain.pem
# 校验顺序:输出的第一个证书必须是叶子(CN/SAN 为你的域名)
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 模拟客户端做路径构建验证(OpenSSL 1.1.1+ / 3.x 通用)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK
Nginx 侧两个指令的分工要记牢:ssl_certificate 指向 fullchain.pem(叶子+中间),ssl_certificate_key 指向私钥且权限必须 600。
server {
listen 443 ssl;
http2 on; # nginx ≥1.25.1 写法;更早版本用 listen 443 ssl http2;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 叶子在前、中间在后
ssl_certificate_key /etc/nginx/ssl/privkey.pem; # chmod 600,属主 root
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 中间证书,用于校验 OCSP 响应
resolver 223.5.5.5 valid=300s; # 缺 resolver 时 stapling 会静默失效
resolver_timeout 5s;
}
真实报错:
javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target——九成是漏拼中间证书,而不是证书本身无效。
Q2:OCSP stapling 现在还值得配吗?
值得配,但别把架构押在它上面。stapling 让服务器在握手时附带 CA 签名的 OCSP 响应,省掉客户端一次明文查询(省延迟、护隐私)。但据 Let’s Encrypt 2024 年 7 月的公告,其 OCSP 服务自 2025 年起逐步关停并全面转向 CRL(先停发响应,后移除证书中的 OCSP URL)。因此 Nginx 配置保留即可——CA 不再提供 OCSP 时它会静默跳过,不会导致握手失败;新项目也不必再为 OCSP 单独做高可用。验证是否真的生效:
echo | openssl s_client -connect example.com:443 -servername example.com -status 2>/dev/null
| grep -A1 "OCSP Response Status"
# successful (0x0) = 已 stapling;no response sent = 未生效(检查 resolver 与 ssl_trusted_certificate)
Q3:续期时该复用私钥还是换新密钥?
certbot 2.x 默认在续期时生成新密钥,--reuse-key 把”复用”记在证书上,--new-key 则强制覆盖该设置。
| 场景 | 命令参数 | 续期后私钥 | 优点 | 代价 |
|---|---|---|---|---|
| 默认(推荐) | 不加参数 | 重新生成 | 攻击面最小 | 需 reload 部署新 key |
| 密钥固定 / HSM / 证书钉扎 | --reuse-key |
保持不变 | 续期更快,无需改下游配置 | 同一密钥可能存活数年 |
| 合规审计(如 PCI DSS 密钥管理条款) | --new-key |
强制重新生成 | 满足年度轮换要求 | 需确认部署链路同步 |
# 复用密钥续期,并在成功后自动校验+重载
certbot renew --cert-name example.com --reuse-key
--deploy-hook "nginx -t && systemctl reload nginx"
# 需要轮换时强制换新密钥(覆盖证书上记录的 reuse_key 设置)
certbot renew --cert-name example.com --new-key
Q4:怎么把 CSR 生成塞进 CI 流水线,避免人工复制出错?
人工复制最常见的两类事故:SAN 漏填(只写 CN 不写 SAN,现代浏览器直接判无效)和首尾行缺失(-----BEGIN CERTIFICATE REQUEST----- 被截断)。用模板加环境变量渲染、输出到临时目录,可以一次性消除。注意 -addext 需要 OpenSSL 1.1.1 及以上,1.0.2 只能在 csr.cnf 的 [req_extensions] 里声明 SAN。
#!/usr/bin/env bash
set -euo pipefail
DOMAIN="${DOMAIN:?必须通过环境变量提供 DOMAIN}"
OUT="$(mktemp -d)"; trap 'rm -rf "$OUT"' EXIT
umask 077 # 私钥一创建即为 600,无需事后 chmod
openssl req -new -newkey rsa:2048 -nodes
-keyout "$OUT/$DOMAIN.key"
-out "$OUT/$DOMAIN.csr"
-subj "/CN=$DOMAIN"
-addext "subjectAltName=DNS:$DOMAIN,DNS:www.$DOMAIN"
-config /etc/ssl/csr.cnf # 模板中至少含 [req] distinguished_name 与 req_extensions
chmod 600 "$OUT/$DOMAIN.key"
# 断言:SAN 非空且包含预期域名,否则流水线直接失败
openssl req -in "$OUT/$DOMAIN.csr" -noout -text | grep -A1 "Subject Alternative Name"
提交给 CA 前再用 openssl req -in x.csr -noout -verify 校验一次签名自洽性(输出 verify OK),比事后追查”为什么 csr 在线生成 的证书装上去安卓打不开”便宜得多。这些环节——证书链顺序、OCSP/CRL 状态查询、密钥轮换周期——也正是后续排查 TLS 握手失败时的三条主线。
取决于实现方式。纯前端方案用 WebCrypto 在浏览器内生成密钥对,私钥只存在于内存和你下载的文件里,页面不会上传。验证方法是打开 DevTools 的 Network 面板重新生成一次,检查所有请求的 Payload,只要出现私钥内容就说明密钥被上传,应立即弃用并重新生成密钥对。
结果没有区别,两者产出的都是 PKCS#10 结构、Base64 PEM 编码的 CSR,字节层面可互换使用。差别在过程可控性:OpenSSL 3.0.13 可以写进脚本、可审计、可用 csr.cnf 精确控制 SAN 与扩展,在线工具胜在不用装环境,2-3 分钟出结果。
建议都填,但起作用的是 SAN。Chrome 58(2017-04)起不再回退到 CN 匹配,只填 CN 会签发成功但浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID。规范做法是 CN 写主域名,SAN 至少包含 CN 本身、www 子域及所有需要覆盖的域名,泛域名写 DNS:*.example.com。
这是配置文件里段名与 req_extensions 引用不一致导致的。检查 csr.cnf 中是否存在 [v3_req] 段、req_extensions 是否写成 v3_req,然后在命令中加 -reqexts v3_req 显式指定。另外 OpenSSL 1.0.2 不支持 -addext,需升级到 1.1.1 或 3.x。
CSR 环节完全一样,都是 PKCS#10 文件,密钥长度与签名算法要求也相同。区别在 CA 侧的验证流程与时间成本:DV 只验证域名控制权,通常 1-10 分钟签发、价格 0-150 元/年;OV 需核验企业营业执照等资料,约 1-3 个工作日、400-1500 元/年。
泛域名在 SAN 中写 DNS:*.example.com,只覆盖一级子域,a.b.example.com 不在覆盖范围内。若需同时覆盖根域,必须再加一条 DNS:example.com,两条并列写入 -addext 或 csr.cnf 的 alt_names 段。
技术上可以,同一 CSR 可重复提交给不同 CA,因为 CA 只读取其中的公钥与主题信息。但私钥复用范围越大,单点泄露的影响面越广;建议不同 CA、不同环境使用独立密钥对,并在 CSR 存档时记录对应的密钥指纹便于追溯。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。