跳到主要内容
ecdsa.com
JOSE、JWK 与 COSE

JWK 参数、密钥类型与曲线

本页收录 IANA JOSE 注册表中的 JSON Web Key(JWK)成员、kty(密钥类型)值和 crv(曲线)名称,并标明哪些成员携带私钥材料,因而绝不能公开发布。

显示 42 项中的 42 项

JWK 参数 · 29 个条目

JSON Web Key 的成员、使用这些成员的密钥类型,以及哪些成员携带私钥材料。

名称说明私钥材料参考文献
algalg:Algorithm。适用的密钥类型:*。否RFC 7517, Section 4.4
crvcrv:Curve。适用的密钥类型:EC, OKP。否RFC 7518, Section 6.2.1.1RFC 8037, Section 2
d说明d:ECC Private Key。适用的密钥类型:EC, RSA, OKP。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 7518, Section 6.2.2.1RFC 7518, Section 6.3.2.1RFC 8037, Section 2
dpdp:First Factor CRT Exponent。适用的密钥类型:RSA。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 7518, Section 6.3.2.4
dqdq:Second Factor CRT Exponent。适用的密钥类型:RSA。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 7518, Section 6.3.2.5
ee:Exponent。适用的密钥类型:RSA。否RFC 7518, Section 6.3.1.2
expexp:Expiration Time, as defined in [RFC 7519]。适用的密钥类型:*。否OpenID Federation 1.0, Section 8.7.2
extext:Extractable。适用的密钥类型:*。否W3C Web Cryptography API
iatiat:Issued At, as defined in [RFC 7519]。适用的密钥类型:*。否OpenID Federation 1.0, Section 8.7.2
kk:Key Value。适用的密钥类型:oct。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 7518, Section 6.4.1
key_opskey_ops:Key Operations。适用的密钥类型:*。否RFC 7517, Section 4.3
kid说明kid:Key ID。适用的密钥类型:*。否RFC 7517, Section 4.5
ktykty:Key Type。适用的密钥类型:*。否RFC 7517, Section 4.1
nn:Modulus。适用的密钥类型:RSA。否RFC 7518, Section 6.3.1.1
nbfnbf:Not Before, as defined in [RFC 7519]。适用的密钥类型:*。否OpenID Federation 1.0, Section 8.7.2
othoth:Other Primes Info。适用的密钥类型:RSA。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 7518, Section 6.3.2.7
pp:First Prime Factor。适用的密钥类型:RSA。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 7518, Section 6.3.2.2
privpriv:Private key。适用的密钥类型:AKP。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 9964
pubpub:Public key。适用的密钥类型:AKP。否RFC 9964
qq:Second Prime Factor。适用的密钥类型:RSA。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 7518, Section 6.3.2.3
qiqi:First CRT Coefficient。适用的密钥类型:RSA。它携带私钥材料,绝不能包含在公开发布的 JWK 集内。是RFC 7518, Section 6.3.2.6
revokedrevoked:Revoked Key Properties。适用的密钥类型:*。否OpenID Federation 1.0, Section 8.7.2
useuse:Public Key Use。适用的密钥类型:*。否RFC 7517, Section 4.2
xx:X Coordinate。适用的密钥类型:EC, OKP。否RFC 7518, Section 6.2.1.2RFC 8037, Section 2
x5cx5c:X.509 Certificate Chain。适用的密钥类型:*。否RFC 7517, Section 4.7
x5tx5t:X.509 Certificate SHA-1 Thumbprint。适用的密钥类型:*。否RFC 7517, Section 4.8
x5t#S256x5t#S256:X.509 Certificate SHA-256 Thumbprint。适用的密钥类型:*。否RFC 7517, Section 4.9
x5ux5u:X.509 URL。适用的密钥类型:*。否RFC 7517, Section 4.6
yy:Y Coordinate。适用的密钥类型:EC。否RFC 7518, Section 6.2.1.3

来源:JSON Object Signing and Encryption (JOSE)(IANA),获取于 2026-10-20。数据许可证:CC0-1.0。 JSON Web Key Parameters

重要条目说明

d

“d”是私钥:可以是 ECC 私钥标量、RSA 私钥指数或 OKP 私钥。

含有“d”的 JWK 就是私钥,绝不能出现在公开发布的 JWK Set 中,也绝不能发送给第三方服务。ecdsa.com 的工具会拒绝含有“d”的 JWK。RSA 的其他私钥成员(p、q、dp、dq、qi、oth)以及对称密钥的“k”同样需要保密。

kid

“kid”是密钥的名称,供验证方从 JWK Set 中找出对应的密钥;它本身不具有任何安全含义。

JWS 头部中的 kid 会与颁发者 JWKS 中各个密钥的 kid 比对(RFC 7517 §4.5)。取值由应用自行定义,常见的做法是使用 RFC 7638 指纹。轮换密钥时如果不更换 kid,缓存中会留下旧密钥,导致签名验证失败。

JWK 密钥类型 · 5 个条目

JWK kty 成员的已注册值。

名称说明要求参考文献
AKPAlgorithm Key PairOptionalRFC 9964
ECElliptic CurveRecommended+RFC 7518, Section 6.2
octOctet sequenceRequiredRFC 7518, Section 6.4
OKPOctet string key pairsOptionalRFC 8037, Section 2
RSARSARequiredRFC 7518, Section 6.3

来源:JSON Object Signing and Encryption (JOSE)(IANA),获取于 2026-10-20。数据许可证:CC0-1.0。 JSON Web Key Types

JWK 曲线 · 8 个条目

JWK crv 成员的已注册值。

名称说明要求参考文献
Ed25519Ed25519 signature algorithm key pairsedwards25519OptionalRFC 8037, Section 3.1
Ed448Ed448 signature algorithm key pairsedwards448OptionalRFC 8037, Section 3.1
P-256P-256 CurveP-256Recommended+RFC 7518, Section 6.2.1.1
P-384P-384 CurveP-384OptionalRFC 7518, Section 6.2.1.1
P-521P-521 CurveP-521OptionalRFC 7518, Section 6.2.1.1
secp256k1SECG secp256k1 curvesecp256k1OptionalRFC 8812, Section 3.1
X25519X25519 function key pairscurve25519OptionalRFC 8037, Section 3.2
X448X448 function key pairscurve448OptionalRFC 8037, Section 3.2

来源:JSON Object Signing and Encryption (JOSE)(IANA),获取于 2026-10-20。数据许可证:CC0-1.0。 JSON Web Key Elliptic Curve

全部注册表