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
signedGrantSignedGovernanceArtifact<CapabilityGrant>The signed capability grant to validate.
optionsCapabilityGrantValidationOptionsThe 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.
verificationServiceIGovernanceSignatureVerificationServiceThe signature verification service, required when proof is required.
useStoreICapabilityGrantUseStoreThe use store that consumes grant uses, required when a use check is required.
cancellationTokenCancellationTokenA 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
signedGrantis null.- OperationCanceledException
cancellationTokenis cancelled.