密码学与证书 / 系统课时
区分密钥编码格式
区分密钥编码格式
同一把 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。它只输出长度和比较结果,避免把演示的秘密当作可以公开的业务日志。
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));预期输出:
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。优先在受控进程中调用库导出与导入,并通过公钥或签名往返验证结果。