Bcrypt 72字节限制深度剖析:CVE-2025-22228 高危认证绕过漏洞与全栈加固实战

Bcrypt 72字节限制引发 CVE-2025-22228 高危漏洞,Spring Security 与 Python bcrypt 5.0 行为突变导致生产环境认证异常。本文深度剖析 Blowfish 密钥调度原理、跨语言库兼容性矩阵与字节截断安全隐患,提供 OWASP 合规的预哈希加固方案与平滑升级路径,助你彻底规避认证绕过风险。

🎯 核心技术Bcrypt / Blowfish 密钥调度
⚡ 架构难度资深安全架构级 (Level 3-4)
🚀 核心收益规避认证绕过 / 平滑升级零宕机

导语:Bcrypt 72字节限制自 1999 年算法诞生便已存在,但 2025 年 CVE-2025-22228 的披露与 Python bcrypt 5.0 的拒绝行为升级,正让大量存量系统突然抛出 ValueError 或陷入认证绕过风险。本文从 Blowfish 密钥调度原理出发,横评主流语言库的截断与报错行为,给出字节级检测、预哈希加固与平滑迁移的工业级方案。

📐 Bcrypt 72字节限制引发的认证安全风险全景
企业级安全规范

flowchart TD
    subgraph 接入层 ["表现层与接入网关 (Client & Gateway Tier)"]
        A["用户提交密码 (UTF-8 编码)"] --> B["安全拦截网关 (输入校验)"]
    end
    subgraph 规则层 ["规则编排与上下文层 (Policy & Context Tier)"]
        B --> C{"字节长度 > 72?"}
        C -->|"是"|
        D["策略分支:截断/报错/预哈希"]
        C -->|"否"|
        E["直接进入哈希流程"]
    end
    subgraph 领域层 ["核心执行与改写引擎 (Core Rewriter Tier)"]
        D --> F["Bcrypt 密钥调度 (Blowfish Key Setup)"]
        E --> F
        F --> G["哈希输出 (60 字符)"]
    end
    subgraph 存储层 ["基础设施与数据存储 (Infrastructure Tier)"]
        G --> H[("持久化 DB / 用户凭证表")]
    end
  
图 1: Bcrypt 72字节限制在认证链路中的风险决策点与处理流向

一、Bcrypt 72字节限制的根源:Blowfish 密钥调度

Bcrypt 基于 Blowfish 分组密码,其密钥调度算法(Key Setup)将密码作为密钥输入,而 Blowfish 的 P-array 与 S-box 初始化共需 18 个 32 位子密钥,合计 576 位即 72 字节。这一设计在 Provos 与 Mazières 的原始论文中已被固化,因此 Bcrypt 72字节限制 并非实现缺陷,而是算法基因。超过 72 字节的部分在哈希计算中会被静默丢弃,这意味着两个前 72 字节相同的密码将产生完全相同的哈希值——这正是认证绕过风险的温床。

1.1 字节 vs 字符:多字节编码的陷阱

限制以 UTF-8 字节数为准,而非字符数。一个中文字符占 3 字节,一个 emoji 占 4 字节,19 个 emoji 即达 76 字节,早已越界。更隐蔽的是 JavaScript 的 password.length 返回 UTF-16 码元数,19 个 emoji 返回 38,与真实字节数 76 相去甚远。开发者若按字符数校验,将留下巨大的安全缺口。

语言/环境 正确字节长度计算方式 常见错误
JavaScript / Node.js Buffer.byteLength(password, 'utf8') password.length (UTF-16 码元)
Python len(password.encode('utf-8')) len(password) (字符数)
PHP strlen($password) mb_strlen($password) (字符数)
Go len([]byte(password)) len(password) (字节数,但 string 底层为字节,正确)

二、CVE-2025-22228:Spring Security 认证绕过漏洞

2025 年披露的 CVE-2025-22228(CVSS 7.4)直指 Spring Security 的 BCryptPasswordEncoder.matches() 方法:当用户密码超过 72 字符时,只要前 72 字符匹配,该方法便返回 true。攻击者无需知晓完整密码,仅需提供正确的前 72 字节即可通过认证。受影响的版本已在补丁中改为抛出 IllegalArgumentException,但存量系统若未升级,则持续暴露于认证绕过风险中。

🚨 严重隐患告警

若你的 Spring Security 版本低于补丁版本,且允许用户设置超过 72 字节的密码,攻击者可通过构造前 72 字节相同的密码直接登录任意账户。请立即升级至官方修复版本,并在注册/改密环节强制 72 字节上限。

2.1 Okta 2024 事件:拼接哈希的致命错误

Okta 在 2024 年的安全公告中描述了一个类似场景:缓存键由 bcrypt(userId + username + password) 生成。当用户名长度达到 52 字符以上时,密码部分被推至 72 字节之后,导致缓存登录无需正确密码即可成功。Okta 随后切换至 PBKDF2。这一案例警示:绝不要将密码与其他字段拼接后再交给 Bcrypt,否则密码可能完全落在截断区之外。

三、主流语言库行为横评:静默截断 vs 拒绝报错

不同库对超长密码的处理策略存在代际差异,这是导致“昨天还能跑,今天突然崩”的根本原因。我们实测了以下库的行为:

库/语言 版本 超 72 字节行为 风险等级
Node.js bcrypt 6.0.0 静默忽略多余字节 低(但无感知)
Node.js bcryptjs 3.0.3 静默忽略,提供 bcrypt.truncates() 检测 低
PHP password_hash() 8.0.30+ 静默忽略 低
Python bcrypt 4.0.1 静默忽略 低
Python bcrypt 5.0.0 抛出 ValueError 高(兼容性断裂)
passlib + bcrypt 5.0 1.7.4 所有密码均抛 ValueError(自检失败) 严重
Go x/crypto/bcrypt 当前 GenerateFromPassword 返回 ErrPasswordTooLong 中(需处理错误)
Spring Security BCryptPasswordEncoder 补丁前 静默截断,matches() 可绕过 高危(CVE-2025-22228)
Spring Security BCryptPasswordEncoder 补丁后 抛出 IllegalArgumentException 低
⚠️ 生产避坑风险

Python 生态中,passlib 已停止维护(最后版本 1.7.4 发布于 2020 年),其自检逻辑使用 255 字节测试密码,在 bcrypt 5.0 下必然失败,导致所有密码哈希操作抛出异常。若你的 FastAPI/Flask 项目仍在使用 passlib,升级 bcrypt 至 5.0 将直接导致认证服务不可用。

四、工业级加固方案:从检测到迁移

4.1 方案一:强制 72 字节上限(OWASP 推荐)

在注册与改密环节进行字节级校验,并给出用户友好的提示。这是最简单且符合 OWASP Password Storage Cheat Sheet 的方案。

function assertBcryptLength(password) {
  if (Buffer.byteLength(password, 'utf8') > 72) {
    throw new Error('密码长度不能超过 72 字节(约 72 个英文字符,或更少的中文/emoji)');
  }
}
def check_length(password: str) -> None:
    if len(password.encode("utf-8")) > 72:
        raise ValueError("密码长度不能超过 72 字节(约 72 个英文字符,或更少的中文/emoji)")

4.2 方案二:预哈希 + 胡椒(Pepper)

若需支持任意长度密码,可先使用 HMAC-SHA384 与密钥(Pepper)对密码进行预哈希,再将 Base64 编码后的固定长度结果交给 Bcrypt。OWASP 推荐构造为 bcrypt(base64(hmac-sha384(password, pepper))),其中 Pepper 存储在数据库之外(环境变量或密钥管理服务)。

const crypto = require('crypto');
const bcrypt = require('bcrypt');

function prepare(password) {
  return crypto.createHmac('sha384', process.env.PASSWORD_PEPPER)
    .update(password, 'utf8')
    .digest('base64');
}

const hash = await bcrypt.hash(prepare(password), 12);
const ok = await bcrypt.compare(prepare(password), hash);
import base64, hashlib, hmac, os
import bcrypt

PEPPER = os.environ["PASSWORD_PEPPER"].encode()

def prepare(password: str) -> bytes:
    return base64.b64encode(
        hmac.new(PEPPER, password.encode("utf-8"), hashlib.sha384).digest()
    )

hashed = bcrypt.hashpw(prepare(password), bcrypt.gensalt(rounds=12))
ok = bcrypt.checkpw(prepare(password), hashed)
💡 架构核心决策

预哈希方案必须使用 HMAC 而非裸哈希,且 Pepper 必须与数据库分离存储。裸哈希输出可能包含空字节,某些 Bcrypt 实现会将其视为密码终止符,导致截断;同时裸哈希易受“密码脱壳”(password shucking)攻击。

4.3 方案三:迁移至 Argon2id

Argon2id 是 OWASP 当前首推的密码哈希算法,无 72 字节限制,且内存硬特性使其更抗 GPU 破解。FastAPI 官方教程已从 passlib 迁移至 pwdlib + Argon2id。对于存量 Bcrypt 哈希,可在用户下次登录时验证通过后,透明地重新哈希为 Argon2id。

from pwdlib import PasswordHash

password_hash = PasswordHash.recommended()  # 默认 Argon2id

# 新密码哈希
hashed = password_hash.hash(password)

# 验证旧 Bcrypt 哈希(需安装 bcrypt 包)
import bcrypt
if bcrypt.checkpw(password.encode(), old_hash.encode()):
    # 验证通过,重新哈希为 Argon2id
    new_hash = password_hash.hash(password)
    # 更新数据库

五、升级与应急响应清单

  • 立即排查:检查 Spring Security 版本是否受 CVE-2025-22228 影响,升级至补丁版本。
  • Python 生态:若使用 passlib,立即迁移至 pwdlib 或直接使用 bcrypt 包;短期可固定 bcrypt==4.0.1 争取时间,但需尽快完成迁移。
  • 输入校验:在所有注册/改密接口增加 UTF-8 字节长度校验,拒绝超过 72 字节的密码。
  • 审计拼接哈希:全局搜索 bcrypt( 调用,确保密码是唯一输入,杜绝与用户名、ID 等拼接。
  • 监控告警:对 ValueError: password cannot be longer than 72 bytes 及 IllegalArgumentException 设置日志告警,及时发现兼容性断裂。
⚠️ 生产避坑风险

升级 bcrypt 至 5.0 前,务必在预发环境全量回归认证流程。passlib 的自检失败会导致所有密码操作不可用,而非仅影响长密码用户。建议采用灰度发布,并准备好回滚方案。

原文出处与权威溯源声明:
本文核心技术背景源自海外一线技术研究:
Bcrypt Max Password Length: The 72-Byte Limit Explained (DEV Community)
CVE-2025-22228 参考:Spring Security Advisory

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注