代码术语:blk

差别

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

到此差别页面的链接

后一修订版
前一修订版
代码术语:blk [2026/10/13 17:19] – 创建 张叶安代码术语:blk [2026/10/13 17:21] (当前版本) – 为 blk 词条添加思维导图 张叶安
行 1: 行 1:
-1+====== 一文讲清楚:blk ====== 
 + 
 +先说结论:**''blk'' 不是一个含义固定的词,它只是 ''block'' 或 ''blacklist / blocklist'' 的缩写**,具体意思完全取决于它出现在哪一层。而在 JWT 这个语境里更要先说清一件事:**JWT / JOSE 规范里根本没有 ''blk'' 这个字段** —— 你看到的 ''blk'',要么是自己系统里的私有命名(黑名单机制、自定义声明),要么干脆是 ''kid''、''jti'' 看错了。 
 + 
 +===== 1. blk 的常见含义 ===== 
 + 
 +^ 语境 ^ blk 指什么 ^ 例子 ^ 
 +| 通用代码 | block:块、代码块、数据块 | 分块读取、''blk = buffer.slice(0, 512)'' | 
 +| 安全 / 鉴权 | blacklist / blocklist:黑名单 | 令牌黑名单、IP 黑名单(现多写作 blocklist / denylist) | 
 +| Linux 内核 / 系统 | 块设备层 | ''blk_'' 系列符号、''blk-mq''、''/sys/block''、命令 ''blkid'' | 
 +| 磁盘与文件系统 | 块数 | ''ls -s''、''du'' 输出里的 blocks | 
 +| 二进制 / 文件格式 | 以块为单位的数据文件 | 区块链的 ''blk00000.dat'' | 
 +| 前端 / 排版 | block:块级元素 | ''display: block''(与 inline 相对) | 
 + 
 +一句话:**看到 ''blk'' 先看它所在的层** —— 系统层多半是「块」,安全层多半是「黑名单」,鉴权层则几乎一定和「撤销 / 拒绝」有关。 
 + 
 +===== 2. JWT 里的 blk:规范中没有 ===== 
 + 
 +JWT 的标准字段是很短的封闭清单: 
 + 
 +  * **标准 claim(RFC 7519)**:''iss''、''sub''、''aud''、''exp''、''nbf''、''iat''、''jti'' 
 +  * **标准 header(RFC 7515)**:''alg''、''kid''、''jku''、''jwk''、''typ''、''cty''、''crit''、''x5u''、''x5c''、''x5t''、''x5t#S256'' 
 + 
 +两张清单里都没有 ''blk''。所以「JWT 的 ''blk''」只可能是下面四种情况之一: 
 + 
 +^ 情况 ^ 说明 ^ 怎么判断 ^ 
 +| ① 令牌黑名单的变量名 / 存储键 | 表示已被撤销的令牌,常写作 Redis 键 ''blk:<jti>'' 或变量 ''blkList'' | 只出现在服务端代码、Redis、日志里,令牌本体没有 | 
 +| ② 自定义 header / claim | 业务自己塞进令牌的私有字段 | 解开令牌能解出来,但没有任何标准库会替你校验 | 
 +| ③ 形近字段看错 | ''kid''(密钥 ID,常放公钥指纹)、''jti''(令牌唯一 ID) | 令牌里实际写的是 ''kid'' 或 ''jti'' | 
 +| ④ 与 JWT 无关 | 同一段代码 / 日志里恰好有 ''blk'' | 解出来完全没有它 | 
 + 
 +==== 先确认它出现在哪一段 ==== 
 + 
 +JWT 的三段都是 base64url,明文可读,解出来一看就知道: 
 + 
 +<code bash> 
 +TOKEN='eyJ...' 
 +# 打印 header 与 payload 
 +node -e "for (const i of [0,1]) console.log(Buffer.from(process.argv[1].split('.')[i],'base64url').toString())" "$TOKEN" 
 +</code> 
 + 
 +  * 解出来的 JSON 里有 ''blk'' → 情况 ②,是自定义字段 
 +  * 解出来只有 ''kid'' / ''jti''、没有 ''blk'' → 情况 ③,看错了 
 +  * 令牌里根本没有 ''blk'' → 情况 ① 或 ④,去服务端代码里搜 ''blk'' 才找得到 
 + 
 +===== 3. 用法一:黑名单(blocklist)做令牌撤销 ===== 
 + 
 +这是 JWT 场景下 ''blk'' 最可能的含义。 
 + 
 +JWT 是无状态的:签发之后只要还没到 ''exp'',验签通过就能用,**服务端说不了「不」**。想「立刻踢下线」,就必须额外记一份黑名单: 
 + 
 +  * 撤销时把该令牌的 ''jti'' 写入 Redis(键如 ''blk:<jti>''),''TTL'' 设为 ''exp − now'' 
 +  * 令牌没有 ''jti'' 时,退而求其次存**整串令牌的哈希**(不要存原文,防泄库;见 [[代码术语:digest|digest]]) 
 +  * 服务端校验顺序变成:验签 → 查 ''exp'' / ''nbf'' → 查 ''iss'' / ''aud'' → **查黑名单** → 注入身份 
 +  * 黑名单键必须设「到 ''exp'' 就自动消失」的过期时间,否则它会无限膨胀 
 + 
 +代价与替代方案: 
 + 
 +^ 做法 ^ 效果 ^ 代价 ^ 
 +| 短 access + 可撤销 refresh | 撤销只作用于 refresh,access 等它自然过期 | 有几到十几分钟的「踢不干净」窗口,最常用 | 
 +| 黑名单(''jti'') | 能精确撤销单个令牌 | JWT 重新变成有状态,每次请求多一次查询 | 
 +| 令牌版本号 ''tokenVersion'' | 改一个值即全端下线 | 每次请求要读一次用户信息(可缓存) | 
 +| 会话表 ''sid'' | 支持「查看登录设备」逐台踢 | 已接近 Session 方案 | 
 + 
 +> 结论:**黑名单是「用状态换即时性」的补救手段**,不是 JWT 的常规配置。能用「短 access + refresh 轮换」解决,就别急着上黑名单;更多撤销方案见 [[jwt|JWT]] 页面的「撤销:JWT 的固有短板」一节。 
 + 
 +===== 4. 用法二:自定义 claim / header 里的 blk ===== 
 + 
 +如果是你们自己的令牌里带了 ''blk'',那它就是一枚**私有字段**,规则只有三条: 
 + 
 +  * **语义由你们自己定义**:规范不管、库也不认。跨系统对接时建议加命名空间(如 ''https://example.com/blk'')避免撞名 
 +  * **必须自己校验**:签名只保证「内容没被改过」,不保证「值合理」。漏掉业务校验,等于把开关交给客户端 
 +  * **payload 是明文**:只是 base64url 编码,不是加密,别放密钥、手机号等敏感值(见 [[代码术语:payload|payload]]) 
 + 
 +常见的塞法是把「黑名单版本号」写进声明(如 ''blk: 7''),用户表里存当前版本,对不上就拒绝 —— 这就是上面表格里的令牌版本号方案。 
 + 
 +===== 5. 易混淆对照 ===== 
 + 
 +^ 名字 ^ 是什么 ^ 出现在哪 ^ 
 +| ''kid'' | 密钥 ID,实践里常直接放公钥指纹 | JWS / JWE 的 header、JWK | 
 +| ''jti'' | 令牌唯一 ID,黑名单与日志追踪用它 | JWT payload(claim) | 
 +| ''blk''(安全语境) | blacklist / blocklist 黑名单 | 服务端代码、Redis、日志 | 
 +| ''blk''(系统语境) | block 块、块设备 | 内核符号、磁盘工具 | 
 +| ''kid'' 与指纹的关系 | ''kid'' 是字段,指纹是它最常见的一种取值方式 | 详见 [[代码术语:fp|FP]] | 
 + 
 +===== 6. 常见坑速查 ===== 
 + 
 +^ 现象 ^ 原因 ^ 处理方向 ^ 
 +| 以为令牌里有个标准 ''blk'' 声明 | 规范里并没有这个字段 | 先解令牌确认位置,再判断是私有 claim 还是代码变量 | 
 +| 黑名单越存越大 | 没按 ''exp'' 设 TTL,键永不过期 | 写入时就把 TTL 对齐 ''exp'' | 
 +| 把令牌原文存进黑名单 | 泄库即等于泄露可用令牌 | 只存 ''jti'' 或令牌哈希 | 
 +| 以为 JWT 天生能即时失效 | 无状态,签发后无法撤回 | 接受短 access 的窗口,或引入黑名单 / 版本号 | 
 +| 客户端能自己改 ''blk'' 就影响鉴权 | 服务端没校验,直接信了声明 | 私有 claim 一律服务端校验,不信任输入 | 
 +| 黑名单查询放在验签之前 | 未验签的内容不可信,可被构造利用 | 顺序固定:验签 → 时效 → 受众 → 黑名单 | 
 + 
 +===== 7. 一句话总结 ===== 
 + 
 +> ''blk'' 就是 ''block'' 或 ''blacklist / blocklist'' 的缩写;**JWT 规范里没有这个字段**,所以「JWT 的 blk」通常指「令牌黑名单」这套撤销机制(键名、变量名、日志里的缩写),或者你们自己加的私有 claim。用它之前先解令牌确认位置,再按「用状态换即时失效」的代价权衡是否值得。 
 + 
 +相关:[[jwt|JWT]] · [[代码术语:fp|FP(指纹)]] · [[代码术语:payload|payload]] · [[代码术语:digest|digest(摘要)]] 
 + 
 +---- 
 + 
 +返回:[[代码术语]] 
 + 
 +```mdk height=560 color=#e11d48 
 +# blk(JWT 里的 blk) 
 + 
 +## 一句话 
 +### block / blacklist 的缩写 
 +### 语义取决于出现的语境 
 +### JWT 规范里没有 blk 字段 
 + 
 +## 常见含义 
 +### 通用代码:block 块、代码块 
 +### 安全:blacklist / blocklist 黑名单 
 +### 内核:blk_ 符号、blk-mq、/sys/block 
 +### 磁盘:ls -s / du 的 blocks 块数 
 +### 文件格式:blk 数据块文件 
 +### 前端:display: block 
 + 
 +## JWT 里的四种可能 
 +### ①令牌黑名单的变量名或 Redis 键 
 +### ②自定义 header / claim 
 +### ③形近字段看错:kid、jti 
 +### ④与 JWT 无关,恰好同名 
 + 
 +## 怎么确认 
 +### base64url 解出 header 与 payload 
 +### 令牌里有 → 私有字段 
 +### 只有 kid / jti → 看错了 
 +### 令牌里没有 → 去服务端代码搜 
 + 
 +## 用法一:黑名单撤销 
 +### 撤销时把 jti 写进 Redis 
 +### 键如 blk:<jti>,TTL 对齐 exp 
 +### 没有 jti 就存令牌哈希 
 +### 校验顺序:验签 → 时效 → 受众 → 黑名单 
 +### 代价:重新变成有状态,每次多查一次 
 +### 替代:短 access + refresh 轮换 
 + 
 +## 用法二:自定义 claim 
 +### 语义自己定,跨系统加命名空间 
 +### 必须自己校验,签名不保证值合理 
 +### payload 明文,别放敏感值 
 +### 常见:把黑名单版本号写进声明 
 + 
 +## 易混淆 
 +### kid:密钥 ID,常放公钥指纹 
 +### jti:令牌唯一 ID,黑名单与日志用 
 +### blk(安全):黑名单 
 +### blk(系统):块、块设备 
 +### kid 与指纹:字段 vs 取值方式 
 + 
 +## 常见坑 
 +### 以为有标准 blk 声明 
 +### 黑名单不设 TTL 会无限膨胀 
 +### 存令牌原文而非哈希 
 +### 以为 JWT 能即时失效 
 +### 客户端能改 blk 说明没校验 
 +### 黑名单查询放在验签之前 
 + 
 +## 记住这句 
 +### JWT 里没有 blk 字段 
 +### 多半指令牌黑名单机制 
 +### 用状态换即时失效,先权衡 
 +``` 

该主题尚不存在

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

  • 代码术语/blk.1791883183.txt.gz
  • 最后更改: 2026/10/13 17:19
  • 由 张叶安