Table of Contents

Namespace Excalibur.A3.Authorization

Classes

ActivityGroupCatalogue

A complete, validated activity-group catalogue: the whole set of groups, for every tenant, that ReplaceAllActivityGroupsAsync(ActivityGroupCatalogue, CancellationToken) makes current.

ActivityGroupGrantSnapshot

A validated set of activity-group grants that IActivityGroupGrantReplacement makes current.

ActivityGroupService

Provides services for managing activity groups.

ActivityGroupSyncOptions

Configures how activity-group data is synchronized from the remote authority.

AuthorizationAction

An action being evaluated.

AuthorizationCacheKey

Provides methods to generate cache keys for authorization-related data.

AuthorizationCacheOptions

Configures how long cached authorization data may be served.

AuthorizationDecision

The decision returned by an IAuthorizationEvaluator.

AuthorizationPolicy

Represents an authorization policy that evaluates user permissions and grants based on activities and resources.

AuthorizationPolicyExtensions

Extension methods for IAuthorizationPolicy providing convenience overloads.

AuthorizationResource

A resource targeted by an action.

AuthorizationSubject

A subject (actor) for authorization decisions.

Grant

Provider-neutral authorization grant assigned to a subject for a specific qualifier.

GrantDurabilityOptions

Options governing whether authorization may run on a grant store that does not survive a restart.

GrantRevocationRequest

Immutable payload identifying one retryable atomic revocation operation.

GrantRevocationResult

Committed outcome of one atomic revocation.

GrantRevocationScope

Explicit tenant or estate-wide scope for revoking a user's grants.

GrantsAuthorizationHandler

Authorization handler for GrantsAuthorizationRequirement that validates user permissions based on grants.

GrantsAuthorizationRequirement

Authorization requirement that validates user permissions based on grants for specific activities and resources.

RequirePermissionAttribute

Marks a message type as requiring a specific permission to execute. This attribute works alongside the interface-based authorization system (IRequireAuthorization). When both are present, AND logic applies (both must pass).

RoleOptions

Configuration options for role management.

RoleSummary

Provider-neutral read model for a role.

UserGrantSnapshot

Owned grant snapshot paired with its authoritative user revision.

Structs

ActivityGroupEntry

One activity conferred by one tenant's activity group: a single row of an activity-group catalogue.

ActivityGroupGrantEntry

One activity-group grant: a single row of an activity-group grant snapshot.

PolicyResult

Represents the result of a policy evaluation.

Interfaces

IActivityGroupGrantReplacement

An optional capability of IActivityGroupGrantStore: replacing a set of grants in one atomic step instead of deleting and re-inserting them.

IActivityGroupGrantStore

Activity-group grant operations that span the grant store.

IActivityGroupService

Defines methods for managing activity groups and synchronizing their associated data.

IActivityGroupStore

Provider-neutral store for activity group persistence.

IAtomicGrantRevocationStore

Optional atomic revocation and authoritative revision capability of an IGrantStore.

IAuthorizationEvaluator

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

IAuthorizationPolicy

Represents an authorization policy for validating user access to activities and resources.

IAuthorizationPolicyProvider

Provides functionality to retrieve an authorization policy for the current user.

IDispatchAuthorizationService

Service for authorizing users against specific requirements and policies in the dispatch system.

IDurableGrantStore

Marks an IGrantStore whose grant persistence is durable — grants survive a process restart. A store advertises this capability by answering for it from GetService(Type); consumers query rather than cast, so the capability is discoverable through decorators.

IGrantCommand

Marker interface for commands that create or modify grants.

IGrantQueryStore

Extended query operations for authorization grants.

IGrantStore

Provider-neutral store for authorization grant persistence.

IPolicy

Represents the base interface for all policy types.

IPolicyProvider<TPolicy>

Represents a provider that retrieves a policy of type TPolicy.

IRequireActivityAuthorization

Interface for messages that require activity-based authorization with optional resource-specific permissions.

IRequireAuthorization

Base interface for dispatch messages that require authorization to execute.

IRequireCustomAuthorization

Interface for messages that require custom authorization using specific authorization requirements.

IRequireRoleAuthorization

Interface for messages that require role-based authorization.

IRoleStore

Provider-neutral store for role persistence.

Enums

AuthorizationEffect

The effect of an authorization evaluation.

GrantSyncAtomicity

What an activity-group grant sync does when the configured grant store cannot replace a set of grants atomically.

RoleState

Represents the lifecycle state of a role.