Class ClaimEndpointCapabilityGrantValidator
- Namespace
- ReferenceApplication.Web.Governance
- Assembly
- ReferenceApplication.Web.dll
Validates endpoint capability scopes against the current actor's normalized application permission claims.
public sealed class ClaimEndpointCapabilityGrantValidator : IEndpointCapabilityGrantValidator
- Inheritance
-
ClaimEndpointCapabilityGrantValidator
- Implements
-
IEndpointCapabilityGrantValidator
- Inherited Members
Constructors
ClaimEndpointCapabilityGrantValidator(IOptions<ApplicationAuthorizationOptions>)
Validates endpoint capability scopes against the current actor's normalized application permission claims.
public ClaimEndpointCapabilityGrantValidator(IOptions<ApplicationAuthorizationOptions> authorizationOptionsAccessor)
Parameters
authorizationOptionsAccessorIOptions<ApplicationAuthorizationOptions>
Fields
DeniedReasonCode
Gets the machine-readable reason code returned when the actor lacks a required endpoint capability.
public const string DeniedReasonCode = "referenceapplication.capability.grant_required"
Field Value
Methods
ValidateAsync(HttpContext, EndpointGovernanceDescriptor, GovernanceDecision, CancellationToken)
Validates endpoint capability requirements before endpoint execution continues.
public ValueTask<GovernanceDecision> ValidateAsync(HttpContext httpContext, EndpointGovernanceDescriptor descriptor, GovernanceDecision currentDecision, CancellationToken cancellationToken = default)
Parameters
httpContextHttpContextThe current HTTP context.
descriptorEndpointGovernanceDescriptorThe endpoint governance descriptor.
currentDecisionGovernanceDecisionThe current governance decision.
cancellationTokenCancellationTokenA token that can cancel validation.
Returns
- ValueTask<GovernanceDecision>
A governance decision representing the capability validation result.
Remarks
The validator is called for every decision that is not already denied, so currentDecision
may allow the request, carry a warning, require acknowledgment, be deferred, or recommend escalation. A validator
that does not find every required grant should return a denied decision instead of preserving any of those
outcomes. A valid grant may preserve the current decision so the host can continue its acknowledgment, deferral,
or escalation flow.