密码学与证书 / 知识点

OpenSSL 证书操作手册

手册条目

在文本 PEM 与二进制 DER 格式之间转换证书和密钥。

转换 PEM 和 DER

用于在可读的 PEM 文本与二进制 DER 之间转换 X.509 证书和私钥。证书转换只改变编码;私钥经 pkey 转换时封装形式可能变化,但密钥参数不变。先确认对象类型,再选择 x509 或 pkey 子命令。

基本语法

证书使用 openssl x509,私钥使用 openssl pkey。-inform 指定输入编码,-outform 指定输出编码;PEM 是带头尾标记的 Base64 文本,DER 是二进制数据。

bash
# 语法模板:将占位符替换为实际文件和 PEM 或 DER
openssl x509 -in <CERT_INPUT> -inform PEM|DER -out <CERT_OUTPUT> -outform PEM|DER
openssl pkey -in <KEY_INPUT> -inform PEM|DER -out <KEY_OUTPUT> -outform PEM|DER

以上是语法模板,不能原样执行;<CERT_INPUT>、<KEY_INPUT> 等需替换为实际路径。

高频用法

将 PEM 证书转成 DER,再转回 PEM 并读取关键字段:

bash
# 转换后立即回读,避免只检查文件是否生成
openssl x509 -in server.crt -outform DER -out server.der
openssl x509 -inform DER -in server.der -outform PEM -out server.roundtrip.crt
openssl x509 -in server.roundtrip.crt -noout -subject -issuer -dates

预期输出:

text
subject=CN = api.example.com
issuer=CN = Example Intermediate CA
notBefore=<TIME>
notAfter=<TIME>

实际名称和时间取决于证书;能正常打印字段且命令退出码为 0,说明转换后的证书可被解析。

转换私钥前先限制新文件权限,并用 -check 验证结果:

bash
# 防止新生成的私钥被同组用户或其他用户读取
umask 077
openssl pkey -in server.key -outform DER -out server-key.der
openssl pkey -inform DER -in server-key.der -out server-key.roundtrip.pem
openssl pkey -in server-key.roundtrip.pem -check -noout

预期输出:

text
Key is valid

部分算法或版本的成功提示可能略有不同;退出码为 0 才表示校验成功。

风险与边界

-inform 和 -outform 只控制编码,不能把 PKCS#12、PKCS#7 或 CSR 当作普通证书处理。对象类型选错时通常出现 unable to load、Could not read 或 ASN.1 错误。先检查 PEM 头尾、执行 file,再用对应子命令试读,不要仅凭扩展名判断。

加密私钥转换时,如果输出命令未指定加密算法,结果可能成为未加密私钥,泄露后可直接被使用。安全替代方案是保留严格权限,并在输出 PEM 时增加 -aes-256-cbc;需要加密 PKCS#8 DER 时使用 openssl pkcs8 -topk8 并设置口令。

排障清单

遇到 Expecting: TRUSTED CERTIFICATE,通常是把 DER 当作 PEM 读取,补上 -inform DER。出现 bad decrypt 时,先确认输入私钥口令。转换成功但应用仍拒绝文件时,核对目标要求的是证书 DER、PKCS#8 私钥,还是包含证书链的 PKCS#12,三者不能互换。

OpenSSL 1.1.1 与 3.x 均支持上述核心命令;若旧设备只接受传统 RSA 私钥格式,应先确认兼容要求,再考虑使用 openssl rsa,不要默认降级。

目录与阅读设置

记录一个想法

OpenSSL 证书操作手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通