显示页面讨论过去修订反向链接回到顶部 本页面只读。您可以查看源文件,但不能更改它。如果您觉得这是系统错误,请联系管理员。 ====== 一文讲清楚: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 字段 ### 多半指令牌黑名单机制 ### 用状态换即时失效,先权衡 ``` 登录 Detach Close 该主题尚不存在 您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。 代码术语/blk.txt 最后更改: 2026/10/13 17:21由 张叶安 登录