差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
代码术语:fp [2026/10/13 16:34] – 为 FP 页面添加结构总览思维导图 张叶安代码术语:fp [2026/10/13 16:45] (当前版本) – 结构总览章节编号顺延为 13 张叶安
行 163: 行 163:
 | 攻击者指定 ''kid'' 读到任意文件 | ''kid'' 被当成路径 / URL 使用 | ''kid'' 只允许在服务端白名单键表里查 | | 攻击者指定 ''kid'' 读到任意文件 | ''kid'' 被当成路径 / URL 使用 | ''kid'' 只允许在服务端白名单键表里查 |
  
-===== 10. 一句话总结 =====+===== 10. 指纹在哪看、长什么样 ===== 
 + 
 +指纹是算出来的,所以要分两件事看:**取材来源**(对什么算哈希)和**显示形态**(用什么编码写出来)。 
 + 
 +==== 10.1 四种常见形态 ==== 
 + 
 +^ 指纹类型 ^ 长度 ^ 长相 ^ 常见位置 ^ 
 +| SHA-256 十六进制(X.509 证书) | 64 个 hex 字符 | ''3F:1B:9A:E4:...:02'',冒号分隔大写 | 证书详情、keytool、浏览器 | 
 +| SHA-1 十六进制(旧证书) | 40 个 hex 字符 | ''0A:1B:2C:...:9F'',冒号分隔大写 | 老证书、''x5t'' | 
 +| base64url 无填充 | 43 个字符 | ''uNiVztksCsDhcc0u9e8BujQXVUpKZIDTMczCvj3tD2s'' | SSH、''jkt''、很多 ''kid'' | 
 +| MD5 十六进制(更老) | 32 个 hex 字符 | ''3f:6b:2c:...'',冒号分隔小写 | 早期 SSH 提示 | 
 + 
 +换算记一下:**SHA-256 摘要固定 32 字节** → 写成 hex 是 64 个字符、写成 base64url 是 43 个字符;**SHA-1 摘要 20 字节** → hex 是 40 个字符。所以看段数就能猜算法:32 组冒号分隔是 SHA-256,20 组是 SHA-1。 
 + 
 +==== 10.2 SSH 公钥指纹 ==== 
 + 
 +<code bash> 
 +ssh-keygen -lf ~/.ssh/id_ed25519.pub 
 +# 256 SHA256:uNiVztksCsDhcc0u9e8BujQXVUpKZIDTMczCvj3tD2s alice@example.com (ED25519) 
 + 
 +ssh-keygen -lf ~/.ssh/id_rsa.pub -E md5     # 换回旧的 MD5 格式 
 +</code> 
 + 
 +首次连接陌生主机会弹出来让你核对: 
 + 
 +<code> 
 +The authenticity of host 'github.com (140.82.113.4)' can't be established. 
 +ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU. 
 +</code> 
 + 
 +GitHub 的 ED25519 / ECDSA / RSA 三条官方指纹公布在其官方文档里,核对时以官方页面为准(本站 [[ssh]] 页面也讲过指纹校验)。 
 + 
 +==== 10.3 X.509 证书指纹(''x5t'' 的来源) ==== 
 + 
 +<code bash> 
 +openssl x509 -in cert.pem -noout -fingerprint -sha256 
 +# SHA256 Fingerprint=3F:1B:9A:E4:... 
 + 
 +openssl x509 -in cert.pem -noout -fingerprint -sha1      # 对应旧的 x5t 
 +</code> 
 + 
 +Java 密钥库里的指纹: 
 + 
 +<code bash> 
 +keytool -list -v -keystore truststore.jks | grep -A2 Fingerprint 
 +</code> 
 + 
 +浏览器里的入口:Chrome 打开开发者工具的 **Security** 面板 → View certificate,或在地址栏访问 %%chrome://certificate-manager%%;Firefox 点地址栏的锁图标 → 查看证书 → 详细信息。 
 + 
 +==== 10.4 JWT / JWKS 里的指纹 ==== 
 + 
 +**① 看 JWKS 端点**(指纹常被直接拿来当 ''kid''): 
 + 
 +<code bash> 
 +curl -s https://example.com/.well-known/jwks.json 
 +</code> 
 + 
 +<code json> 
 +{ 
 +  "keys": [ 
 +    { 
 +      "kty": "RSA", 
 +      "use": "sig", 
 +      "alg": "RS256", 
 +      "kid": "cn-I_WNMClehiVp51i_0VpOENW1upEerA8sEam5hn-s", 
 +      "n": "0vx7agoebGcQ...", 
 +      "e": "AQAB" 
 +    } 
 +  ] 
 +} 
 +</code> 
 + 
 +那个 43 个字符的 ''kid'' 就是 JWK Thumbprint 的长相。如果你离线按 RFC 7638 算出来的值与它完全一致,就能确认它是这么生成的。 
 + 
 +**② 解 header 看 ''kid''**: 
 + 
 +<code bash> 
 +node -e "console.log(JSON.parse(Buffer.from(process.argv[1].split('.')[0],'base64url')))" "$TOKEN" 
 +</code> 
 + 
 +<code json> 
 +{ "alg": "RS256", "kid": "cn-I_WNMClehiVp51i_0VpOENW1upEerA8sEam5hn-s" } 
 +</code> 
 + 
 +**③ 令牌里带 ''x5c'' / ''jwk'' 时**,可以现算指纹来核对: 
 + 
 +<code bash> 
 +openssl x509 -in from-x5c.pem -noout -fingerprint -sha256 
 +</code> 
 + 
 +==== 10.5 自己算一个 ==== 
 + 
 +<code bash> 
 +# 公钥指纹:SPKI DER 的 SHA-256,再 base64 
 +openssl pkey -in key.pem -pubout -outform DER \ 
 +  | openssl dgst -sha256 -binary | openssl base64 
 +</code> 
 + 
 +注意:JWK Thumbprint **不能**用上面这条命令,它必须按 RFC 7638 的规范 JSON 来算(见第 4 节的 ''jose'' 写法)。 
 + 
 +==== 10.6 必须记住的坑:同一把公钥,三种指纹互不相等 ==== 
 + 
 +  * **SPKI DER 的 SHA-256**:上面那条 openssl 命令算出来的 
 +  * **RFC 7638 JWK Thumbprint**:''jkt'' 与相当多 ''kid'' 采用它 
 +  * **X.509 证书指纹**:对整张证书算,含签发者、有效期等元数据,''x5t#S256'' 用它 
 + 
 +三者针对同一把密钥会给出**完全不同的字符串**。所以比对指纹前先确认三件事:**对什么算(JWK / SPKI / 整张证书)、用什么哈希(SHA-256 / SHA-1)、用什么编码(hex / base64url)**。对不上时先怀疑口径不一致,再怀疑密钥错了。 
 + 
 +===== 11. 指纹的几种作用:只有一种是在「选密钥」 ===== 
 + 
 +常见的一个简化理解是:**指纹就是用来告诉后端该用哪把密钥的**。方向没错,但不够准确 —— 指纹的职责是**标识**,「选密钥」只是标识最主流的用法之一。 
 + 
 +先拆开两个容易混的东西: 
 + 
 +^ 东西 ^ 职责 ^ 是否必须是指纹 ^ 
 +| ''kid'' 字段 | 告诉后端用哪把密钥 | 不是,任意字符串都可以,如 ''key-1''、''2011-04-29'' | 
 +| 指纹 | 把某把密钥 / 证书 / 令牌压成一个短且可比较的字符串 | 它常被填进 ''kid'',但也可以用在别处 | 
 + 
 +也就是说:**真正决定「用哪把密钥」的是 ''kid'' 字段加服务端白名单键表**,指纹只是 ''kid'' 最常见的一种取值方式。人工给密钥起个名字,一样能选密钥。 
 + 
 +接下来看指纹的实际用途,只有第一行是在挑密钥: 
 + 
 +^ 用法 ^ 实际在干什么 ^ 属于「选密钥」吗 ^ 
 +| ''kid'' = 公钥指纹 | 在 JWKS / 本地键表里匹配出对应密钥,再验签或解密 | **是**,这是最主流的用法 | 
 +| ''jkt''(DPoP) | 校验「proof 所用公钥」与「token 里记下的公钥」是不是同一把 | 不是,属**绑定一致性校验** | 
 +| ''x5t#S256'' | 核对令牌带来的证书是不是预期的那张(pinning) | 不是,属**核对 / 防替换** | 
 +| refresh token 的哈希指纹 | 库里只存哈希,比对判断令牌有没有被重复使用 | 不是,属**安全存储 + 重放检测** | 
 +| 设备指纹 | 风控维度,换设备就降级或要求二次验证 | 不是,与密钥无关 | 
 +| JWKS 里的 ''kid'' | 给公钥一个稳定索引,便于轮换与日志审计 | 算沾边,目的是「区分」而不是「挑选」 | 
 + 
 +两点必须记住: 
 + 
 +  * **指纹不证明密钥可信**:公钥指纹谁都能算,攻击者也能把自己公钥的指纹填进 ''kid'' 来「选」密钥。所以 ''kid'' 是**不可信输入**,只能拿去白名单里查,不能拿去拼文件路径、SQL、URL 
 +  * **指纹不提供保密性**:它不参与任何加解密运算,拿到指纹推不出密钥,也不影响密文安全 
 + 
 +更准确的一句话总结是: 
 + 
 +> 在 JWT 加密里,指纹就是一个**标识符**:把「某把密钥、某张证书、某个令牌」变成一串可比较的短字符串。它**最常**被用来回答「该用哪把密钥」(填进 ''kid''),但这并非唯一用途 —— 做绑定(''jkt'')、做核对(''x5t'')、做安全存储(令牌哈希)时,它并没有在选密钥。 
 + 
 +最后一句反过来的推论:**如果只有一把密钥、而且从不轮换,''kid'' 和指纹都可以省掉** —— 指纹存在的全部前提,是「有多个东西需要区分或绑定」。 
 + 
 +===== 12. 一句话总结 =====
  
 > JWT 加密语境里的 ''FP'' 就是**指纹**:它不参与加密运算,只负责**给公钥、证书或令牌内容发一张「身份证」**,让密钥匹配(''kid'')、令牌绑定(''jkt'')和泄露排查变得可自动化。标准里对应的是 RFC 7638 的 JWK Thumbprint,以及 ''x5t#S256'' 这类证书指纹。 > JWT 加密语境里的 ''FP'' 就是**指纹**:它不参与加密运算,只负责**给公钥、证书或令牌内容发一张「身份证」**,让密钥匹配(''kid'')、令牌绑定(''jkt'')和泄露排查变得可自动化。标准里对应的是 RFC 7638 的 JWK Thumbprint,以及 ''x5t#S256'' 这类证书指纹。
  
-===== 11. 结构总览 =====+===== 13. 结构总览 =====
  
 下面这张图把全篇串一遍(可缩放、拖拽、点击折叠): 下面这张图把全篇串一遍(可缩放、拖拽、点击折叠):
行 224: 行 365:
 - 指纹不是秘密,也不是身份凭据 - 指纹不是秘密,也不是身份凭据
 ``` ```
 +
 +----
 +
 +返回:[[代码术语]]
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/fp.1791880493.txt.gz
  • 最后更改: 2026/10/13 16:34
  • 由 张叶安