H· Hawiyati Documentation

دليل التشخيص

أكثر عشرة أخطاء إعداد شيوعاً، وأعراضها وأسبابها وطرق إصلاحها.

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 الذاكرة في عنقود متعدد النسخ.