H· Hawiyati Documentation

دليل التكامل Java/Spring Boot

تكامل SDK SAML2 SP Hawiyati مع تطبيقات Java/Spring Boot. يغطي تبعية Maven، الإعداد الأدنى، حماية المسارات، معالجة رد ACS، تسجيل الخروج المحلي وتسجيل SP.

1. المتطلبات الأساسية

المتطلبالحد الأدنى للإصدار
Java17
Spring Boot3.2.x
Hawiyati IdP2.0
الوصول الشبكيSP → IdP على المنفذ 443

يجب مزامنة ساعتَي SP وIdP ضمن 5 دقائق. استخدم NTP في جميع البيئات. التسامح الافتراضي هو 60 ثانية.

2. إضافة التبعية

أضف Spring Boot starter إلى ملف pom.xml:

<dependency>
    <groupId>org.hawiyati</groupId>
    <artifactId>saml-sp-spring-boot-starter</artifactId>
    <version>1.0.0</version>
</dependency>

3. الإعداد الأدنى

hawiyati:
  saml:
    sp:
      entity-id: https://app.example.com/saml/metadata
      acs-url: https://app.example.com/saml/acs
      idp:
        entity-id: https://idp.hawiyati.org
        sso-url: https://idp.hawiyati.org/saml2/sso/redirect
        signing-cert-paths:
          - /etc/saml/idp-signing.crt
      clock-skew-seconds: 60

10. الامتدادات المؤجلة (غير متوفرة في v1.0.0)

الميزةالحالةالسلوك البديل
SAML Single Logout (SLO)مؤجلتسجيل خروج محلي فقط؛ تظل جلسة IdP نشطة
تسجيل الدخول بمبادرة IdPمؤجلSP-initiated فقط
الادعاءات المشفرةمؤجلالادعاءات الموقعة (غير المشفرة) فقط
تفاوض فئة سياق المصادقةمؤجللا يوجد عنصر RequestedAuthnContext
الاتحاد متعدد IdP لكل SPمؤجلTrustedIdp واحد فقط لكل نسخة