Finbuckle.MultiTenant Docs

Version History

10.0.7 (2026-04-29)

Bug Fixes

  • update to 10.0.7 for version alignment with .NET (#1120) (3a470ed)

10.0.6 (2026-04-21)

Bug Fixes

  • Bump the microsoft-packages group with 15 updates (#1115) (02a2415)

10.0.5 (2026-04-15)

Bug Fixes

  • Bump the microsoft-packages group with 15 updates (#1112) (603ffc0)

10.0.4 (2026-03-12)

Bug Fixes

  • Bump Microsoft.AspNetCore.Authentication.OpenIdConnect and 15 others (#1104) (bcaf705)

10.0.3 (2026-02-11)

Bug Fixes

  • add logging level checks to improve perf (#1095) (78c1cad)
  • Bump the microsoft-packages group with 15 updates (#1098) (1b96122)

10.0.2 (2026-01-14)

Bug Fixes

  • correct store skip take order bug (#1076) (42a6139)
  • re-add ITenantInfo interface (#1075) (4b4db14)
  • remove the shadow TenantId property when calling IsNotMultiTenant() (#1079) (d258b62)
  • update dependencies for .NET 10.0.2 (#1084) (def5e59)

10.0.1 (2025-12-10)

Bug Fixes

10.0.0 (2025-11-20)

⚠ BREAKING CHANGES

  • In prior versions user provided generic types to the MultiTenantIdentityDbContext family of classes were not mult-tenant by default. This was confusing and to simplify all are now multi-tenant by default.
  • The RouteStrategy will include the tenant in the ambient route values used for link generation, similar to Controller and Action. Can be disabled via the WithRouteStrategy overload taking a boolean for useTenantAmbientRouteValue set to false.
  • General improvements in folder structure to reduce overnesting has caused namespace changes for certain types. Namely some stores and options types.
  • BasePathStrategy default behavior is changed to rebase the aspnetcore path base. This was opt in before. Can be set via BasePathStrategyOptions.
  • This was opt in before. Can be set via BasePathStrategyOptions.
  • Namespaces were standardized to match folder locations.
  • Making TenantInfo a record reduces risk of unintended changes to the current tenant. This change also removes ITenantInfo and TenantInfo should be used as the base for custom implementations. Note that EFCoreStore uses this record as an entity but takes care not to rely on tracking.
  • prior extension namespaces were inconsistent, now they are all {PackageName}.Extensions, e.g. Finbuckle.MultiTenant.Options.Extensions
  • Per-tenant options support was previously part of the Finbuckle.MultiTenant package. Projects will need to reference the Finbuckle.MultiTenant.Options package going forward.
  • Minor changes to the IMultiTenantStore interface signatures.
  • Removes the 64 character limit on Tenant ID. This also removes the max length constraint where Tenant ID is used in EF Core if applicable.
  • IMultiTenantContext and its implementations are now immutable. Changes will require assigning a new instance.
  • Prior to this change anonymous filters were used and required special consideration in advanced scenarios. The change to named filters removes these considerations, but named filters cannot be mixed with anonymous filters.
  • net8 and net9 targets were removed
  • This change better isolates dependencies. Basic interfaces and types are now in the Finbuckle.MultiTenant.Abstractions package and MultiTenantIdentityDbContext functionality is now in the Finbuckle.MultiTenant.Identity.EntityFrameworkCore package.

Features

  • add IsNotMultiTenant method to exclude entities from multi-tenancy in EF Core per-tenant data functionality. (b160826)
  • add Identity passkey multi-tenant support (7f0bf73)
  • add MultiTenantAmbientValueLinkGenerator to promote tenant route values (#1041) (259511c)
  • all projects target net10 (#1007) (1f02e8f)
  • BasePathStrategy will rebase the aspnetcore path base by default (bd7f0d0)
  • BasePathStrategy will rebase the aspnetcore path base by default (d107d81)
  • expose many internal types as public and adjust namespaces (#1030) (f680843)
  • Identity entity types are all multi-tenant by default on MultiTenantIdentityDbContext variants. (4e1bd9f)
  • immutable IMultiTenantContext (#1018) (03ddeb0)
  • improve folder structure (#1040) (d46ce8c)
  • improved depedency structure with Finbuckle.MultiTenant.Abstractions and Finbuckle.MultiTenant.Identity.EntityFrameworkCore (#1006) (e191d83)
  • improved store interface (#1020) (c6a16c4)
  • improved xml comments (#1038) (fdd59b9)
  • improved xml comments (#1038) (8ee6597)
  • namespaces for extension methods changed (#1026) (318fcec)
  • refactors per-tenant options into Finbuckle.MultiTenant.Options package (#1024) (ca4877f)
  • removed max char length on TenantInfo (#1019) (37bb15b)
  • TenantInfo is now a record and ITenantInfo is removed (#1029) (21559da)
  • use named global query filters in EF Core (#1016) (c3ac833)

Bug Fixes

Performance Improvements

Reverts

  • Revert "feat: BasePathStrategy will rebase the aspnetcore path base by default" (0a154e1)
  • Revert "feat: improved xml comments (#1038)" (#1039) (b036339)
  • Revert "feat: refactors per-tenant options into Finbuckle.MultiTenant.Options package (#1024)" (0db79eb)

9.4.2 (2025-11-01)

Bug Fixes

9.4.1 (2025-10-16)

Bug Fixes

9.4.0 (2025-09-14)

Features

9.3.1 (2025-09-10)

Bug Fixes

9.3.0 (2025-08-09)

Features

  • Add a RedirectTo Uri to ShortCircuitWhenOptions, enabling the middleware to redirect the user when short circuiting. (64ad8e2)
  • Add ExcludeFromMultiTenantResolution() and ExcludeFromMultiTenantResolutionAttribute for endpoints. (5cd9d3c)
  • Add ShortCircuitWhen(Action options) and ShortCircuitWhenTenantNotResolved() (709b0de)

Bug Fixes

  • support decorated multiple registered services of same type and fix activator bugs for instance and factory based services (#994) (0d1b68c)
  • update dependencies (#995) (0e0440a)

9.2.2 (2025-07-10)

Bug Fixes

9.2.1 (2025-06-18)

Bug Fixes

9.2.0 (2025-06-03)

Features

  • add Context property to StoreResolveCompletedContext (#976) (464a55c)
  • add pagination support overload to IMultiTenantStore.GetAllAsync method (#978) (b8e50a6)
  • add more multi-tenant dbcontext factories (#980) (de67550)

Bug Fixes

  • remove TenantId from the UserLogin primary key (#979) (a09fb7b)

9.1.4 (2025-05-14)

Bug Fixes

9.1.3 (2025-04-09)

Bug Fixes

9.1.2 (2025-03-20)

Bug Fixes

9.1.1 (2025-03-18)

Bug Fixes

  • fix cache store leaving orphan tenant on some update scenarios (#946) (5edd9fe)
  • update dependency versions (#953) (67598c1)

9.1.0 (2025-03-12)

Features

Bug Fixes

  • added new analyzers and multiple fixes (#937) (9d9b1e4)
  • MultiTenantDbContext.Create should have non nullable TenantInfo (#916) (9df0527)

9.0.0 (2024-11-13)

⚠ BREAKING CHANGES

  • OnTenantResolved and OnTenantNotResolved are no longer used. Use the OnStrategyResolveCompleted, OnStoreResolveCompleted, and OnTenantResolveCompleted events instead.
  • MultiTenantDbContext constructors accepting ITenantInfo removed, use MultiTenantDbContext.Create factory method instead.
  • net6.0 and net7.0 are no longer supported targets.
  • dotnet runtime specific dependencies now float to the latest patch version and are locked at release time with a NuGet lock file. This is a security mitigation and may break some builds not on the latest SDKs.

Features

8.1.0 (2025-03-18)

Bug Fixes

  • fix cache store leaving orphan tenant on some update scenarios (#949) (7929f00)

Features

8.0.0 (2024-10-12)

⚠ BREAKING CHANGES

  • This commit brings the release into alignment with the new version policy. See #887 for details.
  • Included strategies for ASP.NET Core would throw an exception if the passed context was not an HttpContext type. Now they will return null indicating no identifier was found.

Features

  • add GetAllAsync() support for HttpRemoteStore (#848) (4208149)
  • added the Echo Store. (#807) (a3e5eee)
  • strategies return null on invalid context type (#885) (9834575)

Bug Fixes

  • BasePathStrategy no longer breaks the strategy chain (#884) (3263eff)
  • prevent duplicate key annotation in AdjustKey() (#883) (f75ba2c)
  • removed unused parameter from WithPerTenantRemoteAuthenticationConvention (#886) (dd17ab5)

7.0.2 (2024-08-03)

Bug Fixes

  • Preserve annotations when adjusting index (#832) (e765340)
  • strategy wrapper no longer throws on a null context, instead passing it to the actual strategy (#863) (2b165c7)

7.0.1 (2024-04-28)

Bug Fixes

  • only throw exception in EnforceMultiTenant for null tenant if there are entity changes. (#819) (ca9e9fd)

7.0.0 (2024-04-21)

⚠ BREAKING CHANGES

  • (I)MultiTenantContext and (I)TenantInfo are no longer available via dependency injection. Use IMultiTenantContextAccessor instead. MultiTenantDbContext and MultiTenantIdentityDbContext will require a new constructor that injects IMultiTenantContextAccessor or IMultiTenantContext.
  • Many namespaces have been updated for consistency. Most code will only need to use the Finbuckle.MultiTenant or Finbuckle.MultiTenant.Abstractions namespace.
  • Connection string is removed from ITenantInfo and the default TenantInfo implementation.
  • Added support for OptionsBuilder API and more efficient per-tenant options overall.
  • WithPerTenantOptions replaced by ConfigurePerTenant service collection extensions methods.
  • Unique indexes and the UserLogin primary key in the standard Identity models adjusted to include tenant id.
  • IMultiTenantContext nullability reworked and should never be null.

Features

  • better options support (#681) (1859017)
  • change default MultiTenantIdentityDbContext default index and key behavior (81f5612)
  • MultiTenantDbContext and MultiTenantIdentityDbContext support for IMultiTenantContextAccessor DI (9015085)
  • namespace cleaned up (b354838)
  • refactor DI and improve nullability (eca24bf)
  • remove ConnectionString from ITenantInfo and TenantInfo (f4e20db)

Bug Fixes

  • AdjustKey correctly adding TenantId to primary and foreign keys (613b4a8)

6.13.1 (2024-01-24)

Bug Fixes

  • update dependency to protect against CVE-2024-21319 (#781) (c5e0c8a)

6.13.0 (2023-12-21)

Features

Bug Fixes

6.12.0 (2023-08-25)

Features

6.11.1 (2023-07-06)

Bug Fixes

6.11.0 (2023-07-01)

Features

  • add HasResolvedTenant to IMultiTenantContext (#650) (375add5)
  • perf improvements in BasePathStrategy and RemoteAuthenticationCallbackStrategy (#654) (ac1c58a)

Bug Fixes

  • internal refactoring and improved XML comments for intellisense (c42c53d)
  • xml docs corrections (#639) (265d26d)

6.10.0 (2023-01-30)

Features

  • add nongeneric IMultiTenantContext for flexibility (b3a198f)

Bug Fixes

  • fixes undesired context tracking across EFCoreStore methods (#633) (3605a75)
  • remove netcore3.1 (#632) (6c21fe9)

6.9.1 (2022-11-10)

Bug Fixes

6.9.0 (2022-10-23)

Features

Bug Fixes

  • BasePathStrategy combine path bug (0628b0f)

6.8.1 (2022-09-17)

Bug Fixes

6.8.0 (2022-08-28)

Features

  • opened efcorestore to allow overriding methods (#577) (7dac251), closes #574

Bug Fixes

  • add missing using statement to samples (#581) (ec8e08e)
  • adjust logic in per-tenant-authentication conventions (e78a26f)
  • environment configuration in samples (#579) (6df8827)
  • update authentication.md (#573) (df55b24)

6.7.3 (2022-07-17)

Bug Fixes

Performance Improvements

6.7.2 (2022-04-05)

Bug Fixes

  • update scheme provider to support decorator pattern (#551) (ead052a)

6.7.1 (2022-03-10)

Bug Fixes

  • use web System.Text.Json setttings and update samples (#544) (266e806)

6.7.0 (2022-03-06)

Features

6.6.1 (2022-02-19)

Bug Fixes

  • change delegate strategy func return type as nullabe and adds unit test (#525) (80c7104)
  • remove tenant id value generator (#524) (0d3dcd8)

6.6.0 (2022-02-13)

Features

  • add BasePathStrategy option to rebase the AspNetCore Request.PathBase (#510) (dccf414)
  • add nullable reference types to all projects (#514) (e6141fe)
  • add strategy type and store type to TenantResolvedContext (#508) (ef52fc2)

Bug Fixes

  • actually set the strategy and store types on OnTenantResolvedContext (#509) (fd9029e)
  • remove dependency on NewtonSoft.Json (#505) (f83f0b1)

6.5.1 (2021-11-17)

Bug Fixes

  • ClaimStrategy validation bypass type principle changed to principal (#493) (fbfd022)

6.5.0 (2021-11-08)

Features

6.4.2 (2021-10-25)

Bug Fixes

  • change Options types from internal to public (#483) (af9521d)

6.4.1 (2021-10-11)

Bug Fixes

6.4.0 (2021-10-07)

Bug Fixes

  • ClaimStrategy bypass cookie principal validation (#475) (cd38a7f)

Features

  • add optional parameter to specify the ClaimStrategy authentication scheme. (#398) thanks ! (d74ae41)

6.3.1 (2021-09-30)

Bug Fixes

  • revert some platform targets to netstandard (#469) (aceff1d)

6.3.0 (2021-09-06)

Changes

  • Removed support for .NET Core 2.1 which ended Microsoft support in August 2020.
  • Retargeted specifically to .netcoreapp3.1 and .net5.0 across all packages.
  • Added AdjustKey, AdjustIndex, AdjustAlIndexes, AdjustUniqueIndexes methods to be chained off IsMultiTenant in EFCore functionality. They add the implicit TenantId to the respective key/indexes.
  • Reverted generic version of IsMultiTenant back to non-generic version for more flexibility.
  • Improved tenant resolution logging functionality and performance. Thanks to ****!
  • Fixed a bug with InMemoryStore implementation of TryUpdate. Thanks to ****!
  • Fixed a bug where ConfigurationStore would throw an exception if there was no default section in the config.
  • Fixed a bug where ASP.NET Core Identity security stamp validation would force user logout and raise exceptions. Thanks to **** for finding the root cause of this bug.
  • Fixed a bug where MultiTenantOptionsManager<TOptions> was internal instead of public.
  • Fixed problematic references in sample projects.
  • Updated and improved documentation.
  • Updated and improved tests.
  • Added various project files for .NET Foundation on-boarding.

6.2.0 (2021-02-16)

Changes

  • Added a new events system. See PR #359 Thanks to ****!
  • Some internal refactoring.
  • Various documentation fixes.
  • Added sourcelink to allow debugging into remote source code.
  • Added a security policy.

6.1.0 (2020-11-10)

Changes

  • .NET 5.0 support.
  • New DistributedCacheStore uses the ASP.NET Core distributed cache for tenant resolution.
  • New HeaderStrategy uses HTTP headers for tenant resolution. Thanks to ****!
  • Support for inheritance in multitenant Entity Framework Core entity. Thanks to ****!
  • Fixed a conflict between ClaimStrategy and per-tenant authentication.
  • Updated docs, samples, and unit tests.

6.0.0 (2020-09-08)

Changes

  • Customizable TenantInfo. Implement ITenantInfo as needed or use the basic TenantInfo implementation. Should work with most strategies and stores. This was a major overhaul to the library. See docs for more information.
  • Changed NuGet structure: use Finbuckle.MultiTenant.AspNetCore for web apps and if needed add Finbuckle.MultiTenant.EntityFrameworkCore.
  • WithPerTenantAuthentication - Adds support for common per-tenant authentication scenarios. See docs for full details.
  • Multiple strategies and stores can be registered. They will run in the order registered and the first tenant returned by a strategy/store combination is used.
  • New ClaimStrategy checks for a tenant claim to resolve the tenant.
  • New SessionStrategy uses a session variable to resolve the tenant.
  • Refactored InMemoryStore, removed deprecated configuration functionality.
  • Improved Blazor support.
  • Improved support for non ASP.NET Core use cases.
  • Removed support for ASP.NET 3.0.
  • Removed FallbackStrategy, StaticStrategy is a better alternative.
  • Bug fixes, refactors, and tweaks.
  • Improved unit tests.
  • Updated and improved documentation.
  • Updated sample. Removed some older ASP.NET Core 2.1 samples.

5.0.4 (2020-02-12)

Changes

  • Fixed a conflicting assembly and NuGet versions.
  • Minor documentation fix.

5.0.3 (2020-01-21)

Changes

  • Fixed a bug where documented static methods were internal rather than public.
  • Minor documentation fix.

5.0.1 (2020-01-15)

Changes

  • Updated for .NET Core January 2020 Updates adding support for .NET Core 2.1.15, 3.0.2, and 3.1.1.
  • Updated dependencies as recommended in security notices for .NET Core January 2020 Updates.
  • Finbuckle.MultiTenant.AspNetCore targets netcoreapp3.1, netcoreapp3.0, and netcoreapp2.1.
  • Finbuckle.MultiTenant.Core targets netstandard2.1 and netstandard2.0.
  • Finbuckle.MultiTenant.EntityFrameworkCore targets netstandard2.1 and netstandard2.0.

5.0.0 (2020-01-12)

Changes

  • Added support for ASP.NET Core 3.1.
  • Major refactor of how Entity Framework multitenant data isolation works. No longer need to derive from MultiTenantDbContext greatly improving flexibility. IdentityMultiTenantDbContext reworked under this new model and no longer requires or recommends use of multitenant support classes, e.g. MultiTenantIdentityUser. Attempted to minimize impact, but if using IdentityMultiTenantDbContext this may be a breaking change! Thanks ****!
  • Simplified EFCoreStore to use TenantInfo directly. This is a breaking change!
  • Fixed a bug with user id not being set correctly in legacy IdentityMultiTenantDbContext.
  • Added ConfigurationStore to load tenant information from app configuration. The store is read-only in code, but changes in configuration (e.g. appsettings.json) are picked up at runtime. Updated most sample projects to use this store.
  • Deprecated InMemoryStore functionality that reads from configuration.
  • Added HttpRemoteStore which will make an http request to get a TenantInfo object. It can be extended with DelegatingHandlers (i.e. to add authentication headers). Added sample projects for this store. Thanks to ****!
  • Fixed an exception with OpenIdConnect remote authentication if "state" is not returned from the identity provider. The new behavior will result in no tenant found for the request.
  • Updated samples.
  • Updated documentation.
  • Updated unit tests to check against all valid project targets.
  • Symbols package included for debugging.

4.0.0 (2019-09-24)

Changes

  • Added support for ASP.NET Core 3! Valid project targets are netcoreapp3.0, netcoreapp2.0, and netcoreapp2.1.
  • Added a sample app for ASP.NET 3 highlighting the route strategy improvements due to the endpoint routing mechanism.
  • Fixed a bug where route strategy could throw an exception when used with Razor Pages. Thanks -services!
  • Support for configuring multiple multitenant strategies. Each will be tried in the order configured until a non-null tenant identifier is returned. The exception is the fallback strategy which always goes last.
  • Refactored component assemblies for better dependency control. EFCore can be excluded by referencing Finbuckle.MultiTenant.AspNetCore instead of Finbuckle.MultiTenant.
  • Updated documentation.
  • Updated unit tests to check against all valid project targets.
  • Symbols package included for debugging.

3.2.0 (2019-09-08)

Changes

  • Added support for any preexisting global query filters in MultiTenantDbContext and MultiTenantIdentityDbContext. Thanks !
  • Exposed the inner stores and strategies as a property on the respective StoreInfo and StrategyInfo properties of MultiTenantContext. Previously you could only access the wrapper object for each. Thanks !
  • Fixed certain methods on MultiTenantOptionsCache to be external as originally intended. Thanks !
  • Fix a bug with TryUpdateAsync in the wrapper store. Thanks !
  • Updated documentation and fixed typos. Thanks !

3.1.0 (2019-06-09)

Changes

  • Added a strategy wrapper that handles validation and logging for the active strategy. When implementing IMultiTenantStrategy basic validation and logging are automatically provided.
  • Added the delegate strategy that accepts a lambda to return the tenant identifier. Configure by calling WithDelegateStrategy(...).
  • Added the fallback strategy that provides a tenant identifier if the normal strategy (or remote authentication, if applicable) fails to resolve a tenant. Configure by calling WithFallbackStrategy(...).
  • Added TrySetTenantInfo as an extension method to HttpContext. This will set the TenantInfo provided as the current tenant for the request and can optionally reset the service providers so that scoped services are regenerated under the new tenant.
  • Updated and improved documentation and sample projects.
  • Miscellaneous bug fixes, code improvement, and unit tests.
  • Thanks to for contributing to this release.

3.0.1 (2019-05-05)

Changes

  • Refactored the global query filter used in MultiTenantDbContext and MultiTenantIdentityDbContext (Thanks !) for better performance and code quality.
  • Removed custom IModelCacheKeyFactory as it is no longer needed due to the global query filter changes.
  • Updated documentation and samples.

3.0.0 (2019-04-01)

Changes

  • Allow resetting option cache per-tenant. This is a breaking change.
  • Host strategy can match entire domain as a special case (prior it only matched a single host segment).
  • Added a sample project demonstrating a common login page shared by all tenants.
  • Overhauled documentation.
  • Updated unit and integration tests.
  • Switch to Apache 2.0 license.

2.0.2 (2019-02-05)

Changes

  • Fixed bug in Identity where UserLogins primary key was not adjusted for multitenant usage.
  • Updated and Fixed the IdentityDataIsolation sample project.
  • General code and test cleanup.

2.0.1 (2019-01-07)

Changes

  • Fixed bug where the TenantInfo constructor did not save the passed Items collection.
  • Tested for compatibility with ASP.NET Core 2.2.
  • Updated samples for ASP.NET Core 2.2.
  • Cleaned up library dependencies to target ASP.NET Core 2.1 or greater.

2.0.0 (2018-12-03)

Changes

  • Changed TenantContext to MultiTenantContext which includes TenantInfo, StrategyInfo, and StoreInfo properties.
  • Namespace changes (e.g. use of Microsoft.Extensions.DependencyInjection namespace for Configure and ConfigureServices methods).
  • Additional and improved unit tests.
  • Updated sample project dependencies.
  • Various other internal improvements to code and bug fixes.
  • TryUpdate method added to IMultiTenantStore interface.
  • Added EFCoreStore which allows an Entity Framework Core database context as the tenant store.
  • Added sample project demonstrating use of EFCoreStore.
  • Custom can be configured with custom dependency injection lifetime (single, scoped, or transient) via WithStore method overloads.
  • Custom stores automatically receive logging and error support via internal use of MultiTenantStoreWrapper.
  • Use of async/await for strategy execution for improved performance.
  • Custom strategies can be configured with custom dependency injection lifetime (single, scoped, or transient) via WithStrategy method overloads.
  • Moved route configuration for RouteStrategy from UseMultiTenant to WithRouteStrategy.

1.2.0 (2018-07-22)

Changes

  • Added variants of MultiTenantIdentityDbContext which allows more flexible integration with Identity (Thanks !)
  • Added sample project for data isolation with Identity
  • Minor refactoring and more unit tests
  • Various bug fixes

1.1.1 (2018-05-22)

Changes

  • Fixed bug affecting per-tenant data isolation using a shared database
  • Added sample project for data isolation
  • Added new constructors for MultiTenantDbContext and MultiTenantIdentityDbContext

1.1.0 (2018-04-22)

Changes

  • Remote authentication support
  • Strategy improvements
  • Store improvements
  • Per-tenant options improvements
  • Logging support
  • Updated samples
  • Improved unit and integration tests
  • Switch to Apache 2.0 license

1.0.0 (2018-01-01)

Changes

  • Initial release