
Offline-Differentialmodell der Keycloak-JWT-Grant-HMAC-Algorithmus-Konfusion (CVE-2026-11800), zu Lehrzwecken
Offline-Differentialmodell von CVE-2026-11800 (GHSA-j97h-3f8r-mrjr):
Keycloak-JWT-Validatoren, die auf einen öffentlichen IdP-Schlüssel gestützt waren, akzeptierten symmetrische
(HMAC) alg-Werte, was eine RS256→HS256-Algorithmusverwechslung ermöglichte. Behoben in
26.6.4. Lehrreich, offline, deterministisch.
Spanisch: README.es.md. Übungen: PRACTICE.md.
Vor der Korrektur akzeptierte Keycloak HMAC-Signaturen, die den konfigurierten
öffentlichen Schlüssel des IdP als Secret verwendeten. Bei einem fest codierten öffentlichen Schlüssel
behandelte HardcodedPublicKeyLoader HS*-Algorithmen, indem es
KeyUtils.loadSecretKey(Base64Url.decode(encodedKey)) lud (entfernte Diff-Zeile
206). Der konfigurierte Wert ist normalerweise PemUtils.encodeKey(publicKey), d. h.
Base64 der DER-SubjectPublicKeyInfo ohne PEM-Header, sodass das HMAC-
Secret exakt die DER-Bytes eines Schlüssels waren, der konstruktionsbedingt öffentlich ist. Jeder,
der den öffentlichen Schlüssel kennt, kann eine HS256-Assertion signieren, die verifiziert wird. Der
Validator verhinderte dies nicht: Vor der Korrektur prüfte er nur auf ein null alg
oder eine Abweichung von einem explizit erwarteten Algorithmus.
Die Korrektur (Diff-Zeilen 64-96) bewirkt, dass validateSignatureAlgorithm
none (Groß-/Kleinschreibung unabhängig) ablehnt und, sofern nicht isSymmetricAlgorithmAllowed(),
einen asymmetrischen ClientSignatureVerifierProvider für den Header
alg verlangt. Außerdem entfernt sie den HMAC-Zweig aus dem Loader. Nur
JWTClientSecretValidator (gemeinsames Client-Secret) behält symmetrische
Algorithmen.
| Fall | vorher (32cdceb8) | nachher (6d61885f / 8970032a) |
|---|---|---|
p01 HS256, HMAC über das DER | ACCEPT | REJECT |
p02 HS512, HMAC über das DER | ACCEPT | REJECT |
n06 HS256 mit dem PEM-Text als Schlüssel | BAD_SIGNATURE | REJECT |
n01 RS256 | PROCEEDS_TO_SIGNATURE_CHECK | gleich |
d01 alg=none (Defense in Depth) | VALIDATOR_PASS_DOWNSTREAM_UNMODELED | REJECT |
Die Positivfälle sind ausschließlich HS256/HS512. HS256 wird durch die Upstream-Tests
testHS256AlgorithmConfusion* im Korrektur-Diff gestützt (Zeilen 253, 263-277, 279,
321, 351, 399, 408-421, 424); sie signieren mit
getPublicKey().getEncoded() (DER) und erwarten „Invalid signature
algorithm". HS512 folgt aus der Änderung am Validator (Zeilen 85-89); kein
Upstream-Test zielt speziell darauf ab.
alg=none ist kein Positivfall: Vor der Korrektur lässt der Validator es durch,
aber ob der restliche Grant-Pfad es ablehnt, wird nicht modelliert. Es bleibt
als Defense-in-Depth-Fall. 22 Fälle: 2 positiv, 7 negativ, 1 Defense in
Depth und 12 adversarial.
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
Siehe LIMITATIONS.md und SOURCES.md. Lizenz: Apache-2.0.