Table of Contents

Class CapabilityGrantValidator

Namespace
AsiBackbone.Core.CapabilityGrants
Assembly
AsiBackbone.Core.dll

Validates signed capability grants against host-supplied expectations before a governed operation executes.

public static class CapabilityGrantValidator
Inheritance
CapabilityGrantValidator
Inherited Members

Methods

ValidateAsync(SignedGovernanceArtifact<CapabilityGrant>, CapabilityGrantValidationOptions?, IGovernanceSignatureVerificationService?, ICapabilityGrantUseStore?, CancellationToken)

Validates a signed capability grant against the supplied options.

public static ValueTask<CapabilityGrantValidationResult> ValidateAsync(SignedGovernanceArtifact<CapabilityGrant> signedGrant, CapabilityGrantValidationOptions? options = null, IGovernanceSignatureVerificationService? verificationService = null, ICapabilityGrantUseStore? useStore = null, CancellationToken cancellationToken = default)

Parameters

signedGrant SignedGovernanceArtifact<CapabilityGrant>

The signed capability grant to validate.

options CapabilityGrantValidationOptions

The expectations the grant is validated against. Validation fails when null; use CreateBoundExecutionBoundary(CapabilityGrantBindingExpectations, string?, string?, IEnumerable<string>?, DateTimeOffset?, string?, string?, string?, string?, string?, string?, bool, bool, int, TimeSpan, string?, string?, string?, string?, string?, string?, CanonicalPayloadOptions?) at an execution boundary.

verificationService IGovernanceSignatureVerificationService

The signature verification service, required when proof is required.

useStore ICapabilityGrantUseStore

The use store that consumes grant uses, required when a use check is required.

cancellationToken CancellationToken

A token used to observe cancellation.

Returns

ValueTask<CapabilityGrantValidationResult>

A result whose Action states whether the host should allow, deny, defer, escalate, or require acknowledgment.

Remarks

Validation runs in a fixed order and returns the first failure: proof binding and signature verification when RequireProof is set; then issuer, audience, subject, operation, validity window, scope, policy, acknowledgment, handshake, gateway, and resource expectations; and finally use consumption when RequireUseCheck is set.

Validation fails closed. Omitted options, a missing verifier when proof is required, or a missing use store when a use check is required each produce a failed result rather than a permissive one. Use consumption runs last so a grant that fails any other check does not consume a use.

Exceptions

ArgumentNullException

signedGrant is null.

OperationCanceledException

cancellationToken is cancelled.