الأمان والمراقبة

Keycloak CVE-2026-117691: تجاوز توقيع SAML، ماذا تفعل

في 5 نوفمبر 2026 أصدر Keycloak النسخة 26.8.2 مع إشعار الثغرة CVE-2026-117691: يمكن تجاوز التحقق من التوقيع في ربط SAML redirect باسم معامل مرمّز بالنسبة المئوية، وانتحال حساب متحد الهوية. الدرجة 9.1 من 10. بالنسبة لوكالة تدير SSO لعملائها، المهم هو معرفة ما إذا كانت النسخة معنية، وأي إصدار تستهدف، وكيف ترقّي دون كسر تسجيلات الدخول. يتبع هذا الدليل المصادر الأولية ويذكر ما لا تقوله.

انشر على VPS Cloud ←
11 دقيقةً للقراءةعدد الخطوات: 8

Orbi وكيل ذكاء اصطناعيالفهرس يتبع المقال، والمقالات ذات الصلة في أسفل الصفحة.

المحتويات· ما يقوله الإشعار وما لا يقوله1/13
  1. 01ما يقوله الإشعار وما لا يقوله
  2. 02من هو المعرّض
  3. 03أي إصدار تثبّت: ما تقوله المصادر لبعضها
  4. 04فروع Keycloak أمام CVE-2026-117691
  5. 05قراءة الإصدار المنشور فعلاً
  6. 06تحديث Keycloak عبر Docker Compose
  7. 07نسخة احتياطية تُسترجَع فعلاً
  8. 08إذا تعيّن تأجيل التحديث أياماً
  9. 09تقليل التعرض في الأثناء
  10. 10التحقق من الإصلاح ثم البحث عن آثار
  11. 11استكشاف الأخطاء بعد رفع الإصدار
  12. 12الأعراض والعلاج بحسب دليل الترقية
  13. 13التوثيق الرسمي

ما يقوله الإشعار وما لا يقوله

الثغرة CVE-2026-117691، المسجلة في إشعار GitHub برقم GHSA-c85j-3hq2-q6wj، تمس ربط SAML HTTP-Redirect في Keycloak. يفكّ الخادم ترميز أسماء المعاملات المرمّزة بالنسبة المئوية، مثل %53AMLResponse، بينما لا يتعرف فحص التوقيع إلا على الأسماء الحرفية. يرسل المهاجم أولاً رسالة غير موقّعة تحت الاسم المرمّز، ثم رسالة موقّعة بشكل مشروع. يفحص التوقيع الرسالة الثانية، ويعالج الخادم الأولى.

تستنتج Red Hat أخطر نتيجة: الاستيلاء على أي حساب متحد الهوية. تاريخ الإشعار 5 نوفمبر 2026. درجة CVSS 3.1 هي 9.1، بمتجه شبكي ودون صلاحيات أو تفاعل من المستخدم، وتُصنَّف نقطة الضعف CWE-347، أي تحقق تشفيري معيب من التوقيع.

وتضيف Red Hat شرطاً مسبقاً: يجب أن يملك المهاجم حساباً لدى مزود الهوية الخارجي ليحصل على رسالة إعادة توجيه موقّعة فعلاً، مثل ردّ تسجيل خروج. أما إشعار GitHub فلا يذكر إصدارات متأثرة ولا حلاً مؤقتاً. لذلك يفصل بقية هذا الدليل بين ما هو ثابت وما هو مستنتج.

من هو المعرّض

  • Keycloak وسيطاً لهوية SAML — تذكر تذكرة المشروع (keycloak#54714) عبارة «broker login as any user». الحالة الموصوفة هي realm يتّحد مع مزود هوية SAML خارجي: عميل مؤسسي، شريك، دليل طرف ثالث. هذا هو السيناريو الذي يُعالَج أولاً.
  • حساب لدى المزود الخارجي — يعيد الهجوم استخدام رسالة موقّعة، فيلزم حساب ولو دون صلاحيات لدى ذلك المزود. كلما كان التسجيل لديه أكثر انفتاحاً اتسع التعرض.
  • OIDC فقط — المصادر المقروءة لا تصف إلا ربط SAML HTTP-Redirect ولا تذكر OIDC. الـ realm الخالي من مزود SAML خارج السيناريو الموصوف، لكن هذا لا يعفي من الترقية: تعلن ملاحظات 26.8.2 عن 33 إصلاحاً أمنياً.
  • Keycloak مزوداً لـ SAML لتطبيقاتك — لا يذكر أي مصدر ما إذا كان عملاء SAML متأثرين. تسرد ملاحظات 26.8.2 إصلاحات SAML أخرى. لا تستنتج غياب الخطر: حدّث.
  • Red Hat build of Keycloak — تضع قاعدة NVD فرع 26.6 ضمن المتأثر قبل 26.6.9. وتصنّف Red Hat نظام Red Hat Single Sign-On 7 غير متأثر.
  • الاستغلال الملاحَظ — حتى 18 نوفمبر 2026 لا تظهر الثغرة في كتالوج CISA للثغرات المستغَلة، ودرجة EPSS لها أقل من 1 %. هذه ليست مهلة سماح: تبقى درجة الخطورة 9.1.

أي إصدار تثبّت: ما تقوله المصادر لبعضها

بالنسبة إلى المشروع المجتمعي، الإصلاح في 26.8.2 الصادر في 5 نوفمبر 2026. في سلسلة keycloak#54714 يسأل مستخدمون عن الإصدارات الأقدم المتأثرة. الجواب الوحيد إحالة إلى وسمَي release/26.6.9 وrelease/26.4.18 في المستودع. أما سؤال لماذا لا 26.7 فطُرح في 9 نوفمبر 2026 دون ردّ من أحد المشرفين في السلسلة.

لا تتفق المصادر تماماً. نشرت Red Hat النسخة 26.6.9 من Red Hat build of Keycloak في 7 نوفمبر 2026 مع الإشعار RHSA-2026:96040. لكن بالنسبة إلى المشروع المجتمعي، لا تُظهر قائمة إصدارات GitHub ولا وسوم صور quay.io في 18 نوفمبر 2026 لا 26.6.9 ولا 26.4.18: آخر 26.6 منشورة هي 26.6.4، وآخر 26.7 هي 26.7.5.

النتيجة العملية. مع الصورة المجتمعية استهدف 26.8.2. ومع Red Hat build of Keycloak استهدف 26.6.9 أو، بحسب تتبّع المشروع، 26.4.18: أكّد ذلك مع مزودك. في 26.7 لا يُعلَن أي إصلاح: اعتبرها متأثرة. قبل 26.4 لا يثبت الإشعار شيئاً ولا نستنتج نحن شيئاً: لا يُعلَن إصدار مُصلَح هناك، وهذا سبب إضافي للانتقال.

فروع Keycloak أمام CVE-2026-117691

مرّر الجدول أفقيًا

الفرعالوضع أمام الثغرةالإصدار المُصلَح
26.8 (مجتمعي)غير مُصلَح قبل 26.8.226.8.2 الصادر في 5 نوفمبر 2026
26.7 (مجتمعي)آخر منشور: 26.7.5، دون إصلاح أو نقل مُعلَنالانتقال إلى 26.8.2
26.6 (مجتمعي)آخر منشور: 26.6.4، دون إصلاحالانتقال إلى 26.8.2
26.6 (Red Hat build of Keycloak)متأثر قبل 26.6.9 بحسب NVD26.6.9، الإشعار RHSA-2026:96040
26.4نقل مُعلَن في تتبّع المشروع، دون إشعار مقروء26.4.18 بحسب التتبّع: يُؤكَّد
قبل 26.4لا يثبته الإشعارلا شيء مُعلَن: انتقل إلى 26.8.2
Red Hat Single Sign-On 7غير متأثر بحسب Red Hatلا ينطبق

قراءة الإصدار المنشور فعلاً

دوّن ما يعمل قبل تغيير أي شيء، بطريقتين يدعم بعضهما بعضاً.

لوحة الإدارة: ادخل إلى الـ realm باسم master وافتح لوحة المعلومات ثم تبويب Server Info الذي يصف الخادم وميزاته المفعّلة. سطر الأوامر: الخيار -V أو --version للأمر kc.sh يعرض الإصدار. تحت Docker الأمر هو docker compose exec keycloak /opt/keycloak/bin/kc.sh --version مع تكييف اسم الخدمة.

وسم ملف Compose يقول ما طلبته أنت، لا بالضرورة ما يعمل: الوسم المتحرك مثل 26.8 يتغير مع كل docker compose pull. وإذا بُنيت صورتك بالأمر kc.sh build فالعبرة بإصدار الصورة المبنية. وأخيراً دوّن في كل realm قائمة مزودي هوية SAML (قائمة Identity providers): فهي تقول هل أنت ضمن السيناريو الموصوف.

تحديث Keycloak عبر Docker Compose

  1. تدوين الإصدار والحالة الحاليين

    نفّذ docker compose exec keycloak /opt/keycloak/bin/kc.sh --version ثم دوّن الـ realms ومزودي هوية SAML والعملاء الذين يخدمون عملاءك. تصبح هذه القائمة شبكة الاختبار في النهاية.

  2. نسخ قاعدة البيانات والإعدادات احتياطياً

    انسخ القاعدة احتياطياً بأداة محركك، مثلاً docker compose exec -T postgres pg_dump -U keycloak keycloak > keycloak-avant-maj.sql مع تكييف الخدمة والمستخدم والقاعدة. انسخ أيضاً ملف Compose وconf/ والقوالب وproviders/. يطلب دليل الترقية نسخ القاعدة والتثبيت القديم احتياطياً.

  3. قراءة تغييرات الترحيل

    يسرد دليل الترقية التغييرات إصداراً بإصدار. اقرأ كل ما يفصل إصدارك عن الهدف لا الأخير فقط: قسم 26.8 يغيّر التحكم في الوصول إلى واجهة الإدارة ومعالجة تأكيدات SAML.

  4. تغيير وسم الصورة

    في ملف Compose انتقل إلى image: quay.io/keycloak/keycloak:26.8.2: وسم دقيق، لا latest أبداً. صورة مخصصة: غيّر سطر FROM في Dockerfile ثم نفّذ docker compose build --pull. صورة رسمية: docker compose pull keycloak.

  5. إيقاف الإصدار القديم

    نفّذ docker compose stop keycloak. التحديثات المتدرجة موثقة للإصدارات التصحيحية فقط منذ 26.6.0؛ وعند تغيير الإصدار الفرعي أوقف كل العقد قبل ترحيل القاعدة.

  6. التشغيل وترك القاعدة تُرحَّل

    نفّذ docker compose up -d keycloak ثم docker compose logs -f keycloak. تُرحَّل القاعدة تلقائياً عند أول تشغيل. المهلة الافتراضية 30 دقيقة؛ ولقاعدة كبيرة أضف --transaction-setup-timeout=60m إلى أمر التشغيل. فوق 300000 سجل تُنشأ بعض الفهارس في الخلفية بعد التشغيل.

  7. إعادة اختبار القوالب والمزودين وتسجيلات الدخول

    قارن قوالب السمات المخصصة بقوالب الإصدار الجديد ثم أعد شبكة الاختبار المدوّنة في الخطوة 1: تسجيل دخول لكل مزود SAML، وتسجيل خروج، وعميل لواجهة الإدارة، وحساب متحد الهوية موجود.

  8. ربط المراقبة والمتابعة

    أضف عنوان تسجيل الدخول في Keycloak إلى مسبار توفر، مثل قالب Uptime Kuma من الكتالوج على الـ VPS نفسه، وتابع مدونة keycloak.org لمعرفة الإصدار التصحيحي القادم. يُحدَّث الـ SSO بإيقاع إشعاراته لا بإيقاع مشاريعك.

نسخة احتياطية تُسترجَع فعلاً

بعد الترحيل لا يعود مخطط القاعدة متوافقاً مع الخادم القديم، ولا يعرف Keycloak التراجع عن الترحيل. وللعودة يجب استرجاع التثبيت القديم ثم القاعدة من النسخة الاحتياطية. استرجعها مرة على قاعدة اختبار قبل الترقية في الإنتاج: النسخة التي لم تُسترجَع قط مجرد فرضية.

إذا تعيّن تأجيل التحديث أياماً

لنكن واضحين: لا يوجد حل مؤقت رسمي. تذكر Red Hat أنه لا إجراء يستوفي معاييرها من حيث السهولة والنشر والاستقرار، ولا يسرد إشعار GitHub أي إجراء. المسارات التالية تقلل التعرض ولا تصلح شيئاً. هي للصمود بضعة أيام لا لتأجيل الترقية.

تقليل التعرض في الأثناء

  • تقييد التسجيل لدى المزود الخارجي — يفترض الهجوم وجود حساب لديه. مراجعة حساباته وتحديد التسجيلات الجديدة يقلل السطح المكشوف. ترد هذه الفكرة في ملاحظة لـ Red Hat بتاريخ 6 نوفمبر 2026 موسومة بأنها مولّدة بالذكاء الاصطناعي، وتوضح أنها لا تصلح الثغرة.
  • تعطيل مزود SAML المعني — في Identity providers يقطع مفتاح التفعيل تسجيلات الدخول عبر ذلك المزود. هذا استنتاجنا لا توجيه من الإشعارات: جرّبه على realm اختبار وقِس الأثر على مستخدمي ذلك العميل.
  • لا تعتمد على «HTTP-POST Binding Response» — بحسب التوثيق يختار هذا الإعداد الربط الذي يستخدمه Keycloak للرد على طلبات المزود الخارجي. لا شيء يدل على أنه يمنع قبول رسالة عبر إعادة التوجيه.
  • لا تَعِد بمرشّح nginx — يمكن البحث عن الطلبات ذات اسم معامل مرمّز، لكن لا مصدر يثبت قاعدة حجب كاملة، وقد يطال الترميز أي حرف من الاسم. استخدم الوكيل العكسي للكشف لا لتشعر بأنك محمي.
  • تحديد موعد الترقية — نافذة صيانة مؤرخة، ونسخة احتياطية مُنجزة ومُختبرة، ومسؤول معيّن. يُقاس خطر SSO غير مُصلَح بالأيام.
  • إبلاغ العملاء المعنيين — إذا كنت تدير الـ SSO لهم فاذكر أي ثغرة وأي إصدار وأي تاريخ ترقية. دون إضافة تفاصيل استغلال.

التحقق من الإصلاح ثم البحث عن آثار

التحقق: أعد قراءة الإصدار في Server Info وبالأمر kc.sh --version؛ يجب أن يعرض 26.8.2 للصورة المجتمعية. ثم أعد اختباراتك الوظيفية: تسجيل دخول عبر كل مزود SAML وتسجيل خروج. لا تحاول إعادة الهجوم على الإنتاج: رسالة مزوّرة على نظام حي محاولة انتحال. وإذا لزم دليل فابنِ realm اختبار معزولاً بحسابات تجريبية.

البحث عن آثار: يمر الهجوم عبر طلب GET باسم معامل مرمّز. في سجلات وصول الوكيل العكسي يجد بحث مثل zgrep -iE '[?&][a-z]*%[0-9a-f]{2}[a-z]*=' /var/log/nginx/access.log* أسماء المعاملات التي تحوي حرفاً مرمّزاً. النتيجة مؤشر لا دليل، وغياب النتائج ليس دليلاً أيضاً: سجلات مدوَّرة، ومعاملات غير مسجَّلة، ووكيل آخر في المنبع.

في Keycloak لا تُحفظ أحداث المستخدمين افتراضياً، بل الأخطاء فقط. فعّل Save events في Realm settings ثم Events لحفظ السجل من الآن، وراجع تسجيلات الدخول المتحدة غير المعتادة: الوقت وعنوان IP والحساب. قبل التفعيل لم يُسجَّل شيء: وما لا تجده قد لا يكون كُتب أصلاً.

استكشاف الأخطاء بعد رفع الإصدار

الانتقال إلى 26.8 يغيّر عدة سلوكيات مذكورة في دليل الترقية. هذه أكثرها إيهاماً بعطل. لا يورد الدليل أي رسالة خطأ عند التشغيل: الأعراض أدناه هي ما يصفه.

الأعراض والعلاج بحسب دليل الترقية

  • أخطاء 401 من واجهة الإدارة — يجب أن تحمل الرموز النطاق الجديد kc-admin-api. يجب إسناده إلى العملاء المخصصين وحسابات الخدمة؛ أما admin-cli واللوحة فيُحدَّثان تلقائياً. أثناء ترقية متدرجة قد تظهر أخطاء 401 مؤقتة.
  • تسجيل دخول SAML لم يعد يعمل — يجب أن تحمل التأكيدات تأكيد موضوع من نوع bearer، وتُرفض شروط ProxyRestriction افتراضياً. في المحوّل يجب استبدال entityID="idp" بعنوان الـ realm.
  • رفض الربط التلقائي للحسابات — صار يتطلب بريداً إلكترونياً موثقاً أو خيار Trust Email لدى المزود. قد يرى مستخدمون كانوا يرتبطون تلقائياً شاشة ربط فجأة.
  • ضغط أكبر على القاعدة أو المعالج — تُخزَّن إخفاقات تسجيل الدخول في القاعدة افتراضياً، مما يزيد الاتصالات والمعالج. يعيد --features=login-failures:v1 التخزين في الذاكرة.
  • ترحيل يطول أكثر من اللازم — المهلة الافتراضية 30 دقيقة وقابلة للضبط بـ --transaction-setup-timeout. إذا حدث الإيقاف في منتصف الترحيل فاسترجع القاعدة المنسوخة قبل إعادة التشغيل.
  • مستخدمون خرجوا من الجلسة — مع تعطيل persistent-user-sessions تضيع كل الجلسات عدا الجلسات دون اتصال، ويجب إعادة مسارات الدخول الجارية. نبّه المستخدمين قبل نافذة الصيانة.

التوثيق الرسمي

الروابط التالية هي مصادر هذا الدليل؛ أعد قراءتها قبل التنفيذ.

إشعار GitHub: ‎https://github.com/advisories/GHSA-c85j-3hq2-q6wj

ملاحظات الإصدار 26.8.2: ‎https://www.keycloak.org/2026/11/keycloak-2682-released

تتبّع المشروع: ‎https://github.com/keycloak/keycloak/issues/54714

دليل الترقية: ‎https://www.keycloak.org/docs/latest/upgrading/index.html

صفحة Red Hat للثغرة: ‎https://access.redhat.com/security/cve/CVE-2026-117691

إشعار Red Hat للإصدار 26.6.9: ‎https://access.redhat.com/errata/RHSA-2026:96040

ولـ SSO تديره بنفسك، تقدّم صفحة Keycloak في كتالوج ServOrbit قالب VPS جاهزاً للنشر مع PostgreSQL وHTTPS، ينطبق عليه الإجراء أعلاه كما هو.

شارك هذا المقالservorbit.com/ma-ar/المدونة/keycloak-cve-2026-117691-تجاوز-توقيع-saml-تحديث

أبقِ Keycloak محدَّثاً على VPS الخاص بك

الأسعار المعروضة قبل الضريبة، مع سعر التجديد.