差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| 代码术语:blk [2026/10/13 17:19] – 创建 张叶安 | 代码术语:blk [2026/10/13 17:21] (当前版本) – 为 blk 词条添加思维导图 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== 一文讲清楚:blk ====== |
| + | |||
| + | 先说结论:**'' | ||
| + | |||
| + | ===== 1. blk 的常见含义 ===== | ||
| + | |||
| + | ^ 语境 ^ blk 指什么 ^ 例子 ^ | ||
| + | | 通用代码 | block:块、代码块、数据块 | 分块读取、'' | ||
| + | | 安全 / 鉴权 | blacklist / blocklist:黑名单 | 令牌黑名单、IP 黑名单(现多写作 blocklist / denylist) | | ||
| + | | Linux 内核 / 系统 | 块设备层 | '' | ||
| + | | 磁盘与文件系统 | 块数 | '' | ||
| + | | 二进制 / 文件格式 | 以块为单位的数据文件 | 区块链的 '' | ||
| + | | 前端 / 排版 | block:块级元素 | '' | ||
| + | |||
| + | 一句话:**看到 '' | ||
| + | |||
| + | ===== 2. JWT 里的 blk:规范中没有 ===== | ||
| + | |||
| + | JWT 的标准字段是很短的封闭清单: | ||
| + | |||
| + | * **标准 claim(RFC 7519)**:'' | ||
| + | * **标准 header(RFC 7515)**:'' | ||
| + | |||
| + | 两张清单里都没有 '' | ||
| + | |||
| + | ^ 情况 ^ 说明 ^ 怎么判断 ^ | ||
| + | | ① 令牌黑名单的变量名 / 存储键 | 表示已被撤销的令牌,常写作 Redis 键 '' | ||
| + | | ② 自定义 header / claim | 业务自己塞进令牌的私有字段 | 解开令牌能解出来,但没有任何标准库会替你校验 | | ||
| + | | ③ 形近字段看错 | '' | ||
| + | | ④ 与 JWT 无关 | 同一段代码 / 日志里恰好有 '' | ||
| + | |||
| + | ==== 先确认它出现在哪一段 ==== | ||
| + | |||
| + | JWT 的三段都是 base64url,明文可读,解出来一看就知道: | ||
| + | |||
| + | <code bash> | ||
| + | TOKEN=' | ||
| + | # 打印 header 与 payload | ||
| + | node -e "for (const i of [0,1]) console.log(Buffer.from(process.argv[1].split(' | ||
| + | </ | ||
| + | |||
| + | * 解出来的 JSON 里有 '' | ||
| + | * 解出来只有 '' | ||
| + | * 令牌里根本没有 '' | ||
| + | |||
| + | ===== 3. 用法一:黑名单(blocklist)做令牌撤销 ===== | ||
| + | |||
| + | 这是 JWT 场景下 '' | ||
| + | |||
| + | JWT 是无状态的:签发之后只要还没到 '' | ||
| + | |||
| + | * 撤销时把该令牌的 '' | ||
| + | * 令牌没有 '' | ||
| + | * 服务端校验顺序变成:验签 → 查 '' | ||
| + | * 黑名单键必须设「到 '' | ||
| + | |||
| + | 代价与替代方案: | ||
| + | |||
| + | ^ 做法 ^ 效果 ^ 代价 ^ | ||
| + | | 短 access + 可撤销 refresh | 撤销只作用于 refresh,access 等它自然过期 | 有几到十几分钟的「踢不干净」窗口,最常用 | | ||
| + | | 黑名单('' | ||
| + | | 令牌版本号 '' | ||
| + | | 会话表 '' | ||
| + | |||
| + | > 结论:**黑名单是「用状态换即时性」的补救手段**,不是 JWT 的常规配置。能用「短 access + refresh 轮换」解决,就别急着上黑名单;更多撤销方案见 [[jwt|JWT]] 页面的「撤销:JWT 的固有短板」一节。 | ||
| + | |||
| + | ===== 4. 用法二:自定义 claim / header 里的 blk ===== | ||
| + | |||
| + | 如果是你们自己的令牌里带了 '' | ||
| + | |||
| + | * **语义由你们自己定义**:规范不管、库也不认。跨系统对接时建议加命名空间(如 '' | ||
| + | * **必须自己校验**:签名只保证「内容没被改过」,不保证「值合理」。漏掉业务校验,等于把开关交给客户端 | ||
| + | * **payload 是明文**:只是 base64url 编码,不是加密,别放密钥、手机号等敏感值(见 [[代码术语: | ||
| + | |||
| + | 常见的塞法是把「黑名单版本号」写进声明(如 '' | ||
| + | |||
| + | ===== 5. 易混淆对照 ===== | ||
| + | |||
| + | ^ 名字 ^ 是什么 ^ 出现在哪 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | ===== 6. 常见坑速查 ===== | ||
| + | |||
| + | ^ 现象 ^ 原因 ^ 处理方向 ^ | ||
| + | | 以为令牌里有个标准 '' | ||
| + | | 黑名单越存越大 | 没按 '' | ||
| + | | 把令牌原文存进黑名单 | 泄库即等于泄露可用令牌 | 只存 '' | ||
| + | | 以为 JWT 天生能即时失效 | 无状态,签发后无法撤回 | 接受短 access 的窗口,或引入黑名单 / 版本号 | | ||
| + | | 客户端能自己改 '' | ||
| + | | 黑名单查询放在验签之前 | 未验签的内容不可信,可被构造利用 | 顺序固定:验签 → 时效 → 受众 → 黑名单 | | ||
| + | |||
| + | ===== 7. 一句话总结 ===== | ||
| + | |||
| + | > '' | ||
| + | |||
| + | 相关:[[jwt|JWT]] · [[代码术语: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | 返回:[[代码术语]] | ||
| + | |||
| + | ```mdk height=560 color=# | ||
| + | # blk(JWT 里的 blk) | ||
| + | |||
| + | ## 一句话 | ||
| + | ### block / blacklist 的缩写 | ||
| + | ### 语义取决于出现的语境 | ||
| + | ### JWT 规范里没有 blk 字段 | ||
| + | |||
| + | ## 常见含义 | ||
| + | ### 通用代码:block 块、代码块 | ||
| + | ### 安全:blacklist / blocklist 黑名单 | ||
| + | ### 内核:blk_ 符号、blk-mq、/ | ||
| + | ### 磁盘:ls -s / du 的 blocks 块数 | ||
| + | ### 文件格式:blk 数据块文件 | ||
| + | ### 前端:display: | ||
| + | |||
| + | ## JWT 里的四种可能 | ||
| + | ### ①令牌黑名单的变量名或 Redis 键 | ||
| + | ### ②自定义 header / claim | ||
| + | ### ③形近字段看错:kid、jti | ||
| + | ### ④与 JWT 无关,恰好同名 | ||
| + | |||
| + | ## 怎么确认 | ||
| + | ### base64url 解出 header 与 payload | ||
| + | ### 令牌里有 → 私有字段 | ||
| + | ### 只有 kid / jti → 看错了 | ||
| + | ### 令牌里没有 → 去服务端代码搜 | ||
| + | |||
| + | ## 用法一:黑名单撤销 | ||
| + | ### 撤销时把 jti 写进 Redis | ||
| + | ### 键如 blk:< | ||
| + | ### 没有 jti 就存令牌哈希 | ||
| + | ### 校验顺序:验签 → 时效 → 受众 → 黑名单 | ||
| + | ### 代价:重新变成有状态,每次多查一次 | ||
| + | ### 替代:短 access + refresh 轮换 | ||
| + | |||
| + | ## 用法二:自定义 claim | ||
| + | ### 语义自己定,跨系统加命名空间 | ||
| + | ### 必须自己校验,签名不保证值合理 | ||
| + | ### payload 明文,别放敏感值 | ||
| + | ### 常见:把黑名单版本号写进声明 | ||
| + | |||
| + | ## 易混淆 | ||
| + | ### kid:密钥 ID,常放公钥指纹 | ||
| + | ### jti:令牌唯一 ID,黑名单与日志用 | ||
| + | ### blk(安全):黑名单 | ||
| + | ### blk(系统):块、块设备 | ||
| + | ### kid 与指纹:字段 vs 取值方式 | ||
| + | |||
| + | ## 常见坑 | ||
| + | ### 以为有标准 blk 声明 | ||
| + | ### 黑名单不设 TTL 会无限膨胀 | ||
| + | ### 存令牌原文而非哈希 | ||
| + | ### 以为 JWT 能即时失效 | ||
| + | ### 客户端能改 blk 说明没校验 | ||
| + | ### 黑名单查询放在验签之前 | ||
| + | |||
| + | ## 记住这句 | ||
| + | ### JWT 里没有 blk 字段 | ||
| + | ### 多半指令牌黑名单机制 | ||
| + | ### 用状态换即时失效,先权衡 | ||
| + | ``` | ||