دليل التشخيص
أكثر عشرة أخطاء إعداد شيوعاً، وأعراضها وأسبابها وطرق إصلاحها.
1. entity ID غير صحيح للـ SP أو IdP
العرض: يعرض IdP صفحة خطأ فور إعادة توجيه SP إلى رابط SSO.
الإصلاح: تحقق من تطابق entity-id في SDK مع القيمة المسجلة في وحدة تحكم Hawiyati. المعرّفات حساسة لحالة الأحرف.
رسالة السجل: SamlValidationException: Issuer does not match trusted IdP entity ID
2. عدم تطابق شهادة التوقيع
العرض: رد ACS يُرجع HTTP 403 — "فشل التحقق من التوقيع".
الإصلاح: نزّل شهادة التوقيع الحالية من Admin → IdP → Certificates → Download PEM واستبدل الملف المُشار إليه في إعدادك.
3. انحراف الساعة يتجاوز الحد المسموح
العرض: فشل المصادقة مع "الادعاء منتهي الصلاحية".
الإصلاح: زامن كلا الخادمين باستخدام NTP.
7. فشل الاتصال بـ Redis
العرض: فشل بدء تشغيل SP مع "Cannot connect to Redis".
الإصلاح: تحقق من توفر Redis (redis-cli ping) وصحة إعدادات الاتصال. لا تستخدم stores الذاكرة في عنقود متعدد النسخ.