Finbuckle.MultiTenant is an open-source multitenancy middleware library for .NET. It enables tenant resolution, per-tenant app behavior, and per-tenant data isolation. See https://www.finbuckle.com/multitenant for more details and documentation.

Current publish feed release:

Table of Contents

1. What's New in Finbuckle.MultiTenant 7.0.0
2. Quick Start
3. Documentation
4. Sample Projects
5. Build and Test Status
6. License
7. .NET Foundation
8. Code of Conduct
9. Community
10. Building from Source
11. Running Unit Tests

• Many namespaces have been updated for consistency. Most code will only need to reference the namespace.
• Connection string is removed because in many cases it is not needed. Closes #624
• all unique indexes and the UserLogin primary key in the standard Identity models are adjusted to include the tenant id
• (I)MultiTenantContext and (I)TenantInfo are no longer available via DI. Use IMultiTenantContextAccessor instead. Also IMultiTenantContext nullability reworked and should never be null.
• WithPerTenantOptions replaced by ConfigurePerTenant service collection extensions methods.

Added support for API and more efficient per-tenant options overall.

• 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)

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

See the changelog file for a full history of changes.

Finbuckle.MultiTenant is designed to be easy to use and follows standard .NET conventions as much as possible. This introduction assumes a standard ASP.NET Core use case, but any application using .NET dependency injection can work with the library.

First, install the Finbuckle.MultiTenant.AspNetCore NuGet package:

.NET Core CLI

$ dotnet add package Finbuckle.MultiTenant.AspNetCore

Next, in the app's service configuration call AddMultiTenant<TTenantInfo> and its various builder methods and in the middleware configuration call UseMultiTenant():

builder.Services.AddMultiTenant<TenantInfo>()
    .WithHostStrategy()
    .WithConfigurationStore();

// other app code...

app.UseMultiTenant();

// other app code...

app.Run();

That's all that is needed to get going. Let's breakdown each line:

builder.Services.AddMultiTenant<TenantInfo>()

This line registers the base services and designates TenantInfo as the class that will hold tenant information at runtime.

The type parameter for AddMultiTenant<TTenantInfo> must be an implementation of ITenantInfo which holds basic information about the tenant such as its name and an identifier. TenantInfo is provided as a basic implementation, but a custom implementation can be used if more properties are needed.

See Core Concepts for more information on ITenantInfo.

.WithHostStrategy()

The line tells the app that our "strategy" to determine the request tenant will be to look at the request host, which defaults to the extracting the subdomain as a tenant identifier.

See MultiTenant Strategies for more information.

.WithConfigurationStore()

This line tells the app that information for all tenants are in the appsettings.json file used for app configuration. If a tenant in the store has the identifier found by the strategy, the tenant will be successfully resolved for the current request.

See MultiTenant Stores for more information.

Finbuckle.MultiTenant comes with a collection of strategies and store types that can be mixed and matched in various ways.

app.UseMultiTenant()

This line configures the middleware which resolves the tenant using the registered strategies, stores, and other settings. Be sure to call it before other middleware which will use per-tenant functionality, e.g. UseAuthentication().

With the services and middleware configured, access information for the current tenant from the TenantInfo property on the MultiTenantContext<T> object accessed from the GetMultiTenantContext<T> extension method:

var tenantInfo = HttpContext.GetMultiTenantContext<TenantInfo>().TenantInfo;

if(tenantInfo != null)
{
    var tenantId = tenantInfo.Id;
    var identifier = tenantInfo.Identifier;
    var name = tenantInfo.Name;
}

The type of the TenantInfo property depends on the type passed when calling AddMultiTenant<T> during configuration. If the current tenant could not be determined then TenantInfo will be null.

The ITenantInfo instance and/or the typed instance are also available directly through dependency injection.

See Configuration and Usage for more information.

The library builds on this basic functionality to provide a variety of higher level features. See the documentation for more details:

• Per-tenant Options
• Per-tenant Authentication
• Entity Framework Core Data Isolation
• ASP.NET Core Identity Data Isolation

A variety of sample projects are available in the repository. Check older tagged release commits for samples from prior .NET versions.

This project uses the Apache 2.0 license. See LICENSE file for license information.

This project is supported by the .NET Foundation.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct or the CONTRIBUTING.md file.

Check out the GitHub repository to ask a question, make a request, or peruse the code!

From the command line clone the git repository, cd into the new directory, and compile with dotnet build.

$ git clone https://github.com/Finbuckle/Finbuckle.MultiTenant.git
$ cd Finbuckle.MultiTenant
Cloning into 'Finbuckle.MultiTenant'...
<output omitted>
$ cd Finbuckle.MultiTenant
$ dotnet build

Run the unit tests from the command line with dotnet test from the solution directory.

$ dotnet test