Stratara.Identity.AspNetCore
4.1.0
Prefix Reserved
See the version list below for details.
dotnet add package Stratara.Identity.AspNetCore --version 4.1.0
NuGet\Install-Package Stratara.Identity.AspNetCore -Version 4.1.0
<PackageReference Include="Stratara.Identity.AspNetCore" Version="4.1.0" />
<PackageVersion Include="Stratara.Identity.AspNetCore" Version="4.1.0" />
<PackageReference Include="Stratara.Identity.AspNetCore" />
paket add Stratara.Identity.AspNetCore --version 4.1.0
#r "nuget: Stratara.Identity.AspNetCore, 4.1.0"
#:package Stratara.Identity.AspNetCore@4.1.0
#addin nuget:?package=Stratara.Identity.AspNetCore&version=4.1.0
#tool nuget:?package=Stratara.Identity.AspNetCore&version=4.1.0
Stratara.Identity.AspNetCore
Derived. The behaviour described here is specified under
openspec/specs/. Those specifications are the source; this page explains and illustrates them.
License: MIT.
Channel-agnostic ASP.NET Core identity wiring for the Stratara stack. Provides the AddAspNetIdentity / AddAspNetIdentityWithSignInManager extension methods and an IStrataraSignInManager wrapper around the ASP.NET Core SignInManager. Channel-specific glue (Blazor Server's AuthenticationStateProvider, MAUI session-state forwarders, etc.) is the consumer's responsibility — Stratara intentionally stops at the ASP.NET-Core-generic surface to stay application-agnostic.
What's in the box
| Folder | Contents |
|---|---|
DependencyInjection/AspCoreIdentityHostBuilderExtensions |
AddAspNetIdentity<TUser, TIdentityDbContext>() (Stratara password/schema-v3/passkey defaults — no lockout), AddAspNetIdentityWithSignInManager<TUser, TIdentityDbContext>() (same + lockout defaults + AspNetSignInManager + localization), AddDevelopmentNoOpEmailSender<TUser>() (dev-only, throws in Production) |
Lockout only ships with the sign-in manager.
ApplyStrataraLockoutDefaultsruns insideAddAspNetIdentityWithSignInManageronly — the bareAddAspNetIdentityleaves ASP.NET Identity's own lockout defaults in place. If you wire sign-in yourself on top ofAddAspNetIdentity, configureIdentityOptions.Lockoutexplicitly; otherwise password attempts are not throttled the way the rest of this package assumes. |Services/AspNetSignInManager<TUser>| WrapsSignInManager<TUser>+UserManager<TUser>and producesStrataraSignInResultwith already-localized failure messages | |Services/IdentityNoOpEmailSender<TUser>| Development-time email sender that drops every email (Task.CompletedTask); replace in production | |Resources/IdentityResources| Resource-anchor for sign-in failure messages. English default ships inIdentityResources.resx;IdentityResources.de.resxprovides German overrides.AddAspNetIdentityWithSignInManagercallsAddLocalization()soIStringLocalizer<IdentityResources>resolves automatically. | |DependencyInjection/MembershipClaimsServiceCollectionExtensions+Services/MembershipClaims*| Sign-in tenant-claim bridge:AddMembershipTenantClaim<TUser>()(stampstratara:tenant_idat issuance) andAddMembershipTenantClaimsTransformation()(resolve live per request) | |Authorization/*+DependencyInjection/PermissionPolicyServiceCollectionExtensions|AddStrataraPermissionPolicies()— every catalog permission becomes an on-demand[Authorize("...")]policy backed byIPermissionResolver| |Authentication/ApiKey*+DependencyInjection/ApiKeyAuthenticationExtensions|AddStrataraApiKey()(X-Api-Key scheme overIApiKeyStore) andAddStrataraAuthSchemeSelector()(route API-key vs. Bearer vs. cookie by request shape) | |Authentication/Stratara{OpenIdConnect,JwtBearer}Options+DependencyInjection/OpenIdConnectAuthenticationExtensions|AddStrataraOpenIdConnect(configuration)(interactive external login) andAddStrataraJwtBearer(configuration)(API access-token validation, multi-issuer byiss) | |Services/ExternalLoginProvisioningService<TUser>+DependencyInjection/ExternalLoginProvisioningExtensions|AddStrataraExternalLoginProvisioning<TUser>()— hardened JIT create/link of local accounts on first external sign-in (see below) |
Localization
AspNetSignInManager resolves its four user-facing failure messages (Identity.SignIn.Lockout, Identity.SignIn.InvalidCredentials, Identity.SignIn.InvalidTwoFactor, Identity.SignIn.InvalidRecoveryCode) via IStringLocalizer<IdentityResources>. A "not allowed" sign-in deliberately maps onto the InvalidCredentials message rather than getting its own, to avoid confirming that an account exists. Languages out of the box: English (default) and German (de). To add another culture, ship a satellite .resx (e.g. IdentityResources.fr.resx) in your own assembly and register a chained IStringLocalizer<IdentityResources> if needed. Selection follows CultureInfo.CurrentUICulture — wire up app.UseRequestLocalization(...) to map this from the request.
Quick start
// Channel-agnostic ASP.NET Core host (MVC, Razor Pages, Minimal API, ...):
builder.AddAspNetIdentityWithSignInManager<ApplicationUser, IdentityDbContext>();
// Or for a host without sign-in manager (e.g. a worker that only needs identity stores):
builder.AddAspNetIdentity<ApplicationUser, IdentityDbContext>();
For Blazor Server hosts, additionally register your own IStrataraAuthenticationStateProvider implementation (and the AuthenticationStateProvider forwarder). Stratara does not ship a Blazor-specific provider — the previous BlazorAuthenticationStateProvider lived here in 1.x but moved out in v2.0.0 to keep this package application-agnostic.
External login (OpenID Connect) + JIT provisioning
Add external identity providers as ordinary authentication schemes and provision local accounts on first sign-in:
builder.Services
.AddAuthentication(StrataraAuthSchemeSelectorOptions.SchemeName)
.AddCookie(IdentityConstants.ApplicationScheme)
.AddStrataraOpenIdConnect(builder.Configuration) // interactive "log in with <provider>"
.AddStrataraJwtBearer(builder.Configuration) // API access-token validation (iss-routed)
.AddStrataraAuthSchemeSelector(); // route Bearer vs. cookie per request
builder.Services.AddStrataraExternalLoginProvisioning<ApplicationUser>();
AddStrataraOpenIdConnect binds Identity:OpenIdConnect (Authority, ClientId, ClientSecret,
Scopes) and AddStrataraJwtBearer binds Identity:JwtBearer (Authority, Audience, ValidIssuers).
Both key the principal on the issuer sub, never on email — Entra, Keycloak, and generic OIDC differ
only in configuration.
ExternalLoginProvisioningService<TUser> creates or links the local account on a first external
sign-in with the account-takeover defenses on by default: it links on the issuer's (provider, sub);
auto-links to a pre-existing account only when the email is verified by the provider
(email_verified/xms_edov) and already confirmed locally — otherwise it returns
RequiresInteractiveLinking and refuses to merge; honors an optional invitation gate and an
AutoProvision switch; and fails closed. Call it from your sign-in callback (for example the OpenID
Connect OnTicketReceived event). The Stratara.Sample.Identity sample shows the full wiring.
Dependencies
Stratara.Identity.Core— channel-agnostic abstractions (IStrataraSignInManager,IStrataraAuthenticationStateProvider) + shared model records.Stratara.Shared— multitenancy + session-context types.Microsoft.AspNetCore.App— shared framework reference forSignInManager,IEmailSender<TUser>, etc.Microsoft.AspNetCore.Identity.EntityFrameworkCore— ASP.NET Identity stores.Microsoft.AspNetCore.Authentication.OpenIdConnect,Microsoft.AspNetCore.Authentication.JwtBearer— external-login OIDC + API bearer-token schemes.Microsoft.IdentityModel.JsonWebTokens,System.IdentityModel.Tokens.Jwt— JWT helpers for token-based flows.
| Product | Versions 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. |
-
net10.0
- Microsoft.AspNetCore.Authentication.JwtBearer (>= 10.0.11)
- Microsoft.AspNetCore.Authentication.OpenIdConnect (>= 10.0.11)
- Microsoft.AspNetCore.Identity.EntityFrameworkCore (>= 10.0.11)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.22.0)
- Stratara.Identity.Core (>= 4.1.0)
- Stratara.Shared (>= 4.1.0)
- System.IdentityModel.Tokens.Jwt (>= 8.22.0)
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.2.0 | 83 | 9/18/2026 |
| 4.1.1 | 85 | 9/16/2026 |
| 4.1.0 | 85 | 9/16/2026 |
| 4.0.4 | 783 | 9/14/2026 |
| 4.0.3 | 115 | 9/3/2026 |
| 4.0.2 | 593 | 9/3/2026 |
| 4.0.1 | 231 | 9/2/2026 |
| 4.0.0 | 648 | 8/31/2026 |
| 4.0.0-preview.1 | 62 | 8/31/2026 |
| 3.4.0 | 137 | 8/28/2026 |
| 3.3.0 | 332 | 8/25/2026 |
| 3.2.3 | 105 | 8/22/2026 |
| 3.2.2 | 725 | 8/14/2026 |
| 3.2.1 | 708 | 8/2/2026 |
| 3.2.0 | 116 | 7/18/2026 |
| 3.1.7 | 131 | 7/1/2026 |
| 3.1.6 | 536 | 6/22/2026 |
| 3.1.5 | 122 | 6/22/2026 |
| 3.1.4 | 128 | 6/15/2026 |
| 3.1.3 | 126 | 6/10/2026 |
The Orleans execution model ships as two new packages, `Stratara.Orleans` and
`Stratara.Orleans.EntityFrameworkCore`: one writer per aggregate across a cluster, accepted commands that
survive a crash, and projections and sagas that never miss a committed fact. Every host on the Entity
Framework store generates one migration when it upgrades, whether or not it adopts the execution model.
Telemetry type tags now carry the simple type name on every instrument, so a dashboard that filters the
projection, saga or conflict series on the qualified name needs its filter updated. Eight fixes land on
the retry, conflict, redaction and encryption work of 4.0.4, with one new warning to know about.
### Added
- **The Orleans execution model: `Stratara.Orleans` and `Stratara.Orleans.EntityFrameworkCore`.**
Commands, projections, sagas, durable timers and singleton work run as virtual actors on an Orleans
10.3 cluster. One aggregate has one writer across the deployment; a command the execution model's
dispatcher accepts is recorded before the call returns and resumed after a crash, a bounded number of
times, through the same mediator pipeline as on the bus; projections and sagas read the store in
commit order from a checkpoint, so a crash costs latency and never a committed fact; singleton work
runs once per cluster without a lock; a failing entry stops its partition and is retried instead of
being dropped. Handlers, projections and sagas are unchanged, each role is adopted with one
registration after its composite, and both models can run side by side during a rollout. Every
setting is validated at start. See *Choose an Execution Model*, *Migrate to the Orleans Execution
Model* and *Operate the Orleans Execution Model* on the documentation site.
- **Schema additions — every host on the Entity Framework store generates a migration.** The framework's
write context declares `event_stream_entry.partition_position`, the `partition_position` table, on
PostgreSQL `event_stream_entry.commit_transaction_id`, and the `outbox_entry` columns `aggregate_id`,
`heavy`, `attempt_count`, `last_handed_over_at`, `kept_at` and `last_failure`; the read context declares
`projection_checkpoint`. They are part of the model whether or not a host adopts the execution model, so
every host on `Stratara.EventSourcing.EntityFrameworkCore` generates and applies a migration after
upgrading — without it, appends and outbox writes fail on the missing columns. A store that never runs
the execution model carries them unfilled; on PostgreSQL an append also reads back the transaction id.
- **Composites without the bus-fed worker.** `AddEventProjectionServices()` and `AddSagaServices()`
register the projection and saga runtimes without their bus workers; `AddProjectionHandling` and
`AddSagaHandling` do the same on `IServiceCollection`.
- **Every instrument name is a published constant.** `ApplicationDiagnostics.Metrics` carries a
`…Name` constant beside each instrument — `EventsAppendedName`, `ProjectionEventsProcessedName`,
`SagasInFlightName` and the others — so a query or listener references the name instead of a literal.
`ApplicationDiagnostics.MetricTags.TypeNameValue` gives the value a type tag carries for a type name.
- `LogEvents.Messaging.WorkerQueueDeclaredWithOtherArguments` (`108_112`), the warning a RabbitMQ
worker logs when it uses an existing queue declared with other arguments.
### Changed
- **`event.type` and `aggregate.type` carry the simple type name on every instrument.** On
`projection.events.processed`, `saga.events.processed` and `event_source.append.conflicts` the tag
value changes from the assembly-qualified name (`Shop.Orders.OrderPlaced, Shop.Orders`) to the simple
name (`OrderPlaced`), the form `event_source.events.appended` already used, so write and read series
join on the same value. A dashboard or alert that filters those three series on the qualified name
needs its filter updated; no instrument or tag name changes.
- **`AddAuthorizingCommandOutboxDispatcher()` decorates whichever command dispatcher is registered**, not
only the RabbitMQ one, and composes with a dispatcher registered after it.
### Fixed
- **RabbitMQ: changing the retry bounds no longer stops a worker from subscribing.** A worker queue
carries `x-delivery-limit` from the bounds it was first declared with, and RabbitMQ refuses a
redeclaration with a different value — so a deployment that changed `MessageRetry` failed every
subscription with `PRECONDITION_FAILED`. An existing queue is now used as it is, and the bus logs
`108_112` naming it. From RabbitMQ 4.3 the old limit does not cut the new bounds short; before 4.3
a raised bound needs the drained queue deleted once.
- **Azure Service Bus: a subscription whose `MaxDeliveryCount` is below the bounds no longer hides
its dead-lettering.** Where the host can read the subscription, the bounds for it are lowered to
fit under the broker's limit, so the framework makes the move and it reaches `108_110` and
`messaging.dead_lettered`. The warning `108_111` now says so. A failure to read the subscription
of any kind other than cancellation ends the check instead of the subscription.
- **A unique violation is a concurrency conflict whatever exception type carries it.** The event
source consulted the registered `IStoreConflictDetector`s only for an Entity Framework
`DbUpdateException`, so a unit of work that surfaced the provider's exception unwrapped got a
persistence failure instead of a `ConcurrencyException`. Every detector now sees the exception
as the save threw it, as its contract says.
- **Proxy credentials and response cookies are redacted from traces in the form the semantic
conventions name them.** The HTTP client and ASP.NET Core enrichment callbacks replaced
`http.request.header.proxy_authorization` and `http.response.header.set_cookie`, but the
OpenTelemetry semantic conventions keep the dash — `proxy-authorization`, `set-cookie` — so a host
that captured headers under those names exported the values. Both forms are redacted now.
- **The concurrency-conflict policy retries a conflict the event source reports.** An append that
lost the race surfaces from `IEventSource.SaveChangesAsync` as `ConcurrencyException`, and
`ResilienceNames.ConcurrencyConflict` retried only `ConcurrencyConflictException` — so an
`IResilientRequest` whose handler appends events ran once and failed on the first conflict. The
policy now retries both, and still nothing else.
- **A revoked encrypted field of a value type reads as its default instead of failing the object.**
Deserialization wrote an unreadable field back as JSON `null`, which a `decimal`, `int` or other
non-nullable value type cannot hold — so erasing a subject's key made every record with such a
field throw instead of degrading. The field now reads as the type's default, and the object's
other fields are recovered.
- **`InMemoryKeyStore` keeps a scope usable after its current version is revoked.** Revoking the
current key left the scope pointing at a key that no longer existed, so the next
`GetOrCreateCurrentKeyAsync` threw. It now falls back to the highest remaining version, or creates
a new one, as `EnvelopeFileKeyStore` does.
- **`IAggregationService.AggregateAsync` no longer documents `fromVersion` as a start version.** The
parameter has never been honoured: a rebuild starts from the stream's beginning, or from the latest
snapshot at or below `toVersion`. Its documentation now says so; the signature is unchanged.