Autofac.AspNetCore.Multitenant
8.0.0
Prefix Reserved
dotnet add package Autofac.AspNetCore.Multitenant --version 8.0.0
NuGet\Install-Package Autofac.AspNetCore.Multitenant -Version 8.0.0
<PackageReference Include="Autofac.AspNetCore.Multitenant" Version="8.0.0" />
paket add Autofac.AspNetCore.Multitenant --version 8.0.0
#r "nuget: Autofac.AspNetCore.Multitenant, 8.0.0"
// Install Autofac.AspNetCore.Multitenant as a Cake Addin #addin nuget:?package=Autofac.AspNetCore.Multitenant&version=8.0.0 // Install Autofac.AspNetCore.Multitenant as a Cake Tool #tool nuget:?package=Autofac.AspNetCore.Multitenant&version=8.0.0
Autofac.AspNetCore.Multitenant
ASP.NET Core support for multitenant DI via Autofac.Multitenant.
Please file issues and pull requests for this package in this repository rather than in the Autofac core repo.
Why Use This?
ASP.NET Core default RequestServicesContainerMiddleware
is where the per-request lifetime scope usually gets generated. However, its constructor is where it wants the IServiceScopeFactory
that will be used later during the request to create the request lifetime scope.
Unfortunately, that means the IServiceScopeFactory
is created/resolved at the point when the request comes in, long before an HttpContext
is set in any IHttpContextAccessor
. The result is the scope factory ends up coming from the default tenant scope, before a tenant can be identified, and per-request services will later all come from the default tenant. Multitenancy fails.
This package provides a different request services middleware that ensures the IHttpContextAccessor.HttpContext
is set and defers creation of the request lifetime scope until as late as possible so anything needed for tenant identification can be established.
Quick Start
When creating your application host, use the multitenant service provider factory. Your Startup
will register common dependencies, but you'll need to provide a static method to initialize the tenant-specific overrides.
var host = Host.CreateDefaultBuilder(args)
.UseServiceProviderFactory(new AutofacMultitenantServiceProviderFactory(MultitenantContainerSetup.ConfigureMultitenantContainer))
.ConfigureWebHostDefaults(webHostBuilder => webHostBuilder.UseStartup<Startup>())
.Build();
In your Startup
class, make sure to use the multitenant request services middleware and register your common dependencies.
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
// Add the multitenant request services handler.
services
.AddAutofacMultitenantRequestServices()
.AddControllers();
}
public void ConfigureContainer(ContainerBuilder builder)
{
// Register tenant-shared dependencies and defaults.
builder.RegisterType<CommonDependency>()
.As<IDependency>()
.InstancePerLifetimeScope();
}
public void Configure(IApplicationBuilder app)
{
app.UseRouting();
app.UseEndpoints(builder => builder.MapControllers());
}
}
Provide a method to override things for tenant-specific dependencies. This is what gets passed to the multitenant service provider factory.
public static class MultitenantContainerSetup
{
public static MultitenantContainer ConfigureMultitenantContainer(IContainer container)
{
// Define how you're going to identify tenants.
var strategy = new QueryStringTenantIdentificationStrategy(
container.Resolve<IHttpContextAccessor>(),
container.Resolve<ILogger<QueryStringTenantIdentificationStrategy>>());
// Create the multitenant container.
var multitenantContainer = new MultitenantContainer(strategy, container);
// Register tenant overrides.
multitenantContainer.ConfigureTenant(
"some-tenant",
cb => cb
.RegisterType<OverrideDependency>()
.As<IDependency>()
.WithProperty("Id", "some-tenant")
.InstancePerLifetimeScope());
// Return the built container for use in the app.
return multitenantContainer;
}
}
Reference
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- Autofac.Extensions.DependencyInjection (>= 9.0.0)
- Autofac.Multitenant (>= 8.0.2)
-
net7.0
- Autofac.Extensions.DependencyInjection (>= 9.0.0)
- Autofac.Multitenant (>= 8.0.2)
-
net8.0
- Autofac.Extensions.DependencyInjection (>= 9.0.0)
- Autofac.Multitenant (>= 8.0.2)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Autofac.AspNetCore.Multitenant:
Package | Downloads |
---|---|
Autofac.AspNetCore.Extensions
ASP.NET Core library with IWebHostBuilder Single Tenant and Multitenant Autofac Extensions |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
8.0.0 | 121,742 | 3/12/2024 |
7.0.0 | 186,295 | 5/5/2023 |
6.0.0 | 285,463 | 7/18/2022 |
5.1.0 | 245,939 | 11/15/2021 |
5.0.0 | 1,295,252 | 12/20/2020 |
4.0.1 | 26,455 | 10/6/2020 |
4.0.0 | 1,530 | 9/30/2020 |
3.0.2 | 101,499 | 8/5/2020 |
3.0.1 | 499,549 | 4/7/2020 |
3.0.0 | 63,697 | 1/28/2020 |
2.0.1 | 130,484 | 11/12/2019 |
2.0.0 | 20,541 | 9/24/2019 |
2.0.0-rc1 | 500 | 9/5/2019 |
1.1.0 | 66,510 | 4/16/2019 |
1.0.2 | 69,571 | 7/12/2018 |
1.0.1 | 4,652 | 6/1/2018 |
1.0.1-rc1 | 1,116 | 5/7/2018 |
1.0.0 | 11,944 | 8/18/2017 |
Release notes are at https://github.com/autofac/Autofac.AspNetCore.Multitenant/releases