H· Hawiyati Documentation

دليل التكامل .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مؤجل