
نموذج تفاضلي دون اتصال لالتباس خوارزمية HMAC في منح JWT الخاص بـ Keycloak (CVE-2026-11800)، لأغراض تعليمية
نموذج تفاضلي دون اتصال لـ CVE-2026-11800 (GHSA-j97h-3f8r-mrjr):
كانت مدققات Keycloak لرموز JWT المدعومة بمفتاح عام من مزوّد الهوية (IdP) تقبل قيم alg المتماثلة
(HMAC)، مما يتيح الخلط بين الخوارزميات RS256→HS256. تم إصلاحها في
26.6.4. تعليمي، دون اتصال، حتمي.
الإسبانية: README.es.md. التمارين: PRACTICE.md.
قبل الإصلاح، كانت Keycloak تقبل توقيعات HMAC التي تستخدم المفتاح العام
المُهيَّأ لمزوّد الهوية كسرّ. مع مفتاح عام مضمَّن في الشيفرة،
كان HardcodedPublicKeyLoader يتعامل مع خوارزميات HS* عبر تحميل
KeyUtils.loadSecretKey(Base64Url.decode(encodedKey)) (سطر الفرق المحذوف
206). القيمة المُهيَّأة عادةً هي PemUtils.encodeKey(publicKey)، أي
base64 لـ DER SubjectPublicKeyInfo دون ترويسات PEM، لذا كان سرّ HMAC
هو بالضبط بايتات DER لمفتاح عام بطبيعته. أي شخص
يعرف المفتاح العام يمكنه توقيع تأكيد HS256 يتحقق بنجاح. لم يمنع
المدقق ذلك: قبل الإصلاح كان يتحقق فقط من 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 ليست حالة إيجابية: قبل الإصلاح يمررها المدقق،
لكن ما إذا كان بقية مسار المنح يرفضها غير مُنمذج. تبقى
كحالة دفاع متعدد الطبقات. 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.