Table of Contents

Interface IA3Builder

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

Builder for configuring A3 authorization store providers.

public interface IA3Builder
Extension Methods

Remarks

Follows the Microsoft ASP.NET Core Identity IdentityBuilder pattern: a builder returned from AddExcaliburA3() that exposes Use*() methods for registering store implementations.

Properties

Services

Gets the underlying service collection.

IServiceCollection Services { get; }

Property Value

IServiceCollection

The service collection being configured.

Methods

RequireDurableGrants()

Requires the configured grant store to survive a process restart, refusing to start if it does not.

IA3Builder RequireDurableGrants()

Returns

IA3Builder

The builder for chaining.

Remarks

Opt-in, and it must be called to have any effect. Without it a host that falls back to the in-memory grant store starts normally and loses every grant on restart — which surfaces as a silent deny-all rather than an error, because a store that has forgotten its grants is indistinguishable from one whose grants were never made.

Call it when grants must outlive the process. A host that has deliberately accepted a volatile store sets GrantDurabilityOptions.AllowVolatileGrantStore instead; the two together mean "I know, and I accept it", which is a different statement from never having asked.

The verb lives on the builder rather than as a separate service-collection extension because the builder already models this package's configuration; a parallel registration surface for one option would be a second way to say the same thing.

UseActivityGroupStore<TStore>()

Registers a custom activity group store implementation.

IA3Builder UseActivityGroupStore<TStore>() where TStore : class, IActivityGroupStore

Returns

IA3Builder

The builder for chaining.

Type Parameters

TStore

The activity group store implementation type.

UseGrantStore<TStore>()

Registers a custom grant store implementation.

IA3Builder UseGrantStore<TStore>() where TStore : class, IGrantStore

Returns

IA3Builder

The builder for chaining.

Type Parameters

TStore

The grant store implementation type.