دليل التكامل .NET/ASP.NET Core
تكامل SDK SAML2 SP Hawiyati مع تطبيقات .NET 8 ASP.NET Core.
قيد معروف: لم يكن .NET 8 SDK مثبتاً في بيئة التطوير أثناء إصدار v1.0.0. يجب تشغيل
dotnet test قبل النشر في الإنتاج.
2. إضافة التبعية
dotnet add package Hawiyati.Saml.Sp.AspNetCore --version 1.0.0
dotnet add package Hawiyati.Saml.Sp --version 1.0.0
3. الإعداد الأدنى
{
"Saml": {
"SpEntityId": "https://app.example.com/saml/metadata",
"AcsUrl": "https://app.example.com/saml/acs",
"IdpEntityId": "https://idp.hawiyati.org",
"IdpSsoUrl": "https://idp.hawiyati.org/saml2/sso/redirect",
"IdpSigningCertPath": "/etc/saml/idp-signing.pem"
}
}
4. ترتيب الـ middleware (إلزامي)
app.UseHttpsRedirection();
app.UseSamlAcs("saml"); // يجب أن يسبق UseAuthentication
app.UseAuthentication();
app.UseAuthorization();
10. الامتدادات المؤجلة
| الميزة | الحالة |
|---|---|
| SAML Single Logout (SLO) | مؤجل |
| تسجيل الدخول بمبادرة IdP | مؤجل |
| الادعاءات المشفرة | مؤجل |
| تفاوض فئة سياق المصادقة | مؤجل |
| الاتحاد متعدد IdP لكل SP | مؤجل |