H· Hawiyati Documentation

دليل التشغيل

مواضيع النشر في الإنتاج: ثقة TLS، proxies عكسية، حالة Redis المشتركة، سلوك إعادة التشغيل، تدوير الشهادات وسلوك أعطال IdP.

1. الثقة بـ CA خاصة

يجب أن يثق تطبيق SP بـ CA الخاصة لاتصالات HTTPS الصادرة.

# Java — إضافة إلى trust store
keytool -importcert -alias hawiyati-idp-ca -cacerts \
  -file /path/to/private-ca.crt -storepass changeit -noprompt

3. الحالة المشتركة متعددة النسخ

لا تُشارَك stores الذاكرة بين نسخ العمليات المختلفة. للنشر متعدد النسخ، استخدم محولات Redis.

hawiyati:
  saml:
    sp:
      redis:
        host: redis.internal
        port: 6379
        password: ${REDIS_PASSWORD}
        tls: true

5. انتهاء صلاحية الشهادة وتدويرها

عند تدوير IdP لشهادة توقيعه:

  1. نزّل الشهادة الجديدة من Admin → IdP → Certificates → Download PEM.
  2. أضف الشهادة الجديدة إلى idp.signing-cert-paths مع الاحتفاظ بالقديمة — يقبل SDK أي شهادة في القائمة. يتيح ذلك التدوير دون توقف.
  3. بعد انتهاء صلاحية الشهادة القديمة، أزلها من القائمة.