Software Engineer Encyclopedia
0%
Domain 05 · Security & Software Testing · Topic 5.3

Authorization في ASP.NET Core: Policies وResource Ownership ومنع IDOR

Authorization — Roles, Claims, Policies and Resource-Based Access

مرجع Authorization: RBAC/claims/policies، requirements/handlers، resource ownership، least privilege، permissions، multi-tenancy، IDOR، audit واختبارات الصلاحيات.

  • Intermediate
  • ~16 min read
  • 10 sections
  • 13 code examples
  • 1 diagrams
  • 5 questions
  • Priority L1 · Essential
  • ASP.NET Core 10 · .NET 10

المتطلبات قبل ما تبدأ

Web API شغال بقاعدة بيانات (المجالات 03 و04).

مستوى التعمق المطلوب

DEEPVerify that users can access only the resources they are allowed to access.

01

Authorization بتجاوب على سؤال مختلف عن Authentication

Who can do what, on which resource, under which conditions?
Deep dive

Authentication يثبت الهوية، و Authorization يقرر هل principal مسموح له يعمل action على resource محدد. الـ principal قد يكون user أو service/client. قرار الصلاحية لازم يعتمد على identity موثوقة، permission المطلوبة، resource context، tenant boundary، وحالة business. مجرد أن المستخدم authenticated لا يعني أنه يقدر يقرأ أو يعدل أي record.

استخدم 401 عندما لا توجد credentials صالحة أو لم يتم authentication، و403 عندما الهوية معروفة لكن القرار رفض. في بعض الأنظمة قد تستخدم 404 لإخفاء وجود resource عن غير مالكه؛ القرار يعتمد على threat model و consistency مع API contract، لكن لا تستخدمه كبديل عن authorization check.

02

Role-Based و Claims-Based Authorization

Broad roles versus contextual attributes
Deep dive

RBAC يربط user بأدوار مثل Admin/Support/Customer، ثم role تمنح مجموعة capabilities. مناسب للأدوار الواسعة والمستقرة. عيبه أن role explosion يحصل لو حاولت تمثيل كل permission أو resource-specific rule كـ role.

Claims-based يعتمد على assertions مثل department، tenant_id، subscription_level، scope. claims قد تأتي من Identity provider أو token، ولازم تكون trusted ومحدثة بما يناسب حساسية القرار. لا تثق في header أو request field اسمه Role؛ caller يستطيع تغييره.

C#Role and claim checks
app.MapGet("/admin/reports", GetReports)
   .RequireAuthorization(policy => policy.RequireRole("Admin"));

app.MapGet("/finance/summary", GetFinanceSummary)
   .RequireAuthorization(policy =>
       policy.RequireClaim("department", "Finance"));

Role و claim لا يجيبان دائمًا عن resource ownership. User قد يكون Support لكنه لا يحق له تعديل أي Order؛ تحتاج resource-based decision تجمع role مع owner/tenant/status.

Role Hierarchy و Separation of Duties

Role hierarchy مثل Admin يرث Support permissions قد تبدو مريحة، لكنها قد تجعل privilege escalation غير واضح. لا تفترض أن role names لها ترتيب طبيعي. عرّف inheritance explicitly، واختبر effective permissions. بعض العمليات تحتاج separation of duties: الشخص الذي أنشأ refund لا يوافق عليه، أو user لا يوافق على طلبه بنفسه.

استخدم least privilege و temporary elevation عند الحاجة. راجع role assignment endpoints، audit changes، MFA/step-up للـ privileged actions، و break-glass accounts. لا تجعل Admin role متاحة عبر public registration أو claims client-controlled.

Roles vs Claims vs Policies و Least Privilege

Role يصف مجموعة صلاحيات واسعة مرتبطة بمسؤولية، مثل Admin أو Support. Claim هو assertion عن subject مثل department أو tenant أو permission. Policy هي قاعدة قرار تجمع شروطًا. في الأنظمة الصغيرة يمكن أن تكون roles كافية، لكن مع نمو النظام قد تصبح permission-based policies أدق من عشرات roles المتداخلة.

Least privilege يعني أن كل principal يحصل على أقل صلاحيات تكفي لمهمته. لا تستخدم role Admin لتجاوز كل checks داخل التطبيق. افصل عمليات القراءة والتعديل والموافقة المالية، واستخدم resource ownership و tenant boundary. راجع أثر تغيير role على tokens طويلة العمر؛ claims داخل JWT تظل كما صدرت حتى انتهاء token أو revocation strategy.

C#Practical engineering example
builder.Services.AddAuthorization(options =>
{
    options.AddPolicy("CanApproveRefund", policy =>
        policy.RequireAuthenticatedUser()
              .RequireClaim("permission", "refund.approve")
              .RequireClaim("tenant_id"));
});

app.MapPost("/refunds/{id:int}/approve", ApproveRefund)
   .RequireAuthorization("CanApproveRefund");

الـ claim هنا لا يكفي وحده لو permission قد تتغير بسرعة؛ token claims snapshot. للعمليات الحساسة استخدم short-lived tokens أو server-side permission lookup/cache invalidation. تأكد أيضًا من tenant claim match مع tenant الخاص بالمورد نفسه، لا مجرد وجود claim.

03

Policy-Based Authorization و Requirements

Compose reusable access rules
Deep dive

Policy عبارة عن مجموعة requirements. كل requirement لازم ينجح (AND semantics داخل policy عادة)، والـ handler ينفذ منطق تقييمه. تقدر تستخدم built-in requirements مثل authenticated user/role/claim، أو تكتب requirement مخصصة. ده يفصل policy name عن طريقة التنفيذ ويسمح بإعادة الاستخدام والاختبار.

C#Register and apply a policy
builder.Services.AddAuthorization(options =>
{
    options.AddPolicy("CanManageCatalog", policy => policy
        .RequireAuthenticatedUser()
        .RequireClaim("permission", "catalog.manage"));

    options.AddPolicy("SupportOrAdmin", policy => policy
        .RequireRole("Support", "Admin"));
});

app.MapGroup("/catalog/admin")
   .RequireAuthorization("CanManageCatalog");

Fallback policy يمكنها فرض authentication افتراضيًا على endpoints التي لا تحمل metadata authorization، مع AllowAnonymous للاستثناءات المقصودة. لكن static files التي تُخدم قبل authorization middleware لا تصبح محمية تلقائيًا. راجع ترتيب middleware ومسارات الملفات الخاصة.

C#Custom requirement and handler
public sealed record MinimumAccountAgeRequirement(int Days)
    : IAuthorizationRequirement;

public sealed class MinimumAccountAgeHandler(IClock clock)
    : AuthorizationHandler<MinimumAccountAgeRequirement>
{
    protected override Task HandleRequirementAsync(
        AuthorizationHandlerContext context,
        MinimumAccountAgeRequirement requirement)
    {
        var claim = context.User.FindFirst("account_created_at");
        if (claim is not null &&
            DateTimeOffset.TryParse(claim.Value, out var createdAt) &&
            clock.UtcNow - createdAt >= TimeSpan.FromDays(requirement.Days))
        {
            context.Succeed(requirement);
        }
        return Task.CompletedTask;
    }
}

لو requirement تعتمد على current database state، handler قد يحتاج service scoped لقراءة البيانات. لا تخزن user-specific mutable state داخل singleton handler. وتجنب handlers تعمل query كثيرة لكل request؛ صمم data access مناسبًا أو حمل context الضروري.

Policy-Based Authorization: Requirements و Handlers

Role-based checks مناسبة لصلاحيات واسعة مثل Admin/Support، لكن policies أفضل عندما القرار يتكون من requirements مثل CanApproveInvoice أو TenantMember. Handler يقرأ claims أو resource state ويقرر Succeed أو لا. لا تجعل policy تعتمد على UI state أو input غير موثوق. عند resource authorization استخدم resource نفسه لتقييم owner/status/tenant.

افصل policy naming عن role names حتى تقدر تغير implementation دون تغيير endpoints. لا تضع role IDs numeric hardcoded في controllers؛ استخدم constants أو permissions catalog. لو permission تتغير وقت التشغيل، حدد cache invalidation و claims refresh. Claims داخل JWT snapshot قد تظل قديمة حتى expiry، لذلك الحسّاس قد يحتاج DB lookup أو token version/session revocation.

كيف Policy Authorization بتتقيّم؟

Principal Authenticated claims Policy Requirements Handler Evaluate resource Endpoint Allow / forbid
Policy authorization flow

Policy authorization تتكون من requirements و handlers. الـ policy تجمع requirements، وكل requirement يجب أن ينجح حتى تعتبر policy ناجحة (AND بين requirements)، بينما يمكن أن ينجح أي handler يحقق requirement بعينه. هذا يسمح بفصل policy declaration عن business evaluation.

Resource-based authorization مهمة عندما القرار يعتمد على record معين مثل Order. الـ attribute وحده لا يستطيع تقييم resource لم يتم تحميله بعد؛ حمّل المورد ثم استدعِ IAuthorizationService.AuthorizeAsync. لا تعتمد على إخفاء زر في UI؛ enforcement يجب أن يكون server-side في كل endpoint.

C#Practical engineering example
public sealed record OrderOwnerRequirement : IAuthorizationRequirement;

public sealed class OrderOwnerHandler
    : AuthorizationHandler<OrderOwnerRequirement, Order>
{
    protected override Task HandleRequirementAsync(
        AuthorizationHandlerContext context,
        OrderOwnerRequirement requirement,
        Order order)
    {
        var userId = context.User.FindFirstValue(ClaimTypes.NameIdentifier);
        if (userId is not null && order.CustomerUserId == userId)
            context.Succeed(requirement);
        return Task.CompletedTask;
    }
}

// Endpoint: load resource, then authorize it.
var result = await authorization.AuthorizeAsync(user, order, "OrderOwner");
if (!result.Succeeded) return Results.Forbid();

في الإنتاج أضف policy registration و handler DI، وقرر هل عدم وجود resource يرجع 404 لمنع enumeration أم 403 بعد إثبات وجوده. لا تسمح للـ client بإرسال CustomerUserId وتثق به؛ خذ identity من authenticated principal وقارنها بملكية المورد من database.

Default Policy و Fallback Policy و Endpoint Groups

Default policy تستخدم عندما endpoint عليها authorize metadata بدون اسم policy، أما fallback policy تطبق على endpoints التي لا تحمل authorization metadata أصلًا. لو التطبيق private API في أغلبه، fallback policy قد تمنع endpoint جديدة من أن تكون public بالخطأ. استخدم AllowAnonymous فقط لمسارات مقصودة مثل login/health حسب threat model.

C#Require authentication by default
builder.Services.AddAuthorization(options =>
{
    options.FallbackPolicy = new AuthorizationPolicyBuilder()
        .RequireAuthenticatedUser()
        .Build();
});

var api = app.MapGroup("/api")
    .RequireAuthorization();

api.MapGet("/profile", GetProfile);
app.MapPost("/auth/login", Login).AllowAnonymous();

Fallback policy لا تحمي static files التي تُخدم قبل authorization middleware. راجع static file middleware و web root و private downloads. لا تعتبر MapGroup security boundary إذا endpoints خارج group ما زالت موجودة.

Policy Logic: AND و OR و Multiple Requirements

Policy قد تحتوي requirements متعددة؛ افتراضيًا يجب أن تنجح كلها (AND). داخل requirement نفسها يمكن handler يسمح عبر أكثر من path، لكن وضح semantics. مثال: access يحتاج authenticated + tenant membership + permission. أما «Admin أو Owner» يمكن تمثيله بـ handlers/requirements أو policy combination مع OR semantics مدروسة. لا تكتب شرطًا مبهمًا يصعب مراجعته.

لو عندك policy متداخلة كثيرة، اكتب requirement domain-specific مثل CanRefundOrder بدل تجميع أسماء roles في كل endpoint. لكن لا تجعل requirement واحدة تتحول إلى business workflow كامل. Authorization يقرر access؛ business operation نفسها تظل داخل use case/domain.

Dynamic Authorization Policy Provider

في systems فيها عشرات permissions، يمكن أن تستخدم policy names مثل Permission:orders.refund وتكتب custom IAuthorizationPolicyProvider يبني policy ديناميكيًا. ده يقلل تسجيل policy واحدة لكل permission، لكنه يزيد complexity ويحتاج cache و strict parsing. لا تقبل policy string حرة من client؛ policy name جزء من server endpoint metadata.

permission catalog يجب يكون controlled. parser يرفض unknown permission names، handler يتحقق من user/tenant membership، و policy cache لا تتسبب في stale access بعد revocation. لو permissions قليلة، registration الصريح أبسط وأسهل في review.

Caching Authorization Decisions

Cache permission lookups قد تحسن performance، لكن revocation delay تصبح security trade-off. حدد TTL قصير أو version stamp/invalidation event. لو permission تغيرت من Admin إلى User، هل يظل token أو cache يسمح بالعملية؟ للعمليات الحساسة، check current state أو use short-lived credentials. لا تجعل cache outage يسمح access by default.

Cache key يجب تتضمن user + tenant + permission catalog version، ولا تخلط tenants. لا تخزن decisions based on resource ownership تحت key عامة. Authorization cache failure غالبًا fail-closed في security-critical paths؛ قرر per policy.

04

Resource-Based Authorization: القرار بعد تحميل المورد

Ownership and contextual checks
Deep dive

Resource-based authorization ضروري عندما القرار يعتمد على record نفسه: هل هذا المستخدم مالك Order؟ هل document داخل tenant؟ هل invoice في حالة تسمح بالتعديل؟ Attribute مثل [Authorize] يتم تقييمه قبل تحميل resource، لذلك لا يكفي وحده لاتخاذ قرار يعتمد على بيانات لم تُحمّل بعد. استخدم IAuthorizationService.AuthorizeAsync بعد تحميل resource.

C#Resource-based authorization in an endpoint
app.MapPut("/orders/{id:int}", async (
    int id, UpdateOrderRequest request,
    ClaimsPrincipal user,
    IOrderRepository orders,
    IAuthorizationService authorization,
    CancellationToken ct) =>
{
    var order = await orders.GetAsync(id, ct);
    if (order is null) return Results.NotFound();

    var decision = await authorization.AuthorizeAsync(
        user, order, "CanEditOrder");
    if (!decision.Succeeded) return Results.Forbid();

    order.ChangeShippingAddress(request.Address);
    await orders.SaveChangesAsync(ct);
    return Results.NoContent();
}).RequireAuthorization();
C#Ownership requirement and handler
public sealed class OrderOwnerRequirement : IAuthorizationRequirement;

public sealed class OrderOwnerHandler
    : AuthorizationHandler<OrderOwnerRequirement, Order>
{
    protected override Task HandleRequirementAsync(
        AuthorizationHandlerContext context,
        OrderOwnerRequirement requirement,
        Order order)
    {
        var userId = context.User.FindFirstValue(ClaimTypes.NameIdentifier);
        if (userId is not null && order.CustomerUserId == userId)
            context.Succeed(requirement);
        return Task.CompletedTask;
    }
}

الـ handler لا ينبغي أن يثق في owner id من request body. يقارن resource المحمّل بهوية principal الموثوقة. ولو Support/Admin لهم access إضافي، أضف requirement/handler واضحًا أو policy متعددة الشروط، ولا تضع bypass مخفيًا في كل endpoint.

Resource-Based Authorization و Ownership Checks

Role مثل Admin أو Customer لا يكفي وحده عندما القرار يعتمد على resource owner أو state. Resource-based authorization يحمل resource إلى IAuthorizationService.AuthorizeAsync(user, resource, requirement)، ويقرر policy هل المستخدم يستطيع قراءة/تعديل هذا الطلب. نفّذ check بعد تحميل resource آمنًا، أو ضمن query scoped يقلل IDOR exposure.

C#Resource authorization handler
public sealed record EditOrderRequirement : IAuthorizationRequirement;
public sealed class EditOrderHandler : AuthorizationHandler<EditOrderRequirement, Order>
{
    protected override Task HandleRequirementAsync(
        AuthorizationHandlerContext context,
        EditOrderRequirement requirement,
        Order order)
    {
        var userId = context.User.FindFirstValue(ClaimTypes.NameIdentifier);
        if (userId == order.CustomerUserId && order.Status == OrderStatus.Draft)
            context.Succeed(requirement);
        return Task.CompletedTask;
    }
}

لا تثق في CustomerId القادم من request body؛ اربط ownership بالهوية الموثقة. اختبر مستخدمًا آخر، tenant آخر، resource محذوف، status غير مسموح، admin policy، و anonymous. إخفاء زر Edit في UI ليس authorization.

Resource Authorization مع Query Scoping

أحيانًا أفضل query تكون scoped من البداية: WHERE Id=@id AND TenantId=@tenant. ده يمنع تحميل resource من tenant آخر أصلًا ويقلل accidental leak. بعدها قد تحتاج resource handler لتطبيق policy أعقد مثل Support role أو resource state. لا تعمل query عامة ثم تنسى authorize في فرع error أو export.

لو resource غير موجود أو ليس للمستخدم، هل ترجع 404 في الحالتين لتقليل enumeration أم 403 عند وجوده؟ اختَر contract موحدًا. لا تكشف بيانات resource في error response قبل authorization. download URLs المؤقتة تحتاج expiry/scope، ولا تعتبر storage object key سرًا كافيًا.

05

IDOR و Broken Access Control

Never authorize by identifier alone
Deep dive

IDOR (Insecure Direct Object Reference) يحدث لما API تسمح للمستخدم بالوصول إلى object بمجرد معرفة/تخمين identifier. UUID بدل integer لا يحل المشكلة؛ identifiers ليست authorization. مثال: GET /orders/1001 يجب أن يتحقق أن order تابع للمستخدم أو أنه يملك permission مناسبة.

نمط خطير: var order = db.Orders.Find(id); return order; من غير owner/tenant filter أو authorization. نمط دفاعي: query scoped من البداية مثل Where(o => o.Id == id && o.Customer.UserId == userId) ثم resource check إضافي لو فيه policies أعقد. ده يقلل accidental data exposure، لكن لا يغني عن اختبار الوصول.

C#Tenant/owner-scoped query
var order = await db.Orders
    .Where(o => o.Id == id && o.TenantId == tenantId)
    .SingleOrDefaultAsync(ct);

if (order is null) return Results.NotFound();
// Apply additional resource policy if the tenant has internal roles.

راجع كل endpoint تقبل IDs: GET by id، update، delete، download file، nested resource، export، bulk action، GraphQL resolver، SignalR hub method. الـ access check لازم يتطبق على كل path، مش صفحة التفاصيل فقط.

IDOR و Mass Assignment و Over-Posting

IDOR يحدث عندما endpoint يأخذ orderId من العميل ثم يرجع order بلا فحص ownership. استخدم scoped query مثل WHERE Id = @id AND TenantId = @tenant أو resource authorization بعد load. لا تعتمد على GUID كحماية؛ معرف عشوائي لا يلغي permission check. عند not found/forbidden، اختر response لا يكشف وجود بيانات حساسة.

Mass assignment يحدث عندما تربط request DTO مباشرة إلى entity وتسمح للعميل بإرسال IsAdmin أو TenantId أو PaidAt. استخدم input DTOs محددة allow-listed، وحدّث fields المسموحة صراحة، واحمِ sensitive state داخل domain methods. اختبر payload يحتوي حقولًا إضافية أو محاولة تغيير owner/status/price.

06

Permission-Based Design و Multi-Tenant Authorization

Fine-grained access models
Deep dive

Permission-based model يعرّف permissions ثابتة مثل orders.read و orders.refund و users.invite، ثم يربط roles بمجموعة permissions و users/teams بالأدوار. خزن permission catalog في code أو controlled schema، وراجع التغيير كجزء من release. لا تقبل permission names حرة من client.

في multi-tenancy، tenant isolation شرط أمني أساسي. tenant id يجب أن يأتي من trusted identity/session context أو server-side membership lookup، لا من query/body وحده. لو user عضو في عدة tenants، اختَر active tenant من request لكن تحقق من membership. ضع tenant predicate في كل data access path، وفكر في database row-level security أو schema/database per tenant حسب threat model.

C#Resolve tenant membership before querying
var userId = user.FindFirstValue(ClaimTypes.NameIdentifier)!;
var tenant = await tenantMemberships.GetActiveMembershipAsync(
    userId, requestedTenantId, ct);
if (tenant is null) return Results.Forbid();

var invoices = await db.Invoices.AsNoTracking()
    .Where(x => x.TenantId == tenant.TenantId)
    .Select(x => new InvoiceRow(x.Id, x.Number, x.Total))
    .ToListAsync(ct);

لا تعتمد على global query filter وحده كحاجز أمني وحيد؛ قد يتم تجاوزه بـ IgnoreQueryFilters أو raw SQL أو context misconfiguration. اجعل tenant scope mandatory في repositories/use cases واختبر cross-tenant access بشكل صريح.

Permission-Based Authorization: من Role إلى Permission Catalog

Permission model مناسب عندما roles الواسعة لا تكفي: orders.read، orders.cancel، payments.refund، users.invite. خزّن mapping role→permissions أو tenant role assignments حسب business. permission names يجب تكون catalog controlled في code/database migration، وليس نصًا يرسله client. قرر هل permissions تُحمّل في claims أم يتم resolve من store؛ claims أسرع لكنها stale حتى تجديد token/session.

C#Permission requirement
public sealed record PermissionRequirement(string Name)
    : IAuthorizationRequirement;

public sealed class PermissionHandler(IPermissionService permissions)
    : AuthorizationHandler<PermissionRequirement>
{
    protected override async Task HandleRequirementAsync(
        AuthorizationHandlerContext context,
        PermissionRequirement requirement)
    {
        var userId = context.User.FindFirstValue(ClaimTypes.NameIdentifier);
        if (userId is null) return;

        if (await permissions.UserHasPermissionAsync(
                userId, requirement.Name, CancellationToken.None))
            context.Succeed(requirement);
    }
}

في handler الحقيقي، راعِ cancellation/request context، caching permission lookup، tenant scope، و service lifetime. لا تجعل handler singleton يحتفظ DbContext scoped. لو permissions تتغير بسرعة، حدد invalidation strategy ولا تعتمد على JWT claims قديمة إلى الأبد.

Multi-Tenant Authorization و Data Isolation

في multi-tenant app، استخرج tenant context من trusted identity/host mapping وليس من query parameter وحده. طبّق tenant scoping في data access، unique constraints المركبة (TenantId + BusinessKey)، cache keys، blob paths، background jobs، audit logs، و message contracts. نسيان tenant filter في endpoint أو job قد يتحول إلى cross-tenant data leak.

Global query filters في EF Core مفيدة كطبقة دفاع، لكنها لا تكفي وحدها؛ يمكن تجاوزها بـ IgnoreQueryFilters أو raw SQL، ويجب أن يكون tenant context مضبوطًا لكل DbContext. اختبر negative cases ببيانات tenant A و B وتأكد أن A لا يستطيع تخمين ID في B. افصل platform admin access ب policy واضحة ومراجعة audit.

07

Least Privilege و Audit Logging

Minimize authority and preserve accountability
Deep dive

Least Privilege: المستخدم والخدمة يحصلان على أقل صلاحيات لازمة ولأقصر مدة مناسبة. افصل admin operations عن user operations، واستخدم service identities مستقلة لكل integration، وقلل wildcard permissions. في backend، authorization ليس فقط على endpoints؛ راجع job handlers و scheduled tasks و file storage و database credentials.

Audit log يسجل من نفذ ماذا وعلى أي resource ومتى والنتيجة، مع correlation id وسبب القرار عند الحاجة. لا تخلط audit trail مع application debug logs؛ audit له retention/integrity/access requirements. لا تسجل access tokens أو passwords أو full sensitive payload. سجّل تغييرات role/permission و export/download و refund/delete والعمليات الحساسة.

Authorization Audit: تسجيل Allow و Deny

سجل sensitive allow/deny decisions مع actor id، tenant، action، resource type/id، policy/permission، outcome، timestamp، correlation id. لا تسجل full resource payload أو secrets. كثرة denied attempts قد تشير إلى enumeration/abuse؛ لكن 403 واحدة لا تعني attack. استخدم rate-based alerts و sampling للـ noisy events.

لا تجعل logging failure يمنع كل authorization decision إلا لو audit requirement يفرض ذلك؛ في financial/admin actions قد تحتاج durable audit record ضمن transaction. لو audit table في نفس DB، سجّلها مع state change عندما مطلوب consistency. outbox قد ينشر audit event لاحقًا.

08

اختبار Authorization: لا تختبر النجاح فقط

Positive, negative and cross-tenant tests
Deep dive

لكل action اختبر: anonymous، authenticated بلا permission، role صحيح، claim ناقص/قديم، owner، non-owner، tenant آخر، resource not found، resource state غير مسموح، admin/support override، و bulk endpoint. اختبر كذلك إن side effect لم يحدث عند 403؛ مجرد status code لا يكفي.

C#Authorization integration test outline
[Theory]
[InlineData("owner", HttpStatusCode.NoContent)]
[InlineData("other-user", HttpStatusCode.Forbidden)]
[InlineData("anonymous", HttpStatusCode.Unauthorized)]
public async Task Only_owner_can_update_order(
    string identity, HttpStatusCode expected)
{
    using var client = CreateClientAs(identity);
    var response = await client.PutAsJsonAsync(
        "/orders/1001", new UpdateOrderRequest("New address"));
    Assert.Equal(expected, response.StatusCode);
    Assert.Equal(0, await CountUnauthorizedOrderMutationsAsync());
}

استخدم fixtures متعددة users/tenants حتى لا تختبر دائمًا نفس الحالة. اختبر IDs عشوائية و enumeration، وراقب إن error messages لا تكشف معلومات أكثر من اللازم. راجع authorization matrix كوثيقة قابلة للمراجعة مع product/security teams.

Authorization Matrix: وثيقة الاختبار والتصميم

أنشئ matrix لكل resource/action: roles/permissions المطلوبة، ownership rule، tenant rule، state constraints، anonymous behavior، audit requirement. مثال: Customer يقرأ Order الخاصة به؛ Support يقرأ orders داخل tenant المخصص؛ Admin يعدل settings؛ Refund permission + order paid + refund window. matrix تكشف gaps أسرع من مراجعة attributes منفردة.

اربط كل row في matrix بـ integration test. عند إضافة endpoint جديدة، اطلب تحديد permission/ownership في pull request. لا تترك القرار ضمنيًا في frontend أو naming convention. audit log يجب أن يسجل actor، tenant، action، resource id، outcome، correlation id والسبب عند الرفض الحساس.

09

Authorization Review Checklist

Before production
Practical
  • هل كل endpoint محمية افتراضيًا أو معلنة كـ AllowAnonymous بوضوح؟
  • هل كل resource lookup scoped حسب owner/tenant؟
  • هل IDOR اختُبر على GET/PUT/DELETE/download/bulk؟
  • هل role/claim values تأتي من issuer موثوق؟
  • هل permissions أقل ما يمكن ومقسمة حسب action؟
  • هل resource-based handler يستخدم بيانات server-side؟
  • هل tenant id لا يُقبل من client كحقيقة؟
  • هل background jobs و SignalR و exports محمية أيضًا؟
  • هل audit يسجل sensitive actions دون secrets؟
  • هل integration tests تثبت عدم حدوث side effect عند الرفض؟
10

اختبر فهمك

Knowledge check
Practical
هل UUID يمنع IDOR؟
لا؛ المعرف غير القابل للتخمين ليس authorization. يجب فحص owner/tenant/permission على كل resource.
لماذا لا تكفي Authorize attribute لقرار ownership؟
لأنها غالبًا تُقيّم قبل تحميل resource؛ استخدم resource-based authorization بعد جلبه.
ما الفرق بين Role و Permission؟
Role grouping واسع للمستخدمين؛ Permission قدرة دقيقة على action مثل orders.refund.
هل tenant id القادم من request آمن؟
لا؛ يجب التحقق من membership وربطه بهوية موثوقة ثم استخدامه في كل data access.
ما الذي يجب اختباره عند 403؟
ليس status فقط؛ تحقق أن أي mutation أو external side effect لم يحدث.
↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

خريطة التغطية: 13 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapRole-Based Authorization§01
RoadmapClaims-Based Authorization§01
RoadmapPolicy-Based Authorization§01
RoadmapResource-Based Authorization§03
RoadmapAuthorization Handlers§03
RoadmapResource Ownership Checks§03
RoadmapLeast Privilege§02
RoadmapEndpoint Protection§01
RoadmapIDOR and Broken Access Control§03
RoadmapTesting Authorization Rules§03
SuggestedPermission-based authorization design§03
SuggestedMulti-tenant authorization§03
SuggestedAudit logging for sensitive actions§03

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس