Stratara.Identity.EntityFrameworkCore 4.6.1

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Stratara.Identity.EntityFrameworkCore --version 4.6.1
                    
NuGet\Install-Package Stratara.Identity.EntityFrameworkCore -Version 4.6.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Stratara.Identity.EntityFrameworkCore" Version="4.6.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Stratara.Identity.EntityFrameworkCore" Version="4.6.1" />
                    
Directory.Packages.props
<PackageReference Include="Stratara.Identity.EntityFrameworkCore" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Stratara.Identity.EntityFrameworkCore --version 4.6.1
                    
#r "nuget: Stratara.Identity.EntityFrameworkCore, 4.6.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Stratara.Identity.EntityFrameworkCore@4.6.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Stratara.Identity.EntityFrameworkCore&version=4.6.1
                    
Install as a Cake Addin
#tool nuget:?package=Stratara.Identity.EntityFrameworkCore&version=4.6.1
                    
Install as a Cake Tool

Stratara.Identity.EntityFrameworkCore

Derived. The behaviour described here is specified under openspec/specs/. Those specifications are the source; this page explains and illustrates them.

EF Core identity-directory plane for the Stratara stack: user↔tenant membership (many-to-many with tenant-scoped roles), active-tenant selection, and membership-backed authorization.

Contents

  • IdentityDirectoryDbContext<TContext> — standalone DbContext hosting all four directory tables (tenant_membership, active_tenant, setting_entry, api_key); derive a concrete context and own its migrations. To fold these into an existing context instead, call modelBuilder.ApplyIdentityDirectoryModel() in its OnModelCreating.
  • ModelBuilder.ApplyIdentityDirectoryModel() — adds the same tables to an existing context (for example your ASP.NET Identity context) so they share one migration lineage.
  • AddTenantMembershipStore<TContext>() — EF-backed ITenantMembershipStore: forward lookup (a user's tenants), reverse lookup (a tenant's members), upsert, GDPR sweeps per user/tenant, and membership-guarded active-tenant switching.
  • MembershipAuthorizationProvider / MembershipAuthorizationProvider<TUser> — the framework's default IAuthorizationProvider: role checks pass on tenant-scoped membership roles, the TUser variant additionally on global ASP.NET Identity roles (platform roles).
  • AddMembershipCrossTenantAuthorizer(...) — membership-backed ICrossTenantAuthorizer for strict tenant isolation, with configurable cross-tenant roles for the operator-impersonation path (platform administrators without membership in the target tenant).
  • AddPermissionCatalog(...) + AddCatalogPermissionResolver[<TUser>]() — the application's code-declared permission vocabulary with role grants, resolved from membership roles (and optionally global ASP.NET Identity roles) for [RequirePermission] enforcement and HTTP permission policies.
  • AddApiKeyStore<TContext>() — API keys and personal access tokens: stk_-prefixed 256-bit keys (hash-only storage), fail-closed validation with expiry/revocation, erasure sweeps. Machine keys are materialized as tenant memberships, so they flow through the same role/permission plane as human actors; PATs act as their bound user. ImportAsync stores a machine key the caller already holds (generated with ApiKeyFormat.CreateRawKey()) for setups where the key must exist before boot — idempotent, never mutating an already-stored key.
  • AddSettingCatalog(...) + AddSettingStore<TContext>() — scoped settings plane: code-declared SettingDefinitions, row-per-key EF storage (setting_entry), a Subject-fed ISettingProvider fallback chain (user-in-tenant → user → tenant → global → configuration → default), transparent AES-GCM encryption for IsEncrypted definitions, and per-user/per-tenant erasure sweeps.
  • AddTenantMembershipStoreFromContextFactory<TContext>(), AddApiKeyStoreFromContextFactory<TContext>(), AddSettingStoreFromContextFactory<TContext>() — the same three stores, taking a fresh context per operation from IDbContextFactory<TContext> instead of sharing the request's. See below.

One context for the request, or one per operation

The plain registrations give every directory store in a request the same context instance. A database context serves one operation at a time, so directory work issued concurrently inside one request fails on whichever operation arrives second — at the call site that lost the race, not the one that introduced the concurrency. Sharing also means a store's own commit commits whatever else the consumer has left unsaved on that context.

The …FromContextFactory variants remove both: each operation creates its own context and disposes it. In exchange, a store write no longer takes part in a transaction the consumer opened on their own scoped context. That trade is why the shared registration stays the default rather than being replaced.

They require AddDbContextFactory<TContext>(); a missing registration fails at first resolution. Keep the factory's options aligned with the scoped registration — interceptors, query filters and conventions are configured per registration, not per context type. Calling both variants for the same store leaves whichever ran first in place; they do not compose.

Dependencies

  • Microsoft.EntityFrameworkCore (+ Relational)
  • Microsoft.Extensions.Identity.Core
  • Stratara.Abstractions

Used together with Stratara.Mediator (authorizing mediator, tenant isolation) and Stratara.Identity.AspNetCore (sign-in claims bridge).

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.7.0 0 10/30/2026
4.6.1 44 10/29/2026
4.6.0 108 10/28/2026
4.5.0 225 10/28/2026
4.4.10 182 10/26/2026
4.4.9 88 10/26/2026
4.4.8 228 10/24/2026
4.4.7 95 10/23/2026
4.4.6 204 10/22/2026
4.4.5 639 10/14/2026
4.4.4 373 10/10/2026
4.4.3 107 10/10/2026
4.4.2 459 10/2/2026
4.4.1 418 9/29/2026
4.4.0 150 9/27/2026
4.3.1 125 9/25/2026
4.3.0 394 9/23/2026
4.2.0 155 9/18/2026
4.1.1 92 9/16/2026
4.1.0 106 9/16/2026
Loading failed

A release about two costs of the Orleans execution model that grew with the deployment rather than with the work.

A commit woke every projection and saga reader of each partition it touched, whatever it had committed. Every one of
them read the new entries and wrote its checkpoint, also when it applied nothing, and every reader polled the store on
its own: every single-event command cost a checkpoint write per projection and saga, and an idle silo with many
consumers kept the store busy with hundreds of reads a second. A commit now costs work only for the readers it
concerns, and an idle silo asks the store a few questions per partition and poll interval.

A recorded command whose handler met a concurrency conflict waited for its hand-over to lapse, 30 seconds by default,
before the drain ran it again; on the bus a conflicting message is redelivered at once. It now runs again within
moments.

### Added

- **`ProjectionGrainOptions.IdleCheckpointInterval`** (default 30 seconds) bounds how long a projection's reader may
 hold its checkpoint back past entries it applied nothing for. `TimeSpan.Zero` writes the checkpoint after every
 batch, as before.
- **`ICommandIntentStore.CountConflictAsync`** counts a conflict and records it without giving the attempt back, and
 answers how many conflicts the command has met. The default records through `RecordConflictAsync` and answers
 `null`, so an intent store of your own compiles and behaves as before; the framework's store implements it.

### Changed

- **A commit wakes only the readers whose projection or saga applies one of its event types.** This holds for the
 wake-up on a silo with a store-reading role and for `AddStrataraStoreWakeUps()`. Woken by every commit as before:
 a stateful saga process, which decides from the event itself, and every reader when the commit holds an event type
 the silo cannot resolve or whose upcaster refuses an empty payload, or when the host's upcaster pipeline is its own.
 A multi-stream commit wakes, in each partition, the readers of the events it wrote there. In a test host with six
 projections of which one applied the commit, ten commits cost 59 store reads before and only the applying
 projection's reads now, and a commit nobody applies costs no read when it is made. A reader whose partition moved
 past it still reads once at its next poll, and then waits again.
- **A projection's reader writes its checkpoint past entries it applied nothing for later**: with the next batch that
 applies something, once `IdleCheckpointInterval` has passed, or when it deactivates. It answers waits for its
 projection from the position it holds. A reader whose silo dies before the write reads those entries again and
 applies nothing for them. A rebuild or a replay discards a position held back. A saga's reader writes its checkpoint
 after every batch as before, because a saga added to a running deployment starts where the host's sagas have
 written they read.
- **A poll reads the store only when its partition holds something past the reader's position.** Each silo asks the
 store for a partition's head at most once per half poll interval, for all its readers. In the test host, 96 idle
 readers polling every 500 ms read the store about 960 times in five seconds before and not at all now. A lost
 wake-up is applied within about one and a half poll intervals rather than one. A committed position reader that
 does not override `ICommittedPositionReader.HeadAsync` keeps polling as before.
- **A conflicting recorded command runs again at once.** The silo that ran it runs it again in a unit of work of its
 own while it still holds the hand-over, pausing as the `ResilienceNames.ConcurrencyConflict` pipeline does (five
 retries from 50 ms), on the aggregate activation's scheduler. A heavy command keeps its permit. Every conflict is
 still recorded and counted, and the command runs again only while its conflicts stay within
 `MessageRetryOptions.MaxConflictRequeues`, so a command that conflicts on every attempt runs as often as before and
 is kept. The hand-over's attempt is given back once when the command leaves on a conflict, however often it ran.
 After the pipeline's retries the drain resumes it as before.
- **`ExecutionModelTestHost.WaitForReadersAsync` waits for the readers' positions**, not their stored checkpoints,
 so it returns once every reader has read to the head, whether or not it has written its checkpoint there yet.

**Upgrading:** nothing to do. Hosts and silos of 4.6.0 and of this release mix in a rolling deployment: the cluster
wake-up keeps its form, an earlier host's wake-up wakes every reader, and an earlier silo wakes every reader of a newer
host's wake-up. Checkpoints keep their form. An intent store of your own keeps the old timing after a conflict until
it implements `CountConflictAsync`.