CVE-2026-11800(GHSA-j97h-3f8r-mrjr)的离线差分模型:
由 IdP 公钥支持的 Keycloak JWT 验证器接受了对称
(HMAC)alg 值,从而启用了 RS256→HS256 算法混淆。已在
26.6.4 中修复。教育性、离线、确定性。
西班牙语:README.es.md。练习:PRACTICE.md。
在修复之前,Keycloak 接受使用 IdP 配置的公钥作为密钥的 HMAC 签名。
对于硬编码公钥,HardcodedPublicKeyLoader 通过加载
KeyUtils.loadSecretKey(Base64Url.decode(encodedKey)) 来处理 HS* 算法
(已删除的 diff 第 206 行)。配置值通常是 PemUtils.encodeKey(publicKey),即
不带 PEM 头的 DER SubjectPublicKeyInfo 的 base64,因此 HMAC
密钥正是设计上公开的密钥的 DER 字节。任何
知道公钥的人都可以签署一个能够通过验证的 HS256 断言。验证器
没有阻止它:在修复之前,它只检查 alg 是否为 null
或是否与显式预期的算法不匹配。
修复(diff 第 64-96 行)使 validateSignatureAlgorithm 拒绝
none(不区分大小写),并且除非 isSymmetricAlgorithmAllowed(),
否则要求头部 alg 使用非对称的 ClientSignatureVerifierProvider。
它还从加载器中移除了 HMAC 分支。只有
JWTClientSecretValidator(共享客户端密钥)保留对称
算法。
| 用例 | 修复前(32cdceb8) | 修复后(6d61885f / 8970032a) |
|---|---|---|
p01 HS256,对 DER 进行 HMAC | ACCEPT | REJECT |
p02 HS512,对 DER 进行 HMAC | ACCEPT | REJECT |
n06 HS256,以 PEM 文本为密钥 | BAD_SIGNATURE | REJECT |
n01 RS256 | PROCEEDS_TO_SIGNATURE_CHECK | 相同 |
d01 alg=none(纵深防御) | VALIDATOR_PASS_DOWNSTREAM_UNMODELED | REJECT |
正例仅为 HS256/HS512。HS256 由修复 diff 中的上游测试
testHS256AlgorithmConfusion* 支持(第 253、263-277、279、
321、351、399、408-421、424 行);它们使用
getPublicKey().getEncoded()(DER)签名,并期望 "Invalid signature
algorithm"。HS512 源自验证器变更(第 85-89 行);没有
上游测试专门针对它。
alg=none 不是正例:在修复之前,验证器让它通过,
但授权路径的其余部分是否拒绝它并未建模。它保留
为纵深防御用例。共 22 个用例:2 个正例、7 个负例、1 个纵深
防御和 12 个对抗性用例。
PYTHONPATH=src python -m unittest discover -s tests -v
python scripts/derive_expected.py | diff - fixtures/expected.tsv
python scripts/gen_results.py /tmp/r && diff -r results /tmp/r
参见 LIMITATIONS.md 和 SOURCES.md。 许可证:Apache-2.0。