دليل التكامل Java/Spring Boot
تكامل SDK SAML2 SP Hawiyati مع تطبيقات Java/Spring Boot. يغطي تبعية Maven، الإعداد الأدنى، حماية المسارات، معالجة رد ACS، تسجيل الخروج المحلي وتسجيل SP.
1. المتطلبات الأساسية
| المتطلب | الحد الأدنى للإصدار |
|---|---|
| Java | 17 |
| Spring Boot | 3.2.x |
| Hawiyati IdP | 2.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 واحد فقط لكل نسخة |