
Modèle différentiel hors ligne de confusion d'algorithme HMAC sur les jetons JWT Keycloak (CVE-2026-11800), à but éducatif
Modèle différentiel hors ligne de CVE-2026-11800 (GHSA-j97h-3f8r-mrjr) :
les validateurs JWT de Keycloak s'appuyant sur une clé publique d'IdP acceptaient des valeurs alg symétriques
(HMAC), permettant une confusion d'algorithme RS256→HS256. Corrigé dans
26.6.4. À but éducatif, hors ligne, déterministe.
Espagnol : README.es.md. Exercices : PRACTICE.md.
Avant le correctif, Keycloak acceptait les signatures HMAC qui utilisaient la clé publique
configurée de l'IdP comme secret. Avec une clé publique codée en dur,
HardcodedPublicKeyLoader traitait les algorithmes HS* en chargeant
KeyUtils.loadSecretKey(Base64Url.decode(encodedKey)) (ligne de diff supprimée
206). La valeur configurée est normalement PemUtils.encodeKey(publicKey), c'est-à-dire
le base64 du DER SubjectPublicKeyInfo sans en-têtes PEM, de sorte que le secret HMAC
était exactement les octets DER d'une clé publique par conception. Quiconque
connaît la clé publique peut signer une assertion HS256 qui sera validée. Le
validateur ne l'empêchait pas : avant le correctif, il ne vérifiait qu'un alg nul
ou une incohérence avec un algorithme explicitement attendu.
Le correctif (lignes de diff 64-96) fait que validateSignatureAlgorithm rejette
none (insensible à la casse) et, sauf si isSymmetricAlgorithmAllowed(),
exige un ClientSignatureVerifierProvider asymétrique pour l'en-tête
alg. Il supprime également la branche HMAC du chargeur. Seul
JWTClientSecretValidator (secret client partagé) conserve les algorithmes
symétriques.
| Cas | avant (32cdceb8) | après (6d61885f / 8970032a) |
|---|---|---|
p01 HS256, HMAC sur le DER | ACCEPT | REJECT |
p02 HS512, HMAC sur le DER | ACCEPT | REJECT |
n06 HS256 avec le texte PEM comme clé | BAD_SIGNATURE | REJECT |
n01 RS256 | PROCEEDS_TO_SIGNATURE_CHECK | idem |
d01 alg=none (défense en profondeur) | VALIDATOR_PASS_DOWNSTREAM_UNMODELED | REJECT |
Les positifs sont uniquement HS256/HS512. HS256 est étayé par les tests amont
testHS256AlgorithmConfusion* dans le diff du correctif (lignes 253, 263-277, 279,
321, 351, 399, 408-421, 424) ; ils signent avec
getPublicKey().getEncoded() (DER) et attendent « Invalid signature
algorithm ». HS512 découle du changement du validateur (lignes 85-89) ; aucun
test amont ne le cible spécifiquement.
alg=none n'est pas un positif : avant le correctif, le validateur le laisse passer,
mais le fait que le reste du chemin d'octroi le rejette n'est pas modélisé. Il reste
comme cas de défense en profondeur. 22 cas : 2 positifs, 7 négatifs, 1 défense en
profondeur et 12 adversariaux.
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
Voir LIMITATIONS.md et SOURCES.md. Licence : Apache-2.0.