密码学与证书 / 系统课时

区分密钥编码格式

区分密钥编码格式

同一把 Ed25519 密钥可能表现为 32 字节数组、JWK 文本或 PEM 文件,直接比较长度很容易误判。本篇按密钥材料、容器和文本编码三层拆解格式,并用导出和恢复程序验证哪些变化只是表示变化。

学习目标

  • 区分原始密钥材料、标准容器与文本表示。
  • 识别 seed、公钥和库私钥的不同含义。
  • 使用库导入导出检查格式往返一致性。

先问这些字节代表什么

32 字节可以是 Ed25519 seed,也可以是原始公钥;64 字节可以是签名,也可能是某个库的私钥表示。长度无法说明用途。交换时应同时说明算法、材料类型、容器类型与编码,并避免含糊的 key 字段。

libsodium 的 64 字节 secret key 包含 seed 和公钥。其他库可能接受 seed 或保有内部对象,不得把 libsodium 布局套到所有生态。应使用该库的导出与提取接口转换,而不靠截取尾部、猜测前缀或复制内存表示。

容器和编码解决不同问题

PKCS#8 表示私钥容器,SPKI 表示公钥容器,DER 是它们常用的二进制编码。PEM 在 DER 外加文本边界和 Base64。将 PEM 的正文 Base64 解码,通常得到容器字节,不会自动得到原始 32 字节 seed 或公钥。

Ed25519 的算法 OID 为 1.3.101.112,相关算法标识参数必须缺省,不能随意加入 ASN.1 NULL。RFC 8410给出了容器规则;标准解析器比“去掉固定长度头部”的手工方法更可靠。

表示 内容与用途 不能据此推断
原始公钥 32 字节编码点 不含主体身份
原始 seed 32 字节秘密 不是直接点乘标量
PKCS#8 / SPKI 带算法信息的容器 容器长度不等于原始长度
PEM 容器的文本表示 Base64 不提供加密
JWK 带类型字段的 JSON 不能只看 x 或 d 的字符串长度

使用真实导出检查往返

以下完整程序保存为 key-formats.cjs,执行 node key-formats.cjs。它只输出长度和比较结果,避免把演示的秘密当作可以公开的业务日志。

js
const { generateKeyPairSync, createPublicKey, createPrivateKey } = require('node:crypto');
const { privateKey, publicKey } = generateKeyPairSync('ed25519');
const secretJwk = privateKey.export({ format: 'jwk' });
const publicDer = publicKey.export({ type: 'spki', format: 'der' });
const privateDer = privateKey.export({ type: 'pkcs8', format: 'der' });
// JWK的x与d是Base64url表示;d属于秘密,不能打印。
console.log('JWK type:', secretJwk.kty, secretJwk.crv);
console.log('raw public bytes:', Buffer.from(secretJwk.x, 'base64url').length);
console.log('seed bytes:', Buffer.from(secretJwk.d, 'base64url').length);
console.log('SPKI larger:', publicDer.length > 32);
console.log('PKCS8 larger:', privateDer.length > 32);
// 让标准解析器恢复容器,再比较真实密钥。
console.log('public round trip:', createPublicKey({ key: publicDer,
  format: 'der', type: 'spki' }).equals(publicKey));
console.log('private round trip:', createPrivateKey({ key: privateDer,
  format: 'der', type: 'pkcs8' }).equals(privateKey));

预期输出:

text
JWK type: OKP Ed25519
raw public bytes: 32
seed bytes: 32
SPKI larger: true
PKCS8 larger: true
public round trip: true
private round trip: true

这里的 JWK 私钥 d 表示 seed,公钥 x 表示编码点;其具体规则见 RFC 8037。JWK 中 x 的命名不能套成普通椭圆曲线仿射横坐标解释。

接口必须拒绝含糊格式

对接时推荐固定一种容器,例如公钥采用 SPKI PEM,签名采用无填充 Base64url。原始格式也可以使用,但必须显式声明字节含义与长度,并禁止根据长度自动尝试多个密钥类型。

解析后检查真实算法类型,再与注册表中的算法和用途比较。记录公钥指纹可以帮助定位错密钥,但指纹本身不是信任证明。不要因为两个字符串格式不同就生成新密钥,也不要因为它们长度相同就认为密钥一致。

私钥转换时尤其需要避免临时输出泄露。转换后的 JSON、终端历史与调试附件都可能携带 seed。优先在受控进程中调用库导出与导入,并通过公钥或签名往返验证结果。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

区分密钥编码格式

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

登录哪都通