
Modello differenziale offline della confusione dell'algoritmo HMAC nelle concessioni JWT di Keycloak (CVE-2026-11800), a scopo didattico
Modello differenziale offline di CVE-2026-11800 (GHSA-j97h-3f8r-mrjr):
i validatori JWT di Keycloak basati su una chiave pubblica di un IdP accettavano valori alg simmetrici
(HMAC), consentendo la confusione di algoritmo RS256→HS256. Corretto in
26.6.4. A scopo didattico, offline, deterministico.
Spagnolo: README.es.md. Esercizi: PRACTICE.md.
Prima della correzione, Keycloak accettava firme HMAC che usavano la chiave pubblica
configurata dell'IdP come segreto. Con una chiave pubblica hardcoded,
HardcodedPublicKeyLoader gestiva gli algoritmi HS* caricando
KeyUtils.loadSecretKey(Base64Url.decode(encodedKey)) (riga 206 del diff rimossa).
Il valore configurato è normalmente PemUtils.encodeKey(publicKey), cioè
la base64 del DER SubjectPublicKeyInfo senza intestazioni PEM, quindi il segreto
HMAC era esattamente i byte DER di una chiave che è pubblica per progettazione. Chiunque
conosca la chiave pubblica può firmare un'asserzione HS256 che viene verificata. Il
validatore non lo impediva: prima della correzione controllava solo la presenza di un alg nullo
o una discrepanza con un algoritmo esplicitamente atteso.
La correzione (righe 64-96 del diff) fa sì che validateSignatureAlgorithm rifiuti
none (senza distinzione tra maiuscole e minuscole) e, a meno che isSymmetricAlgorithmAllowed(),
richieda un ClientSignatureVerifierProvider asimmetrico per l'alg dell'header.
Rimuove inoltre il ramo HMAC dal loader. Solo
JWTClientSecretValidator (segreto client condiviso) mantiene gli algoritmi simmetrici.
| Caso | pre (32cdceb8) | post (6d61885f / 8970032a) |
|---|---|---|
p01 HS256, HMAC sul DER | ACCEPT | REJECT |
p02 HS512, HMAC sul DER | ACCEPT | REJECT |
n06 HS256 con chiave basata sul testo PEM | BAD_SIGNATURE | REJECT |
n01 RS256 | PROCEEDS_TO_SIGNATURE_CHECK | same |
d01 alg=none (difesa in profondità) | VALIDATOR_PASS_DOWNSTREAM_UNMODELED | REJECT |
I casi positivi sono solo HS256/HS512. HS256 è supportato dai test upstream
testHS256AlgorithmConfusion* nel diff della correzione (righe 253, 263-277, 279,
321, 351, 399, 408-421, 424); firmano con
getPublicKey().getEncoded() (DER) e si aspettano "Invalid signature
algorithm". HS512 deriva dalla modifica del validatore (righe 85-89); nessun
test upstream lo prende di mira specificamente.
alg=none non è un caso positivo: prima della correzione il validatore lo lascia passare,
ma se il resto del percorso di grant lo rifiuti non è modellato. Rimane
come caso di difesa in profondità. 22 casi: 2 positivi, 7 negativi, 1 di difesa in
profondità e 12 avversariali.
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
Vedi LIMITATIONS.md e SOURCES.md. Licenza: Apache-2.0.