CSR 文件怎么生成?OpenSSL、IIS 与 keytool 实操步骤及报错排查
生成 CSR 的核心命令是 `openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com' -sha256`,OpenSSL 1.1.1/3.x 可直接执行;私钥留在本地,只提交 CSR 给 CA。 验证 CSR 用 `openssl req -in example.com.csr -noout -verify -text`,应看到 `verify OK`、`sha256WithRSAEncryption` 和 DNS SAN;没有 SAN 的 CSR 不要提交。 公网 Web 常用 RSA 2048(兼容广)或 ECDSA P-256(握手快);NIST SP 800-57 对 2048 位 RSA 的评估使用期到 2030 年前后,之后评估 3072 位或 ECDSA。 Let's Encrypt 由 Certbot 2.x 等 ACME 客户端自动生成私钥与 CSR,90 天有效;商业 DV 常见 ¥0-¥500/年,OV ¥800-¥3000/年,EV ¥2000-¥8000/年,人工审核 1-7 个工作日。 生成后执行 `chmod 600 example.com.key`,私钥不进 Git;线上用 `openssl s_client -connect example.com:443 -servername example.com` 检查 `Verify return code: 0 (ok)` 与 TLS 1.2/1.3。
问题背景与根本原因:CSR 文件怎么生成,为什么总在“提交证书”这一步卡住?
“CSR 文件怎么生成”这个问题本身并不复杂,真正让人卡住的,是生成之后在 CA 页面提交时出现的各种异常。先把概念理清,绝大多数“提交失败”都能自己定位。
CSR 是 PKCS#10 格式的证书签名请求,规范见 RFC 2986。它的结构只有三块:公钥、主体信息(DN,含 CN/O/OU/C 等)、扩展项(最常见的是 SAN),最后用对应私钥对整段内容做一次签名,证明“我确实持有这把私钥”。据 RFC 2986 第 4 节,CA 校验签名通过后才会据此签发证书——所以 CA 只需要 CSR,永远不需要也不应该拿到私钥。把 .key 一起发给 CA 或上传到在线工具,等于把身份交给对方。
提交时卡住,通常不是“命令不会写”,而是把三个文件混为一谈:
| 文件 | 典型扩展名 | 里面有什么 | 能否公开 |
|---|---|---|---|
| 私钥 | .key / .pem | RSA/ECDSA 私钥本体 | 绝对不可外泄 |
| CSR | .csr / .req | 公钥 + DN + SAN + 私钥签名 | 可交给 CA |
| 证书 | .crt / .cer / .pem | 公钥 + DN + SAN + CA 签名 | 公开部署 |
第二个高频误区在命令参数上。OpenSSL req 子命令里,-key 表示复用已有私钥,-newkey 才会现场新建私钥。只写 -new 而漏掉 -key/-newkey,OpenSSL 会退回到读取 openssl.cnf 里 default_keyfile 的路径,常常直接报 req: Error on options or in configuration file 或提示找不到私钥。
第三个误区是只填 CN。据 RFC 5280 第 4.2.1.6 节,subjectAltName 才是标识证书适用域名的标准扩展;Chrome 58、Firefox 48 之后 CN 已完全不再参与域名匹配。CSR 里没有 DNS 类型的 SAN,即使签发成功,浏览器仍会报 NET::ERR_CERT_COMMON_NAME_INVALID。同理,摘要算法要显式写 -sha256:OpenSSL 1.1.1/3.x 的 req 默认已是 SHA-256,但沿用旧脚本或自定义配置时可能落到 SHA-1,而主流公共 CA 早已拒绝 SHA-1 签名的请求(CA/Browser Forum 基线要求)。
版本差异也会直接决定命令能不能跑:-addext 需要 OpenSSL 1.1.1 及以上,1.0.2 只能写配置文件;IIS 10 用 certreq -new,Java 8u301+/11+ 用 keytool -certreq,两者输出的同样是 PKCS#10。成本与周期上,据 Let’s Encrypt 文档,DV 证书免费、有效期 90 天,Certbot 2.x 一条命令即可完成 key+CSR+签发;商业 DV 常见 ¥0–¥500/年、OV ¥800–¥3000/年、EV ¥2000–¥8000/年,OV/EV 因需人工核验企业资质,通常 1–7 个工作日。
# 适用 OpenSSL 1.1.1 / 3.x:一条命令生成私钥 + CSR(含 SAN,SHA-256)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key # 新建私钥,务必 chmod 600
-out example.com.csr # 输出 PKCS#10 请求
-subj "/C=CN/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
-sha256 # 显式指定摘要,避免落到 SHA-1
# 提交前自检:确认签名算法与 SAN 都在
openssl req -in example.com.csr -noout -text | grep -E "Signature Algorithm|DNS:"
最后一条实用判据:用 openssl req -in xxx.csr -noout -verify -key xxx.key 能同时校验 CSR 签名是否有效、CSR 与私钥是否配对。这一步过了再提交,能挡掉大半“CA 页面报格式错误”的往返。
完整实操步骤:从私钥到可提交 CSR 的 6 步(OpenSSL 3.x)
如果你已经决定用 OpenSSL 走一遍流程,下面这套 6 步可以原样复制执行:从版本确认、私钥生成、配置文件、签发请求,到自检和提交,每一步都给出可验证的输出特征。据 OpenSSL 3.x 的 req(1) 手册,-sha256 自 3.0 起已是默认摘要算法,显式写出只是为了留下审计痕迹;CSR 本身的格式由 RFC 2986(PKCS#10)定义,CA 只接受其中携带公钥与签名、绝不包含私钥的文件。
- 确认版本与文件默认权限。1.1.1 系列已于 2023-09-11 结束公共支持,遗留环境至少应确认是 1.1.1w;生产环境建议 OpenSSL 3.0.x 或 3.2.x。
umask 077必须在生成私钥之前执行,否则后续.key会按默认 umask 落到 644,等于把私钥暴露给同机所有用户。
# 第 1 步:版本与 umask
openssl version -a # 期望输出形如:OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 ...)
umask 077 # 之后新建文件权限 = 600,目录 = 700
umask # 回显 0077 表示生效
- 生成 RSA 私钥。
genpkey的rsa_keygen_bits在 OpenSSL 3.x 中默认 2048,因此不加该参数也得到 2048 位;genpkey输出的是 PKCS#8(-----BEGIN PRIVATE KEY-----),而老版本genrsa输出 PKCS#1(-----BEGIN RSA PRIVATE KEY-----),个别老 CA 或导入工具对后者更友好,可追加-traditional。
# 第 2 步:2048 位 RSA 私钥(PKCS#8 格式)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
# 需要 PKCS#1 兼容格式时:
# openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -traditional -out example.com.key
ls -l example.com.key # 应为 -rw------- (600)
| 密钥长度 | 生成耗时 | 安全强度 | 握手签名开销 | 兼容性 | 适用场景 |
|---|---|---|---|---|---|
| RSA 2048 | 约 0.1–0.5 s | ≈112 位 | 基准 | 全部客户端 | 通用站点;Let’s Encrypt 默认签发 2048 位 |
| RSA 3072 | 约 0.5–2 s | ≈128 位 | 约 2.5× | 绝大多数 | 合规过渡、中长期证书 |
| RSA 4096 | 约 1–3 s(低配机可达 10 s+) | ≈140 位以上 | 约 6× | 全部客户端 | 根/中间 CA、离线长期签名 |
- 写配置文件。
prompt = no是关键:否则openssl req会忽略[dn]里的预设值转为交互提问,在自动化脚本里直接挂死。据 CA/Browser Forum Baseline Requirements,subjectAltName是校验域名的唯一依据,Chrome 58 起已不再回退到 CN,所以[alt_names]必须写全主域名与所有别名。
# 第 3 步:example.com.cnf
[req]
distinguished_name = dn
req_extensions = req_ext
prompt = no
[dn]
CN = example.com
O = Example Ltd
C = CN
[req_ext]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
- 生成 CSR。注意
-nodes只在-newkey现场生成新私钥时才有效(含义是”不给新私钥加密”),对-key指定的既有私钥没有作用,写进去会被忽略;私钥本身已加密时,用-passin提供口令而非-nodes。
# 第 4 步:签发 CSR
openssl req -new -key example.com.key -out example.com.csr -config example.com.cnf -sha256
# 私钥带口令时的非交互写法(口令文件权限同样设为 600):
# openssl req -new -key example.com.key -out example.com.csr -config example.com.cnf
# -sha256 -passin file:pass.txt
- 自检三项内容,缺一不可。摘要算法、公钥长度、SAN 扩展都要看;很多”CA 审核不通过”其实在本地这一步就能发现。顺便用公钥哈希确认 CSR 与私钥配对,避免提交错文件。
# 第 5 步:查看 CSR 内容
openssl req -in example.com.csr -noout -text
# 期望看到(节选):
# Public-Key: (2048 bit)
# Signature Algorithm: sha256WithRSAEncryption
# Requested Extensions:
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
# 校验 CSR 与私钥是否配对:两条命令输出哈希应完全一致
openssl req -in example.com.csr -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
- 只提交 CSR,私钥不离机。把
example.com.csr的完整 PEM 文本(含-----BEGIN CERTIFICATE REQUEST-----头尾)贴给 CA 即可;example.com.key留在原机并确认chmod 600,不要通过聊天工具、邮件或工单附件明文传输。签发完成后下载服务器证书.crt与中间链文件,后续部署时证书链不完整会直接导致部分 Android 与 Java 客户端握手失败。
常见报错及其根因:
# 1) 老版本 OpenSSL(1.1.1 及更早)的 .rnd 警告,非致命;3.x 已改用系统 CSPRNG,不再需要该文件
Can't load /root/.rnd into RNG
140736267418688:error:2406F079:random number generator:RAND_load_file:Cannot open file
# 2) req_extensions 指向的 section 名不存在或大小写不一致
Error loading request extension section req_ext
# 3) 私钥被截断、带 BOM 或粘贴时丢了头尾行(OpenSSL 3.x 错误格式)
Could not read private key from example.com.key
40B7F2A1:error:1E08010C:DECODER routines::unsupported
第 3 条在从网页或聊天窗口复制私钥时尤其常见:CRLF 混入或首行 -----BEGIN 前多了空格都会触发 DECODER routines::unsupported,用 file example.com.key 与 head -c 40 example.com.key | xxd 可以快速确认。这套流程产出的 CSR 同样适用于 ACME 之外的商业 CA;如果你走 Let’s Encrypt,客户端会在 ACME 流程中自行生成密钥与 CSR,此时更值得关注的是证书透明度日志(CT)与自动续期策略,而不是手工粘贴 CSR。
配置与命令示例:OpenSSL、IIS certreq、Java keytool 的具体写法
OpenSSL 3.x 怎么用一条命令生成 CSR 和私钥?
据 OpenSSL 官方手册,从 1.1.1 起 req 子命令支持 -addext,可以完全不交互地一次生成私钥和带 SAN 的 CSR。2048 位 RSA + SHA-256 是目前兼容性最好的默认组合(OpenSSL 3.x 的默认摘要已是 SHA-256,但显式写上可避免老配置文件覆盖):
# 一次生成私钥 + CSR,全程无交互;-nodes 表示私钥不加密(便于 Web 服务器自动加载)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj '/C=CN/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
-sha256
# 自检:确认 SAN 已写入 CSR,输出里应出现 X509v3 Subject Alternative Name
openssl req -in example.com.csr -noout -text | grep -A1 'Alternative Name'
# 核对公钥与私钥是否配对(两条输出的 MD5 必须一致)
openssl req -noout -modulus -in example.com.csr | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
坑在这里:-addext 在 OpenSSL 1.0.2 上并不存在,CentOS 7 自带 1.0.2k,执行会直接报 req: Unknown option or number of arguments for -addext,随后提示 req: Use -help for summary.。此时只能回退到配置文件方式:
# openssl.cnf 片段:注意 [req] 段里写的是 req_extensions,不是 extensions
[req]
distinguished_name = dn
req_extensions = req_ext # 关键:req 命令只认这一项
prompt = no
[dn]
C = CN
O = Example Ltd
CN = example.com
[req_ext]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
用 openssl req -new -key example.com.key -config openssl.cnf -out example.com.csr 时,CSR 扩展只读取 req_extensions;命令行上传 -extensions req_ext 是给 openssl x509 -req 签发阶段用的,混用会导致“签出来的证书没有 SAN”,Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID。
Windows Server / IIS 10 怎么做?IIS 管理器不生成 CSR 文件,它把请求写进 Windows 证书存储,要用 certreq 才落地成文件。新建 request.inf:
; request.inf —— 适用 Windows Server 2016+ / Windows 10+
[NewRequest]
Subject = "CN=example.com, O=Example Ltd, C=CN"
KeyLength = 2048
Exportable = TRUE
MachineKeySet = TRUE ; 私钥存机器存储,IIS 才能直接绑定
ProviderName = "Microsoft RSA SChannel Cryptographic Provider"
[Extensions]
2.5.29.17 = "{text}DNS=example.com&DNS=www.example.com"
certreq -new request.inf example.com.csr
Java 环境(OpenJDK 11/17)用 keytool:先生成密钥对进 PKCS#12,再导出 CSR,两步不可合并:
keytool -genkeypair -alias example -keyalg RSA -keysize 2048
-sigalg SHA256withRSA -dname 'CN=example.com, O=Example Ltd, C=CN'
-ext SAN=dns:example.com,dns:www.example.com
-keystore example.p12 -storetype PKCS12 -validity 365
keytool -certreq -alias example -keystore example.p12
-file example.com.csr -sigalg SHA256withRSA
注意 keytool 的 -dname 不带 SAN,SAN 必须用 -ext 单独加;漏掉这一步,证书同样会被浏览器判定为域名不匹配。
Nginx 和 Apache 需要生成 CSR 吗?不需要。它们只消费证书与私钥,CSR 是交给 CA 的中间产物。部署时 Nginx 写 ssl_certificate /etc/nginx/ssl/fullchain.pem;(含中间证书链)与 ssl_certificate_key /etc/nginx/ssl/example.com.key;,Apache 对应 SSLCertificateFile 与 SSLCertificateKeyFile。
用 Let’s Encrypt 还要手工敲 openssl 吗?通常不用。按 Let’s Encrypt 官方文档,Certbot 2.x 会自行创建私钥与 CSR 并完成 ACME 校验:certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com。只有企业内网 CA 或 CA 要求手工提交 CSR 的流程,才需要上面这些文件。
| 维度 | OpenSSL 3.x | certreq(IIS 10) | keytool(OpenJDK 17) |
|---|---|---|---|
| 运行环境 | Linux/macOS/Windows | Windows Server 2016+ | 任意安装 JRE 的系统 |
| 私钥存放 | .key 文件(PEM) |
Windows 证书存储 | PKCS#12 密钥库 |
| SAN 写法 | -addext 或 req_extensions |
[Extensions] 2.5.29.17 |
-ext SAN=dns:... |
| 最低版本要求 | 1.1.1(1.0.2 无 -addext) |
Windows 10 / 2016 | JDK 7+ 支持 -ext |
| 默认摘要 | SHA-256 | SHA-256 | 需显式 -sigalg |
参数对比与方案选型:RSA 2048/3072/4096、ECDSA P-256/P-384 与 SAN 怎么选?
一句话结论:公网 Web 站点在没有特殊合规要求时,选 RSA 2048 或 ECDSA P-256;若终端里还混着未打补丁的 Windows 7、Android 4.x,只选 RSA 2048。下表把五个候选放在同一坐标系里对比,数据依据 OpenSSL 3.x 实测与 NIST SP 800-57 Part 1 Rev.5 的安全强度对照。
| 维度 | RSA 2048 | RSA 3072 | RSA 4096 | ECDSA P-256 | ECDSA P-384 |
|---|---|---|---|---|---|
| 安全强度 | 约 112 位 | 约 128 位 | 约 152 位 | 约 128 位 | 约 192 位 |
| 兼容性 | 最广 | 广 | 广但握手慢 | TLS 1.2+ 主流 | 较新 |
| CSR 生成耗时 | 0.1–1s | 0.5–3s | 1–10s | <0.1s | <0.2s |
| 适用场景 | 通用/老客户端 | 合规增强 | 少用 | 现代 Web/移动 | 高安全 |
为什么不是“越大越好”?RSA 4096 的握手与签名运算量约为 2048 的 6–7 倍,在移动端和高并发网关上是实打实的 CPU 成本;而 ECDSA P-256 用 256 位密钥就达到 RSA 3072 的 128 位强度,握手包体也更小。代价是兼容性:Windows Server 2012 R2 之后的 Schannel 才比较稳妥地处理 ECDSA 证书,更老的 IIS 环境导入 ECDSA 证书时常见“证书链不完整”或绑定失败。据 NIST SP 800-57 Part 1 Rev.5,112 位强度(RSA 2048)的使用期限到 2030 年底,之后应评估迁移到 RSA 3072 或 ECDSA P-256/P-384。
SAN 怎么写才不会漏域名?一个 CSR 可以携带多个 DNS 名称,用逗号分隔且不能有空格:DNS:example.com,DNS:www.example.com,DNS:api.example.com。通配符 DNS:*.example.com 只覆盖一级子域,既不包括裸域 example.com,也不包括 a.b.example.com,因此实务中通常写成 DNS:example.com,DNS:*.example.com。据 Let’s Encrypt 官方速率限制文档,单张证书默认最多 100 个 SAN 名称,同一注册域名每周最多签发 50 张证书,所以把上百个域名塞进一张 CSR 前先算清楚额度;商业通配符 DV 证书常见价格区间为每年 ¥300–¥1500,多域名 SAN 证书则按域名数阶梯计价。
# RSA 2048 + SAN,一步生成私钥与 CSR(OpenSSL 1.1.1 及以上支持 -addext)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj "/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"
-sha256 # 显式指定摘要,OpenSSL 1.1.1+ 默认值即 sha256
# ECDSA P-256:先生成 EC 私钥,再签发 CSR
openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
openssl req -new -key example.com.ec.key -out example.com.ec.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:*.example.com"
-sha256 # 输出 ecdsa-with-SHA256,切勿用 -sha1
提交前务必自检签名算法与 SAN,这条命令能把关键字段一次打出来:
openssl req -in example.com.csr -noout -text | grep -E "Signature Algorithm|Public Key Algorithm|NIST CURVE|DNS:"
# RSA 输出示例:
# Signature Algorithm: sha256WithRSAEncryption
# Public Key Algorithm: rsaEncryption
# DNS:example.com, DNS:www.example.com, DNS:api.example.com
# ECDSA 输出示例:
# Signature Algorithm: ecdsa-with-SHA256
# Public Key Algorithm: id-ecPublicKey
# NIST CURVE: P-256
真实报错:
error:0D07A780:asn1 encoding routines:ASN1_mbstring_ncopy:illegal characters——几乎都是-addext里逗号后加了空格,或 SAN 中混入中文域名未做 punycode 转换。另一条req: Unknown option or ciphersuite addext说明 OpenSSL 版本低于 1.1.1,需改用-config文件里的[req_extensions] subjectAltName=@alt_names写法。
最后确认 CA 侧接受度:提交 CSR 前先看 CA 的算法支持列表,部分 OV/EV 流程仍以 RSA 2048/3072 为主,ECDSA 可能被拒或要求重签。CSR 本身只是把公钥和主体信息做自签名封装,最终证书的密钥算法由 CSR 里的公钥决定——这也是“csr文件怎么生成”看似是格式问题、实则是选型问题的原因。
常见错误与排查:真实报错信息与对应命令
排查 CSR 相关报错,第一步永远是确认你手里的文件到底是哪一种。私钥、CSR、证书三者都是 Base64 文本(PEM 格式),肉眼看起来很像,混用是最高频的故障源。先记住这三条判别命令,后面所有报错都从这里出发:
# 1. 看文件头部标识:PRIVATE KEY / CERTIFICATE REQUEST / CERTIFICATE
head -n 1 example.com.key example.com.csr
# 2. 校验私钥是否可用(不输出内容,只验证结构)
openssl pkey -in example.com.key -noout -text
# 3. 校验 CSR 签名是否自洽
openssl req -in example.com.csr -noout -verify
报错:unable to load Private Key / PEM_read_bio_PrivateKey。OpenSSL 1.1.1 与 3.x 在读取私钥失败时都会抛出这类信息,原因基本只有三种:路径写错、私钥带口令但没提供密码、或者把 .csr 当成了 .key。验证时用 openssl pkey(3.x 推荐,替代旧的 openssl rsa);若私钥是 AES 加密的,必须加 -passin:
# 加密私钥:显式传入口令,pass: 表示明文,file: 表示从文件读,env: 表示从环境变量读
openssl pkey -in example.com.key -noout -text -passin pass:'YourPassphrase'
# 若提示 bad decrypt,说明口令错误或文件损坏——先 cp 备份,不要在原文件上反复试
cp -a example.com.key example.com.key.bak
bad decrypt 属于不可逆操作风险点:某些旧脚本会用 openssl rsa -in ... -out ... 原地“修复”,一旦口令不对可能写坏原文件。据 OpenSSL 官方文档,pkey 子命令在 1.0.0 起提供,是读取 PKCS#8/PKCS#1 私钥的统一入口。
报错:Error adding request extensions / X509V3_EXT_nconf_nid。这是配置文件三段式没对齐。必须同时存在:[req] 段里的 req_extensions = req_ext、被引用的 [req_ext] 段、以及 SAN 用的 subjectAltName = @alt_names 与对应的 [alt_names] 段。任何一处拼写不一致(例如写成 req_extention)都会触发该错误。
# /etc/ssl/example.com.cnf —— 三段必须互相指向
[req]
distinguished_name = dn
req_extensions = req_ext # 名字必须与下面的段名完全一致
prompt = no
[dn]
CN = example.com
[req_ext]
subjectAltName = @alt_names # @ 表示引用下面的段
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
报错:No such file or directory(指向 .cnf)。在 systemd 单元、cron 或 CI runner 中,工作目录与你交互式 shell 不同,相对路径必然失效。统一改用绝对路径:
openssl req -new -newkey rsa:2048 -nodes
-keyout /etc/ssl/private/example.com.key
-out /etc/ssl/certs/example.com.csr
-config /etc/ssl/example.com.cnf
Windows / IIS:certreq -new 报 The request contains no certificate template information。这通常出现在对接企业 AD CS 的场景,CA 强制要求请求中携带模板名。在 request.inf 的 [RequestAttributes] 下补一行(模板名须与 CA 上实际存在的模板一致,WebServer 是常见默认名):
; request.inf 片段
[RequestAttributes]
CertificateTemplate=WebServer
; 生成请求并提交
certreq -new request.inf example.com.csr
Java:keytool error: java.lang.Exception: Alias <example> does not exist。keytool 的 -alias 区分大小写,且必须与当初 -genkeypair 时完全一致。先列别名再申请:
# PKCS12 是 JDK 9 起的默认 keystore 类型,旧版本需显式 -storetype
keytool -list -v -keystore example.p12 -storetype PKCS12
keytool -certreq -alias example -keystore example.p12
-storetype PKCS12 -file example.com.csr
提交后 CA 报 CSR signature verification failed。几乎都是编辑器(尤其 Windows 记事本)改写了换行符,或复制时截断了 -----END CERTIFICATE REQUEST----- 尾行。据 Let’s Encrypt 文档,CSR 的 DER 结构一经改动签名即失效,必须在本地先自检,看到 verify OK 才提交。
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
| 报错关键字 | 最可能原因 | 定位命令 |
|---|---|---|
| unable to load Private Key | 路径错 / 未给口令 / 文件类型错 | openssl pkey -in key -noout -text |
| bad decrypt | 口令错误或文件损坏 | 先 cp 备份,再 -passin 重试 |
| X509V3_EXT_nconf_nid | req_extensions 与段名不匹配 | 检查 [req]/[req_ext]/[alt_names] |
| No such file or directory | -config 用了相对路径 |
改为绝对路径 |
| no certificate template information | AD CS 模板名缺失 | inf 中加 CertificateTemplate |
| Alias does not exist | 别名大小写或拼写不符 | keytool -list 先查 |
| CSR signature verification failed | 换行符被改写 / 内容截断 | openssl req -in csr -noout -verify |
顺带一提,CSR 只承载公钥与身份属性,私钥永远不离开本机——这也是为什么 openssl req -new -key 与 -newkey 两条路径都必须妥善保管 .key;后续无论是申请 DV 证书、配置 OCSP Stapling,还是做证书链拼接,都以这把私钥为根。
效果验证方法:如何确认 CSR 正确、证书链已生效?
把 CSR 交给 CA 之前先做一轮本地自检,比等签发失败再返工便宜得多。csr文件怎么生成这一步各家工具(OpenSSL / IIS / keytool)产出的格式一致,但验证手段通用。先验证 CSR 自身的签名与主题:
# 1) 校验 CSR 自签名完整性;OpenSSL 1.1.1+ / 3.x 均支持 -verify
openssl req -in example.com.csr -noout -verify
# 期望输出:Certificate request self-signature verify OK
# 若密钥文件与 CSR 不配套,会报:
# verify failure
# .../req.c:xxx:error:...:ASN1 lib:...:verify error
# 2) 以 RFC2253 规范格式打印主题,避免 CN 顺序歧义
openssl req -in example.com.csr -noout -subject -nameopt RFC2253
# 期望输出:subject=CN=example.com
# 注意:CN 长度上限 64 字符(X.509 定义),且现代浏览器只认 SAN,CN 仅供展示
第二步确认私钥和 CSR 里的公钥是同一对。原理是比对 SubjectPublicKeyInfo 的哈希,两份 PEM 编码必须一致,否则哈希天然不同:
# 提取 CSR 内公钥的 SHA-256
openssl req -in example.com.csr -noout -pubkey | openssl sha256
# 提取私钥对应公钥的 SHA-256(-pubout 输出 SPKI PEM,与上面编码一致)
openssl pkey -in example.com.key -pubout | openssl sha256
# 证书签发后,用 modulus 再对一次(仅 RSA 适用)
openssl x509 -in example.com.crt -noout -modulus | openssl sha256
openssl rsa -in example.com.key -noout -modulus | openssl sha256
两行输出相同即匹配。若不同,说明 CSR 与私钥不是一对,此时提交上去签发的证书装到服务器上会直接握手失败。ECDSA 证书没有 modulus,改用 openssl x509 -pubkey -noout | openssl sha256。
SAN 是当前证书的强制项。据 CA/Browser Forum Baseline Requirements(自 2017 年起),公有 CA 签发的证书必须包含 subjectAltName,缺失时 Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID。检查:
# 3) 检查 SAN 列表;OpenSSL 1.1.1+ 的 req -text 会完整展开扩展
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
# 期望看到:DNS:example.com, DNS:www.example.com
# 若完全没有输出该段落,说明生成 CSR 时漏了 -addext 或配置文件缺 subjectAltName,
# 不要提交,重新生成
下面这张表把上面几项收敛成一份可勾选的清单:
| 检查项 | 关键命令参数 | 通过标准 | 失败含义 |
|---|---|---|---|
| CSR 签名 | req -noout -verify |
verify OK |
CSR 被截断或编码损坏 |
| 公钥匹配 | -pubkey | sha256 |
两枚哈希相同 | CSR 与私钥非同一密钥对 |
| SAN 完整性 | -text | grep -A2 SAN |
含全部 DNS 名 | 浏览器 CN 不匹配告警 |
| 链与协议 | s_client -showcerts |
Verify return code: 0 (ok) |
缺中间证书,报 20 (unable to get local issuer certificate) |
证书装好后再做线上验证。s_client 要显式带 -servername 触发 SNI,否则虚拟主机场景下拿到的可能是默认站点证书:
# 4) 线上握手与链验证
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 关注三行:Protocol(TLSv1.2 / TLSv1.3)、Verify return code: 0 (ok)、
# 以及输出里出现的中间 CA 证书块(链应至少两级,根证书不必下发)
# 5) 证书有效期、签发者与 SAN 一次性核对
openssl x509 -in fullchain.pem -noout -dates -issuer -subject -ext subjectAltName
# 6) OCSP stapling:若配置了装订,这里应返回实际响应
openssl s_client -connect example.com:443 -servername example.com -status </dev/null
# 输出 "OCSP response: no response sent" 表示服务器未装订,不等于证书无效
最后用外部视角复核:Chrome 开发者工具 Security 面板应显示 Certificate - valid;curl -I https://example.com 返回 200 且无证书告警(curl -v 会打印 SSL certificate verify ok)。据 Mozilla Server Side TLS 指南,生产环境应关闭 TLS 1.0/1.1,可用 testssl.sh --protocols example.com 或 SSL Labs 扫描确认;但涉及协议下线这类变更,务必先在预发环境跑一遍,再推生产。回看前面 csr文件怎么生成 的步骤,你会发现验证成本远低于重新签发的等待时间。
ACME 自动化与 CSR 的边界:Let's Encrypt、企业 CA 与手动 CSR 怎么配合?
ACME 把 CSR 变成了一个”看不见的中间产物”。据 RFC 8555(ACME 协议)定义,客户端在 finalize 请求中提交 DER 格式的 CSR,CA 据此签发证书;而 CSR 里的公钥对应的私钥,从生成到落盘全程留在你自己的服务器上。理解这条边界,是判断”该自动化还是该手动”的关键。
Certbot 到底在后台做了什么?
Certbot 2.x 在首次签发时会自动创建账号密钥、域名私钥(默认 RSA 2048,可用 --key-type ecdsa --elliptic-curve secp256r1 改为 ECDSA P-256),再用该私钥生成 CSR 并完成 HTTP-01 或 DNS-01 挑战。证书落地路径固定为:
# Certbot 2.x 默认输出布局(--cert-name 决定目录名)
/etc/letsencrypt/live/example.com/fullchain.pem # 证书链,Web 服务器应引用此文件
/etc/letsencrypt/live/example.com/privkey.pem # 私钥,权限 0600
/etc/letsencrypt/live/example.com/chain.pem # 中间证书
/etc/letsencrypt/archive/example.com/ # 真实文件,live/ 下是软链接
# 注意:archive 目录内每次续期生成新文件(cert1.pem、cert2.pem…),便于回滚
# 续期演练:不实际签发,只验证挑战与钩子是否可用
certbot renew --dry-run
# 查看当前证书的 SAN 与到期时间
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text | grep -A1 "Subject Alternative Name"
适用版本:Certbot 2.0 起 --dry-run 默认走 staging 环境,避免触发正式环境的速率限制(据 Let’s Encrypt 文档,同一注册域名每周 50 张重复证书)。
为什么不该把私钥上传到”证书代管面板”?
很多托管面板要求你粘贴私钥来”帮你申请”。这在安全上等价于把身份凭证交给第三方:一旦面板被入侵,攻击者可对任意流量做中间人解密。合规做法是让面板本身充当 ACME 客户端——它自己生成密钥、自己完成挑战,你只授予最小权限的 API Token。反过来说,如果你确实需要手动提交 CSR 给第三方 CA(企业内网 CA、代码签名、EV 证书),那就必须走下面这条路径。
企业 CA / EV / 代码签名:手动 CSR 三件套
这些流程通常不接受 ACME,必须人工提交 CSR。此时请保留完整的证据链:
# 1) 生成私钥(RSA 3072,兼顾兼容性与强度)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:3072 -out example.com.key
chmod 600 example.com.key
# 2) 生成 CSR,同时指定 SAN(必须写在 -addext 中,CN 已不被现代浏览器采信)
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 3) 校验 CSR 签名并导出 SHA-256 指纹,记入审计台账
openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256
# 输出示例:SHA2-256(stdin)= 9f2c...(与私钥指纹一一对应)
建议把 .key、.csr、生成时使用的 .cnf(若用了配置文件)以及生成时间、指纹一并归档。CSR 本身可复用——同一密钥对可向不同 CA 提交,但只要 SAN 列表有任何变更,就必须重新生成,因为 SAN 是签名覆盖的内容。
自动化与手动的取舍
| 场景 | CSR 由谁生成 | 私钥位置 | 推荐周期 |
|---|---|---|---|
| 公网 Web(Let’s Encrypt) | ACME 客户端自动 | 本机磁盘,不出网 | 60–90 天自动续期 |
| 企业内网 CA(AD CS 等) | 管理员手动 | 本机 / HSM | 1 年,随密钥轮换 |
| EV / 代码签名 | 手动,常配 USB Token | 硬件令牌内 | 1–3 年 |
| 第三方代管面板 | 面板(若其为 ACME 客户端) | 面板服务器 | 需评估信任边界 |
密钥轮换策略上,RSA 2048 建议每 1–2 年评估一次是否升级到 3072 或切换 ECDSA P-256;证书续期时同步换钥,可以限制单把私钥泄露的影响面。签发完成后别忘了配置联动:启用 TLS 1.2/1.3、加 HSTS、开 OCSP stapling。Mozilla SSL Configuration Generator 的 “intermediate” 档位可作为 Nginx/Apache 的基线,但它默认假设较新的客户端,面向老旧终端(如嵌入式设备、旧版 Android)时需回退到 “old” 档并单独测试握手。
如果你只是想在自动化流程里补一个手动 CSR(例如给负载均衡器预置证书),那”csr文件怎么生成”这一步依然绕不开 OpenSSL 或 keytool;但请记住,CSR 只是公钥的载体,真正需要被严格保护、并且在自动化中绝不外传的,是那个 .key 文件。
密钥权限、备份与轮换:CSR 生成后的运维清单
私钥落地后第一件事做什么?先把权限收到“只有 root 能读”。PEM 格式的私钥是明文(RFC 7468 定义的就是未加密的 Base64),能读该文件的进程就等于拿到了站点身份。据 OpenSSL 文档,genrsa、req -newkey 按 umask(常见 022)创建文件,默认就是 644,必须显式修正。很多人只关心 csr 文件怎么生成,却漏掉了这一步:
# 目录 700、私钥 600 且属主 root;CSR 与证书链可公开读
install -d -m 700 -o root -g root /etc/ssl/private/example.com
chown root:root example.com.key
chmod 600 example.com.key
chmod 644 example.com.csr fullchain.pem
# 验证私钥与证书确实配对(轮换时最容易贴错文件)
openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
Nginx 的 master 进程以 root 打开私钥、worker 继承文件描述符,所以 600 root:root 是正常配置;若在容器里以非 root 运行并看到 nginx: [emerg] cannot load certificate key ... BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied),那是进程本身没有读权限,而不是密钥损坏。至于 Git,.key 一旦入库就必须视为泄露:
printf '*.keyn*.p12n*.pfxn' >> .gitignore
git ls-files '*.key' # 输出非空 = 历史中已有私钥,需 filter-repo 清理并重签证书
备份怎么做才不算“裸奔”?私钥至少两份离线加密副本,与在线主机物理隔离。age 与 gpg 都能直接对管道加密,无需先落地明文压缩包:
# age:单文件密钥,无 Web of Trust 负担
age-keygen -o backup-age.key # 生成密钥对,公钥形如 age1qz...
tar -czf - example.com.key | age -r age1qz... > example.com.key.age
age -d -i backup-age.key example.com.key.age > example.com.key # 恢复
# gpg 等价做法(AES256 对称加密)
gpg --symmetric --cipher-algo AES256 example.com.key # 产出 example.com.key.gpg
gpg -d example.com.key.gpg > example.com.key
CSR 本身不含私钥、可以公开,但建议与证书一起归档并保留 13 个月:90 天证书一年续 4 次,13 个月足以覆盖跨年的完整审计周期。
什么时候该重新生成 CSR?新 CSR 不等于新私钥——同一把密钥可以反复签 CSR,只有怀疑泄露时才必须换钥。这也是 csr 文件怎么生成的第二个高频场景,判断依据如下:
| 场景 | 有效期 | 建议动作 | 依据 |
|---|---|---|---|
| Let’s Encrypt / ACME | 90 天 | 剩余 30 天(第 60 天)自动续期 | Let’s Encrypt 文档建议到期前 30 天续期 |
| 商业 DV/OV 证书 | ≤398 天 | 到期前 30–60 天提交新 CSR | CA/Browser Forum Baseline Requirements |
| 内部 CA | 自定义 | 剩余 1/3 生命周期时 | 需同步 CRL/OCSP |
certbot certificates # 查看每张证书的到期日与剩余天数
certbot renew --dry-run # 演练续期,不改动线上文件
商业证书拖到最后一周才换,容易撞上 OCSP 响应或中间链变更导致的中断,留 30–60 天才有回滚余地。
怎么每天确认证书没过期?直接对线上端口取值,比读本地文件更可靠,能发现“部署了旧文件”这类问题:
# -servername 触发 SNI;</dev/null 防止 s_client 挂起等待输入
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -enddate -issuer
# 输出示例:notAfter=Aug 12 03:14:07 2026 GMT
# 剩余天数 < 21 天告警,可放进 cron 或 systemd timer 每日执行
end=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ "$days" -lt 21 ] && echo "WARN: 仅剩 ${days} 天"
要不要开 FIPS?普通网站不必默认开启。OpenSSL 3.x 把 FIPS 做成可加载 Provider,openssl list -providers 默认只显示 default;启用需用 openssl fipsinstall 生成配置并在 openssl.cnf 中加载 fips,代价是 MD5、部分椭圆曲线等算法被禁用、握手兼容性下降。只有合规审计明确要求时才启用,并用 openssl ciphers -provider fips 核对实际可用套件。生成私钥的环境本身也应限制登录(跳板机 + sudo 审计),避免密钥材料进入 shell 历史。
不需要。CA 只需要 CSR 来签发证书,私钥必须留在你自己的服务器或密钥库中。把 .key 发给任何人都会扩大私钥泄露面,后续应通过文件权限、离线备份和审计控制访问。
可以填,但不要只依赖 CN。Chrome 58+、Firefox 48+ 后证书匹配以 SAN 为主,CSR 里应写入 `subjectAltName=DNS:example.com,DNS:www.example.com`。CN 仍可保留为 `example.com`,便于旧系统识别。
技术上同一私钥和 CSR 可向不同 CA 申请,但 CSR 中的 SAN 列表是固定的,域名变化必须重新生成。生产环境不建议长期复用同一私钥,证书轮换时同步轮换密钥更便于控制风险。
通常不需要。Certbot 2.x 等 ACME 客户端会自动生成私钥、CSR 并完成 HTTP-01/TLS-ALPN-01 挑战。只有企业 CA、代码签名或 CA 明确要求上传 CSR 的流程,才需要按本文命令手工生成。
先确认 `-key` 路径指向 .key 而不是 .csr,再用 `openssl pkey -in example.com.key -noout -text` 检查文件是否可读。若私钥有密码,命令要加 `-passin pass:…` 或 `-passin file:pass.txt`;出现 `bad decrypt` 时优先从备份恢复。
公网 Web 用 RSA 2048 仍常见,兼容性广;NIST SP 800-57 对 2048 位 RSA 的评估使用期到 2030 年前后。4096 位握手和签名更慢,除非合规要求,否则优先评估 ECDSA P-256 或按 CA 要求选 3072 位。
通配符写 `DNS:*.example.com`,它只覆盖 `www.example.com`、`api.example.com` 这类一级子域,不覆盖 `example.com`,也不覆盖 `a.b.example.com`。需要根域名时同时加入 `DNS:example.com`。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。