
Офлайн-модель дифференциальной проверки путаницы алгоритмов HMAC в JWT-грантах Keycloak (CVE-2026-11800), в образовательных целях
Офлайн-модель дифференциального анализа CVE-2026-11800 (GHSA-j97h-3f8r-mrjr):
валидаторы JWT в Keycloak, опирающиеся на публичный ключ IdP, принимали симметричные
(HMAC) значения alg, что позволяло использовать путаницу алгоритмов RS256→HS256. Исправлено в
26.6.4. Образовательная, офлайн, детерминированная.
Испанский: README.es.md. Упражнения: PRACTICE.md.
До исправления Keycloak принимал HMAC-подписи, в которых в качестве секрета
использовался настроенный публичный ключ IdP. При жёстко заданном публичном ключе
HardcodedPublicKeyLoader обрабатывал алгоритмы HS*, загружая
KeyUtils.loadSecretKey(Base64Url.decode(encodedKey)) (удалённая строка диффа
206). Настроенное значение обычно равно PemUtils.encodeKey(publicKey), то есть
base64 от DER SubjectPublicKeyInfo без PEM-заголовков, поэтому HMAC-секретом
были ровно DER-байты ключа, который по определению является публичным. Любой,
кто знает публичный ключ, может подписать утверждение HS256, которое пройдёт проверку. Валидатор
этому не препятствовал: до исправления он проверял только на null alg
или на несовпадение с явно ожидаемым алгоритмом.
Исправление (строки диффа 64-96) заставляет validateSignatureAlgorithm отклонять
none (без учёта регистра) и, если не isSymmetricAlgorithmAllowed(),
требовать асимметричный ClientSignatureVerifierProvider для заголовка
alg. Оно также удаляет ветку HMAC из загрузчика. Только
JWTClientSecretValidator (общий клиентский секрет) сохраняет симметричные
алгоритмы.
| Случай | до (32cdceb8) | после (6d61885f / 8970032a) |
|---|---|---|
p01 HS256, HMAC по DER | ACCEPT | REJECT |
p02 HS512, HMAC по DER | 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 подтверждается вышестоящими тестами
testHS256AlgorithmConfusion* в диффе исправления (строки 253, 263-277, 279,
321, 351, 399, 408-421, 424); они подписывают с помощью
getPublicKey().getEncoded() (DER) и ожидают "Invalid signature
algorithm". HS512 следует из изменения валидатора (строки 85-89); ни один
вышестоящий тест не нацелен на него специально.
alg=none не является позитивным случаем: до исправления валидатор пропускает его,
но отклоняет ли его остальная часть пути grant, не моделируется. Он остаётся
как случай защиты в глубину. 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.