Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/finbuckle/finbuckle.multitenant

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

aspnetcore aspnetcore-identity dotnet dotnetcore efcore entity-framework-core finbuckle middleware multitenant

Last synced: about 1 month ago
JSON representation

Finbuckle.MultiTenant is an open-source multitenancy middleware library for .NET. It enables tenant resolution, per-tenant app behavior, and per-tenant data isolation.

Host: GitHub
URL: https://github.com/finbuckle/finbuckle.multitenant
Owner: Finbuckle
License: apache-2.0
Created: 2017-09-01T13:33:35.000Z (about 7 years ago)
Default Branch: main
Last Pushed: 2024-10-04T17:44:27.000Z (about 1 month ago)
Last Synced: 2024-10-09T14:02:28.736Z (about 1 month ago)
Topics: aspnetcore, aspnetcore-identity, dotnet, dotnetcore, efcore, entity-framework-core, finbuckle, middleware, multitenant
Language: C#
Homepage: https://www.finbuckle.com/multitenant
Size: 2.62 MB
Stars: 1,314
Watchers: 43
Forks: 267
Open Issues: 102
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

README

        # ![Finbuckle Logo](https://www.finbuckle.com/images/finbuckle-32x32-gh.png) Finbuckle.MultiTenant 7.0.2

## About Finbuckle.MultiTenant

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](https://www.finbuckle.com/multitenant) for more details and documentation.

**This release supports .NET 6, .NET 7, and .NET 8.**

Current publish feed release:  

![Finbuckle.MultiTenant NuGet.org badge](https://buildstats.info/nuget/finbuckle.multitenant)

Table of Contents

1. [What's New in v7.0.2](#whats-new)

2. [Quick Start](#quick-start)

3. [Documentation](#documentation)

4. [Sample Projects](#sample-projects)

5. [Build and Test Status](#build-and-test-status)

6. [License](#license)

7. [.NET Foundation](#net-foundation)

8. [Code of Conduct](#code-of-conduct)

9. [Community](#community)

10. [Building from Source](#building-from-source)

11. [Running Unit Tests](#running-unit-tests)

##  What's New in v7.0.2

> This section only lists release update details specific to v7.0.2. See

> the [changelog file](CHANGELOG.md) for all release update details.

### Bug Fixes

* Preserve annotations when adjusting index ([#832](https://github.com/Finbuckle/Finbuckle.MultiTenant/issues/832)) ([e765340](https://github.com/Finbuckle/Finbuckle.MultiTenant/commit/e765340a3c74268cadf191a55e9a5c082894c2bd))

* strategy wrapper no longer throws on a null context, instead passing it to the actual strategy ([#863](https://github.com/Finbuckle/Finbuckle.MultiTenant/issues/863)) ([2b165c7](https://github.com/Finbuckle/Finbuckle.MultiTenant/commit/2b165c77db4f82244e33fe1823e865f30b2a3ea2))

## Quick Start

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.

### Installation

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

.NET Core CLI

```bash

$ dotnet add package Finbuckle.MultiTenant.AspNetCore

```

### Basic Configuration

Next, in the app's service configuration call `AddMultiTenant` and its various builder methods and in the

middleware configuration call `UseMultiTenant()`:

```cs

builder.Services.AddMultiTenant()

    .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()`

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

runtime.

The type parameter for `AddMultiTenant` 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](https://www.finbuckle.com/MultiTenant/Docs/CoreConcepts) 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](https://www.finbuckle.com/MultiTenant/Docs/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](https://www.finbuckle.com/MultiTenant/Docs/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()`.

### Basic Usage

With the services and middleware configured, access information for the current tenant from the `TenantInfo` property on

the `MultiTenantContext` object accessed from the `GetMultiTenantContext` extension method:

```cs

var tenantInfo = HttpContext.GetMultiTenantContext().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` 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](https://www.finbuckle.com/MultiTenant/Docs/ConfigurationAndUsage) for more information.

## Documentation

The library builds on this basic functionality to provide a variety of higher level features. See

the [documentation](https://www.finbuckle.com/multitenant/docs) for

more details:

* [Per-tenant Options](https://www.finbuckle.com/MultiTenant/Docs/Options)

* [Per-tenant Authentication](https://www.finbuckle.com/MultiTenant/Docs/Authentication)

* [Entity Framework Core Data Isolation](https://www.finbuckle.com/MultiTenant/Docs/EFCore)

* [ASP.NET Core Identity Data Isolation](https://www.finbuckle.com/MultiTenant/Docs/Identity)

## Sample Projects

A variety of [sample projects](https://github.com/Finbuckle/Finbuckle.MultiTenant/tree/main/samples) are available in

the repository. Check older tagged release commits for samples from prior .NET versions.

## Build and Test Status

![Build and Test Status](https://github.com/Finbuckle/Finbuckle.MultiTenant/actions/workflows/ci.yml/badge.svg)

## License

This project uses the [Apache 2.0 license](https://www.apache.org/licenses/LICENSE-2.0). See [LICENSE](LICENSE) file for

license information.

## .NET Foundation

This project is supported by the [.NET Foundation](https://dotnetfoundation.org).

## Code of Conduct

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](https://dotnetfoundation.org/code-of-conduct)

or the [CONTRIBUTING.md](CONTRIBUTING.md) file.

## Community

Check out the [GitHub repository](https://github.com/Finbuckle/Finbuckle.MultiTenant) to ask a question, make a request,

or peruse the code!

## Building from Source

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

```bash

$ git clone https://github.com/Finbuckle/Finbuckle.MultiTenant.git

$ cd Finbuckle.MultiTenant

Cloning into 'Finbuckle.MultiTenant'...

$ cd Finbuckle.MultiTenant

$ dotnet build

```

## Running Unit Tests

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

```bash

$ dotnet test

```