Identity بتحل إيه؟
ASP.NET Core Identity framework لإدارة local user accounts وما يرتبط بها: usernames/emails، password hashes، roles، claims، tokens، confirmation، lockout، external login associations و2FA. هي لا تعني أن التطبيق أصبح آمنًا تلقائيًا، ولا تستبدل authorization policies أو resource ownership checks. Identity تدير user identity lifecycle؛ التطبيق ما زال مسؤولًا عن من يستطيع الوصول لأي resource.
افصل المصطلحات: Authentication يثبت من المستخدم؛ Authorization يقرر ما الذي يسمح له به. User سجل الحساب، Role تصنيف واسع لمجموعة صلاحيات، Claim assertion عن المستخدم أو الجلسة، وPermission قدرة محددة على action/resource. لا تجعل role واحدة تحمل كل تفاصيل الصلاحيات في نظام كبير.
Identity يمكن أن تستخدم Cookie authentication لتطبيق web، ويمكن دمجها مع API token architecture، لكنها ليست JWT issuer افتراضيًا لكل سيناريو. لا تخلط بين Identity cookie و JWT bearer: لكل واحد transport/storage/validation semantics مختلفة.
تسجيل Identity و DbContext
الـ Identity store يحتاج user type و EF Core DbContext مناسبًا. استخدم IdentityUser أو class مخصصة ترث منها لإضافة fields business محدودة. لا تحوّل IdentityUser إلى Customer/Employee domain model ضخم؛ اربط account بملف domain منفصل إذا كان lifecycle أو قواعده مختلفة.
public sealed class ApplicationUser : IdentityUser<Guid>
{
public string? DisplayName { get; set; }
public bool IsDisabled { get; set; }
}
public sealed class AppIdentityDbContext
: IdentityDbContext<ApplicationUser, IdentityRole<Guid>, Guid>
{
public AppIdentityDbContext(DbContextOptions<AppIdentityDbContext> options)
: base(options) { }
}builder.Services.AddDbContext<AppIdentityDbContext>(options =>
options.UseSqlServer(builder.Configuration.GetConnectionString("Identity")));
builder.Services.AddIdentity<ApplicationUser, IdentityRole<Guid>>(options =>
{
options.User.RequireUniqueEmail = true;
options.Password.RequiredLength = 12;
options.Password.RequireDigit = true;
options.Password.RequireUppercase = true;
options.Lockout.MaxFailedAccessAttempts = 5;
options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(10);
options.SignIn.RequireConfirmedEmail = true;
})
.AddEntityFrameworkStores<AppIdentityDbContext>()
.AddDefaultTokenProviders();الإعدادات أعلاه نقطة بداية وليست policy عالمية لكل مؤسسة. راجع threat model، MFA، password screening، recovery process، rate limiting و user experience. في API-only scenarios قد تستخدم AddIdentityCore وتضيف roles/sign-in/token services التي تحتاجها صراحة. الفرق أن AddIdentity يسجل مجموعة أوسع من services و cookie schemes.
UserManager و SignInManager: مين مسؤول عن إيه؟
UserManager<TUser> يدير عمليات user store: create/find/update/delete، password operations، roles، claims، tokens و security stamp. SignInManager<TUser> ينسق sign-in flow مع authentication schemes، external login، two-factor و lockout results. لا تستخدم UserManager كبديل عن authorization service؛ ولا تعتبر SignInManager مسؤولًا عن business profile أو customer onboarding.
مثال شائع: user account يتبع Customer profile. إنشاء customer قد يتطلب business validation و transaction/workflow مختلفة عن Identity user creation. لا تفترض أن إنشاء user في Identity DB وإنشاء customer في business DB عملية ذرية واحدة. لو الاتنين في نفس database/transaction تقدر تنسقها، أما لو منفصلين فصمم registration state/outbox/recovery path.
public sealed class RegisterAccountHandler(
UserManager<ApplicationUser> users,
ICustomerOnboarding onboarding)
{
public async Task<Guid> Handle(RegisterAccount command, CancellationToken ct)
{
var user = new ApplicationUser
{
UserName = command.Email,
Email = command.Email,
DisplayName = command.DisplayName
};
var created = await users.CreateAsync(user, command.Password);
if (!created.Succeeded)
throw new AccountCreationException(created.Errors);
// Business onboarding is a separate responsibility.
return await onboarding.CreatePendingCustomerAsync(user.Id, ct);
}
}الكود يوضح فصل المسؤوليات وليس transaction كاملة. في production، لو onboarding فشل بعد إنشاء Identity user، لازم تعرف هل تحذف الحساب، تتركه Pending، أم تسجل workflow recoverable. لا تترك orphan account بلا state واضحة.
Identity Deployment و Database Migrations
Identity schema changes جزء من deployment. طبق migrations بطريقة متوافقة مع rolling deploys؛ لا تحذف columns قبل أن كل instances تتوقف عن استخدامها. shared Data Protection key ring ضرورية للـ cookie continuity بين replicas. احمِ key store، وراقب key expiration/rotation. لو database unavailable، login/refresh/account operations قد تفشل؛ حدد degraded behavior ولا تسمح anonymous fallback.
اختبر restore من backup، schema migration، account lockout persistence، role/claim assignment، key ring failover و cookie validation بعد deployment. auth infrastructure جزء critical من availability؛ لا تنشر تغييراتها من غير rollback/recovery plan.
Identity Internals: UserManager و SignInManager و Stores
ASP.NET Core Identity ليس مجرد جدول Users. هو مجموعة abstractions وخدمات: UserManager لإدارة المستخدمين وكلمات المرور والـ claims/roles، SignInManager لعمليات تسجيل الدخول و2FA/lockout، validators للتحقق من username/password، و stores التي تتعامل مع persistence. EF Core store implementation اختيار شائع، لكن يمكن بناء store مخصص.
كلمات المرور لا تُخزن encrypted ولا plaintext؛ تُخزن salted password hashes باستخدام hasher مصمم لذلك مع format/version information. لا تنفذ hashing بنفسك ولا تقارن hashes يدويًا. عند تغيير إعدادات password policy، تذكر أن السياسة الجديدة لا تجعل كلمات المرور القديمة أقوى تلقائيًا.
builder.Services
.AddIdentityCore<ApplicationUser>(options =>
{
options.Password.RequiredLength = 12;
options.Password.RequireDigit = true;
options.Lockout.MaxFailedAccessAttempts = 5;
options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(10);
options.User.RequireUniqueEmail = true;
})
.AddRoles<IdentityRole>()
.AddEntityFrameworkStores<AppDbContext>()
.AddSignInManager()
.AddDefaultTokenProviders();هذه policy مثال بداية وليست وصفة عالمية؛ راجع threat model و UX و MFA requirements. Lockout قد يُستغل في denial-of-service ضد مستخدم مستهدف، لذا استخدم rate limiting ورسائل لا تكشف وجود الحساب. لا تخلط بين Identity cookie authentication و JWT bearer authentication؛ كل scheme له handler وسلوك مختلف.
Password Hashing: لا تخزن كلمة المرور أبدًا
كلمة المرور لا تُخزن plaintext ولا reversible encryption. Identity تستخدم password hasher لتخزين hash مع salt/format metadata، ثم تتحقق من كلمة المرور بإعادة عملية verification المناسبة. لا تنشئ SHA256(password) بنفسك؛ hash سريع عام غير مناسب لتخزين passwords لأنه يسهل brute-force على GPUs. استخدم password hashing scheme مخصصًا وقابلًا للترقية وفق framework guidance.
Identity لا ترجع password الأصلية، بل hash. لا تسجل password أو confirmation code أو reset token في logs. حماية كلمة المرور تشمل أيضًا TLS، rate limiting على login، MFA، breached-password checks عند الحاجة، ومنع account enumeration في رسائل الخطأ.
var user = new ApplicationUser
{
UserName = request.Email,
Email = request.Email,
DisplayName = request.DisplayName
};
var result = await userManager.CreateAsync(user, request.Password);
if (!result.Succeeded)
{
var errors = result.Errors.Select(e => e.Description).ToArray();
return Results.ValidationProblem(
new Dictionary<string, string[]> { ["identity"] = errors });
}لا ترجع Identity error details الخام دائمًا للـ public API؛ بعضها يكشف account state أو password policy. حوّل الأخطاء إلى contract مناسب مع الحفاظ على observability داخل logs من غير secrets. كما أن length policy أهم من إجبار خليط رموز معقد قد يدفع المستخدم إلى passwords متوقعة؛ اتبع سياسة حديثة ومناسبة.
Password Storage و Credential Lifecycle
لا تخزن password كنص أو encryption قابل للعكس. ASP.NET Core Identity يستخدم password hasher مع salt/work factor وإصدار format، ويمكنه rehash عند تغير policy. لا تكتب hashing algorithm يدويًا. ضع password policy واقعية، rate-limit login/reset endpoints، وراقب credential stuffing دون كشف هل البريد موجود أم لا إذا كان ذلك threat مناسبًا.
Password reset token يجب يكون قصير العمر، single-use عمليًا، مربوطًا بالمستخدم والغرض، ولا يظهر في logs أو analytics أو Referer. لا ترسل كلمة المرور القديمة بالبريد. بعد reset قرر هل تلغي sessions/refresh tokens الحالية؛ في تطبيقات حساسة ألغها أو زد security stamp/version. MFA يقلل أثر password theft لكنه لا يحمي من كل phishing؛ استخدم phishing-resistant methods عند الحاجة.
Registration و Login و Logout
Registration flow ليس مجرد CreateAsync: normalize email/username، تحقق من policy، أنشئ user، أرسل confirmation token، لا تمنح privileges قبل التحقق حسب متطلبات النظام. Login يستخدم SignInManager أو SignIn API حسب scheme. لا تنشئ JWT أو cookie بنفسك بمجرد أن كلمة المرور صحيحة؛ دع authentication handler/identity flow ينشئ principal وفق الإعدادات.
var user = await userManager.FindByEmailAsync(request.Email);
if (user is null)
return Results.Unauthorized();
var result = await signInManager.CheckPasswordSignInAsync(
user, request.Password, lockoutOnFailure: true);
if (result.IsLockedOut)
return Results.Problem("Account temporarily unavailable.", statusCode: 423);
if (result.IsNotAllowed)
return Results.Problem("Sign-in is not allowed.", statusCode: 403);
if (!result.Succeeded)
return Results.Unauthorized();
// For cookie-based web apps, SignInManager.SignInAsync creates the cookie.
// For APIs, issue/obtain the appropriate access token through a deliberate token flow.استخدم generic error message عند الحاجة لتقليل account enumeration، مع rate limiting و logging آمن. Logout في cookie app يمسح authentication cookie عبر sign-out scheme. في bearer JWT، «logout» لا يمسح token من client ولا يبطل توقيعه تلقائيًا؛ تحتاج expiry قصيرة و revocation/refresh-token strategy حسب architecture.
Email Confirmation و Password Reset
Email confirmation يثبت أن المستخدم يسيطر على mailbox المرتبط بالحساب، لكنه لا يثبت هويته القانونية. token يكون purpose-bound ومحدود العمر، ويرسل عبر قناة آمنة. Password reset يجب أن يستخدم token مخصصًا للغرض، ولا ترسل password جديدة بالبريد. لا تكشف هل البريد موجود أم لا إذا كان ذلك يخلق enumeration risk.
var token = await userManager.GenerateEmailConfirmationTokenAsync(user);
var encoded = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(token));
var link = urlBuilder.BuildConfirmationLink(user.Id, encoded);
await emailSender.SendAsync(user.Email!, "Confirm your account", link, ct);
// On confirmation endpoint:
var decoded = Encoding.UTF8.GetString(WebEncoders.Base64UrlDecode(encodedToken));
var result = await userManager.ConfirmEmailAsync(user, decoded);الـ token قد يحتوي characters تحتاج URL-safe encoding. لا تفترض إن query string غير حساس؛ reset links قد تظهر في browser history و proxy logs و analytics. استخدم HTTPS، قلل logging، حدد expiry، واجعل token single-purpose، ويفضل عدم وضع token طويل العمر في third-party redirect chains.
بعد password reset، قرر هل تنهي الجلسات الحالية أو تغير security stamp. راجع refresh tokens separately؛ تغيير password لا يبطل كل access JWT فورًا إلا لو عندك revocation/version checks.
Token Providers: Purpose و Expiry و Single Use
Identity token providers تنشئ tokens لأغراض محددة مثل email confirmation و password reset و authenticator. لا تخلط token purpose: token تأكيد البريد لا ينبغي أن تعمل password reset. صلاحية token تعتمد على provider/options و user security state، ويمكن ضبط lifespan لبعض providers. token لازم ترتبط user والغرض، وتتحقق عبر Identity APIs بدل فكها أو تفسيرها يدويًا.
لا تضع reset token في analytics أو application logs أو error telemetry. استخدم HTTPS، URL-safe encoding، expiry مناسبة، ورسالة عامة عند طلب reset. لا ترد «البريد غير موجود» في public endpoint لو ذلك يسمح enumeration. اجعل عملية reset لا تسجل دخولًا تلقائيًا إلا لو policy واضحة، وراجع هل تنهي الجلسات القديمة بعد تغيير كلمة المرور.
var token = await userManager.GeneratePasswordResetTokenAsync(user);
var safeToken = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(token));
await emailSender.SendPasswordResetLinkAsync(user.Email!, safeToken, ct);
// Later, after decoding the URL-safe token:
var result = await userManager.ResetPasswordAsync(user, decodedToken, newPassword);
if (!result.Succeeded)
return PasswordResetResult.InvalidOrExpired;
await userManager.UpdateSecurityStampAsync(user);لا تسجل decodedToken. لا تقبل userId/email من الرابط كدليل ملكية وحده؛ token هي credential المؤقتة ويجب أن تتحقق Identity منها للحساب المقصود.
Users و Roles و Claims
Role تمثل grouping واسع مثل Admin أو Support. Claim key/value مثل department=Finance أو tenant_id=.... claims قد تأتي من Identity أو external identity provider أو transformation. لا تضع معلومات حساسة أو mutable permission matrix كاملة في long-lived token من غير فهم staleness؛ claims snapshot وقت إصدار credential.
await userManager.AddToRoleAsync(user, "Support");
await userManager.AddClaimAsync(user,
new Claim("department", "CustomerCare"));
var roles = await userManager.GetRolesAsync(user);
var claims = await userManager.GetClaimsAsync(user);لا تجعل role اسمها CanEditOrder123؛ دي resource-specific permission وليست role. استخدم policy/authorization handler لقرار محدد. راجع naming و normalization، وتأكد من أن role creation/assignment محمي ومتاح فقط لجهة مخولة.
Claims Transformation و Claims Freshness
Claims transformation تضيف أو تحول claims بعد authentication، مثل تحميل tenant memberships أو normalize claim names. استخدمها بحذر لأنها قد تعمل في كل authentication request، وقد تسبب database query إضافية لكل request. لا تضف claims من user-controlled headers، ولا تعتبر transformation بديلًا عن authorization handler resource-based.
لو permissions تتغير بسرعة، claim داخل cookie/JWT قد تصبح stale. خياراتك: cookie security stamp validation، short session/token lifetime، permission version claim مع lookup، أو policy handler يقرأ current permissions من store. قارن latency و revocation speed. لا تخزن كل permission matrix في token طويلة العمر.
public sealed class TenantClaimsTransformation(ITenantMemberships memberships)
: IClaimsTransformation
{
public async Task<ClaimsPrincipal> TransformAsync(ClaimsPrincipal principal)
{
var userId = principal.FindFirstValue(ClaimTypes.NameIdentifier);
if (userId is null || principal.HasClaim("tenant_context_loaded", "true"))
return principal;
var identity = new ClaimsIdentity();
var tenantIds = await memberships.GetTenantIdsAsync(userId, CancellationToken.None);
foreach (var tenantId in tenantIds)
identity.AddClaim(new Claim("tenant", tenantId.ToString()));
identity.AddClaim(new Claim("tenant_context_loaded", "true"));
principal.AddIdentity(identity);
return principal;
}
}المثال يوضح الفكرة وليس توصية بتحميل كل tenant IDs لكل request؛ قد يكون membership كبيرًا أو يتغير سريعًا. استخدم scoped caching/request context، وراعِ IClaimsTransformation execution frequency و idempotency.
Account Lockout و Security Stamp
Lockout يقلل password guessing بعد محاولات فاشلة، لكنه قد يتحول إلى denial-of-service لو attacker يقدر يقفل حساب ضحية بسهولة. اجمع بين lockout و rate limiting و MFA و monitoring ورسائل عامة. لا تعتمد على IP فقط لأن NAT/shared networks موجودة.
Security Stamp قيمة تتغير عند أحداث حساسة مثل تغيير password أو بيانات أمان، وتستخدم Identity للتحقق من استمرار صلاحية sign-in cookie وفق validation interval. تغيير stamp لا يلغي JWT موقعة بالفعل عند كل API request إلا لو API تتحقق من stamp/version عبر server-side state أو revocation list.
var result = await userManager.ChangePasswordAsync(user, oldPassword, newPassword);
if (result.Succeeded)
{
await userManager.UpdateSecurityStampAsync(user);
await signInManager.RefreshSignInAsync(user);
}Lockout و MFA و Account Enumeration
Lockout دائم بعد محاولات قليلة قد يسمح للمهاجم بقفل حسابات ضحايا؛ استخدم progressive delay/rate limiting ومراقبة، وراجع IP/device signals مع privacy safeguards. Generic login errors تقلل account enumeration، لكن timing/status differences قد تكشف معلومات. لا تعتمد على lockout وحده؛ password spraying يوزع المحاولات على حسابات كثيرة.
عند MFA، recovery codes يجب تخزينها hashed أو بطريقة آمنة، وتكون one-time. تغيير MFA method يحتاج re-authentication وإشعار المستخدم. لا تسمح بتجاوز MFA عبر endpoint قديم أو mobile flow منسي. اختبر recovery journey مثل login journey؛ غالبًا هي أضعف مسار في الحساب.
2FA / TOTP و External Logins و Passkeys
2FA تضيف عاملًا ثانيًا إلى password: authenticator app يولد TOTP، security key، أو recovery code. TOTP يعتمد secret مشترك؛ خزنه محميًا، لا تسجله، ووفّر recovery codes one-time مع regeneration آمن. SMS أقل مقاومة لـ SIM swap و phishing من passkeys/security keys، فلا تقدمه كأقوى عامل.
External login عبر Google/Microsoft يستخدم OIDC/OAuth flow؛ التطبيق يعتمد على provider لإثبات identity، ثم يربط external login بمعرّف user محلي. لا تربط حسابين تلقائيًا لمجرد تطابق email إلا وفق verified-email policy واضحة. تحقق من issuer/audience/nonce/state وفق protocol library، ولا تنفذ OAuth يدويًا.
Passkeys/WebAuthn تستخدم public-key cryptography مرتبطة بالـ relying party origin، وتوفر phishing resistance أفضل من password/OTP التقليدية. تعامل معها كـ credential lifecycle: registration ceremony، challenge، attestation policy، authenticator metadata، recovery، revoke عند فقدان الجهاز. دعمها وتفاصيل UI تتغير حسب framework/provider؛ راجع library/Identity integration الحالية.
MFA Recovery و Account Recovery Threats
تفعيل MFA ليس نهاية القصة. المستخدم قد يفقد هاتفه أو authenticator app؛ لذلك recovery codes، backup factor، verified recovery channels، support-assisted recovery و revoke old authenticators لازم يكون لها flow. Account recovery غالبًا أضعف نقطة في authentication system؛ attacker قد يتجاوز MFA عبر دعم فني ضعيف أو email compromise.
Recovery codes يجب أن تكون one-time، تخزن hashed، وتظهر للمستخدم مرة واحدة عند generation. عند استخدام code، mark it consumed atomically. عند إضافة authenticator جديد أو إزالة القديم، اطلب re-authentication أو step-up authentication، وسجل audit event. لا تسمح بتغيير email/password/MFA بمجرد وجود session قديمة طويلة العمر.
if (!await userManager.VerifyTwoFactorTokenAsync(
user, TokenOptions.DefaultAuthenticatorProvider, request.Code))
{
return Results.Unauthorized();
}
// Only after a fresh second-factor check:
await accountSecurity.ChangeRecoveryEmailAsync(user.Id, request.NewEmail, ct);
await audit.WriteAsync("account.recovery-email.changed", user.Id, ct);المثال conceptual؛ استخدم Identity's supported 2FA flow and token providers بدل بناء TOTP algorithm يدويًا. قرر كيف تتعامل مع backup codes و rate limits ومحاولات guessing.
External Login Account Linking
External login record يربط provider + provider user key بحساب محلي. لا تعتمد على display name أو email غير verified. account linking يجب يبدأ من user authenticated بالفعل، ويطلب re-authentication/step-up عند حساسية الحساب. لو external provider email تغير، لا تنشئ user جديدًا تلقائيًا ولا تنقل ownership بلا تحقق.
افصل sign-in from account linking: تسجيل الدخول عبر Google يثبت provider subject؛ ربط Google بحساب محلي موجود يحتاج إثبات السيطرة على الحساب المحلي. راجع unlink flow: هل المستخدم لديه عامل authentication آخر؟ لا تسمح بفقدان كل طرق الدخول عن طريق unlink آخر provider.
Account Lifecycle و MFA و Recovery
تصميم الحساب يشمل lifecycle كاملًا: registration، email/phone confirmation، password reset، MFA enrollment، recovery codes، lockout، account disable، sign-out، وإلغاء الجلسات. Password reset token قصير العمر ومخصص لغرضه، ولا تسجله في logs. روابط reset يجب أن تستخدم origin موثوقًا من configuration وليس Host header غير موثوق.
بعد تغيير password أو تعطيل الحساب، فكر في إبطال الجلسات والـ refresh tokens. Security Stamp في Identity يساعد على اكتشاف تغييرات أمنية وإعادة التحقق وفق validation interval، لكنه ليس بديلًا عن تصميم token revocation في كل scheme.
var user = await userManager.FindByEmailAsync(request.Email);
if (user is null)
return Results.Ok(); // avoid account enumeration
var token = await userManager.GeneratePasswordResetTokenAsync(user);
var encoded = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(token));
var link = LinkGenerator.GetUriByName(
httpContext, "ResetPassword",
new { userId = user.Id, token = encoded },
scheme: "https", host: trustedPublicHost);
await emailSender.SendPasswordResetAsync(user.Email!, link!, ct);في الكود الواقعي، الـ trustedPublicHost يأتي من configuration ثابتة، وليس من request Host. أضف expiry و rate limits، ولا تُرجع “user not found”. بعد فك Base64Url decode للـ token في endpoint reset، مرره إلى ResetPasswordAsync ولا تخزن token في database كنص قابل للقراءة.
Data Protection: حماية Cookies و Tokens
ASP.NET Core Data Protection تستخدم لحماية payloads مثل authentication cookies و anti-forgery tokens وبعض Identity tokens. في development قد تحفظ keys محليًا؛ في multi-instance production لازم تشارك key ring بين instances وتحميها at rest، وتضبط application name متسقًا. لو كل replica عندها keys مختلفة، cookie أنشأتها instance قد لا تُفك في instance أخرى.
احفظ keys في durable shared storage مناسب، وشفّرها at rest باستخدام certificate/KMS عند الحاجة، وقيّد الوصول. لا تحذف key ring القديمة عشوائيًا؛ قد يؤدي ذلك إلى invalidating cookies/protected payloads. key rotation جزء من lifecycle، وليس مجرد ملف config.
builder.Services.AddDataProtection()
.SetApplicationName("MyShop-Production")
.PersistKeysToFileSystem(new DirectoryInfo("/var/app/shared-keys"));
// In production, protect the key ring at rest using a certificate/KMS
// and mount the directory from durable, access-controlled shared storage.Cookie Sessions و Sliding Expiration و Persistent Login
Cookie authentication ticket قد تحتوي claims و expiry، وتكون protected عبر Data Protection. Sliding expiration تجدد ticket عند نشاط المستخدم وفق thresholds، لكنها لا تعني session لا تنتهي. Persistent cookie قد تبقى بعد إغلاق browser؛ استخدمها فقط مع remember-me policy واضحة ومدة محدودة. Sensitive actions قد تحتاج re-authentication حتى لو session صالحة.
Cookie flags: Secure تمنع إرسالها عبر HTTP، HttpOnly تمنع JS من قراءتها، SameSite تحد من cross-site sending، Path/Domain تحدد scope. استخدم host-only cookies و__Host prefix عندما يناسب، ولا تخزن secrets داخل claims/cookie payload بلا حاجة. راجع cookie size لأن claims كثيرة قد تسبب header bloat.
Identity API Endpoints ومتى تستخدمها؟
ASP.NET Core Identity يوفر APIs/endpoint patterns حسب نوع التطبيق والإصدار، وقد تختار scaffolded UI أو custom endpoints. لا تجعل اختيار الواجهة يغير security invariants: confirmation، lockout، password reset، MFA، rate limiting، audit events، error contracts. راجع generated code ولا تتعامل معه كصندوق أسود.
في clean architecture، لا تجعل Domain layer تعتمد على UserManager أو ASP.NET Identity types. ضع Identity integration في Infrastructure/Application boundary، وحوّل IdentityResult إلى application result. ربط ApplicationUser ب Customer عبر foreign key أو mapping واضح أفضل من خلط بيانات الحساب مع customer business profile.
أخطاء Identity الشائعة ومراجعة أمنية
- تخزين password plaintext أو hash يدوي سريع.
- رسائل login/reset تكشف هل email مسجل.
- عدم تفعيل confirmation أو MFA رغم حساسية الحساب.
- غياب rate limit و lockout monitoring.
- تخزين reset/confirmation tokens في logs أو analytics.
- اعتبار Role وحدها authorization كاملة لكل resource.
- عدم مشاركة Data Protection key ring بين replicas.
- إرجاع Identity error details الخام إلى client.
- الاعتقاد أن security stamp يبطل كل JWT صادر سابقًا.
- عدم وجود account recovery/revocation/audit process.
Identity layer جزء من security architecture. ارسم lifecycle كاملًا: registration → confirmation → login → MFA → access session → password change/reset → session invalidation → account disable/recovery. اختبر كل انتقال، لا happy path فقط.
Identity Lifecycle Review: الحالات التي غالبًا تُنسى
فكر في lifecycle كاملًا: user disabled، deleted/soft-deleted، email changed، account merged، tenant membership removed، password compromised، authenticator lost، external provider unlinked. هل cookie القديمة تظل صالحة؟ هل refresh tokens تُسحب؟ هل background jobs تظل تنفذ باسم user؟ هل audit history يظل محفوظًا؟
تعطيل account يجب أن يمنع إصدار sessions جديدة، وقد يتطلب security stamp update أو server-side account status check. حذف user قد يتعارض مع foreign keys/audit retention؛ كثير من الأنظمة تحتاج deactivate/anonymize بدل hard delete. لا تمسح user record قبل فهم data ownership والـ retention/legal policy.
اختبر فهمك
هل Identity تقوم بال Authorization لكل resource تلقائيًا؟
لماذا لا نخزن SHA256(password) مباشرة؟
هل Security Stamp يلغي JWT فورًا؟
لماذا Data Protection key ring يجب أن تكون مشتركة بين replicas؟
هل تطابق email بين external provider والحساب المحلي يكفي دائمًا للربط؟
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
خريطة التغطية: 17 عنصر من الـ Roadmap ومكان شرحه في الدرس
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.