Table of Contents

Interface IAuthorizationEvaluator

Namespace
Excalibur.A3.Authorization
Assembly
Excalibur.A3.Abstractions.dll

Evaluates whether a given AuthorizationSubject is permitted to perform an AuthorizationAction on a specific AuthorizationResource. Implementations must be provider-neutral and thread-safe.

public interface IAuthorizationEvaluator

Methods

EvaluateAsync(AuthorizationSubject, AuthorizationAction, AuthorizationResource, CancellationToken)

Evaluates an authorization decision for the supplied subject, action, and resource.

Task<AuthorizationDecision> EvaluateAsync(AuthorizationSubject subject, AuthorizationAction action, AuthorizationResource resource, CancellationToken cancellationToken)

Parameters

subject AuthorizationSubject

The actor (user/service) attempting the action.

action AuthorizationAction

The action to evaluate (e.g., "Read", "Write").

resource AuthorizationResource

The target resource for the action.

cancellationToken CancellationToken

Cancellation token.

Returns

Task<AuthorizationDecision>

An AuthorizationDecision describing the evaluation result.

Remarks

Fail-closed postcondition. The returned decision MUST default to denial: access is granted only when the decision's effect is explicitly Permit. Any other effect — Deny or a default-initialized effect — MUST be treated by callers as a denial. Implementations MUST NOT return Permit on an error, timeout, or ambiguous result; on any failure to reach a positive decision they return Deny, never a silent permit.