Implementando uma Solução MultiTenancy com o NHibernate.

MultiTenancy, ou multitenant, é um conceito fundamental em arquiteturas de software modernas, permitindo que uma única instância de software atenda a vários clientes (tenants) de forma personalizada e segura. Implementar uma solução MultiTenancy com NHibernate pode ser desafiador. Já encontrei diversas implementações, incluindo o uso de múltiplas SessionFactories armazenadas em um ConcurrentDictionary. Essa abordagem pode ser particularmente complicada se o uso de memória for uma restrição para o seu projeto. No entanto, com a abordagem correta, é possível desenvolver uma solução robusta e escalável.

Neste artigo detalharemos as etapas e considerações para implementar MultiTenancy usando NHibernate, usando o conceito de “Base de Dados Separada” para maximizar o isolamento e a segurança dos dados.

1. O Que é MultiTenancy?

MultiTenancy refere-se a uma arquitetura de software onde uma única aplicação é utilizada por múltiplos clientes, conhecidos como tenants. Cada tenant pode ter suas próprias configurações, dados e personalizações na aplicação. Existem três principais abordagens de MultiTenancy:

• Base de Dados Compartilhada, Esquema Compartilhado: Todos os tenants compartilham o mesmo banco de dados e o mesmo esquema, diferenciados apenas por dados de identificação.
• Base de Dados Compartilhada, Esquema Separado: Todos os tenants compartilham o mesmo banco de dados, mas cada tenant possui seu próprio esquema.
• Base de Dados Separada: Cada tenant possui seu próprio banco de dados independente.

2. Escolhendo a Abordagem

A escolha da abordagem depende das necessidades específicas da aplicação, como escalabilidade, manutenção, segurança e isolamento de dados. Neste artigo, focaremos na abordagem de “Base de Dados Separada”, que oferece um ótimo isolamento, pois cada tenant possui um banco de dados independente, garantindo a máxima segurança e privacidade dos dados.

3. Configurando o NHibernate para MultiTenancy

NHibernate suporta configuração específica para MultiTenancy. Durante a definição das configurações do DatabaseIntegration, você especifica o tipo de MultiTenancy (Database ou Schema) desejado e o provider que deve ser usado para realizar o MultiTenancy.

Exemplo de Configuração

Para suportar MultiTenancy usando bancos de dados separados, no NHibernate, é necessário informar uma string de conexão válida e acessível, pois o NHibernate precisa acessar o banco de dados para gerar o SessionFactory, além de configurar o Provider para MultiTenancy:

Configuration cfg = new Configuration() .DataBaseIntegration(db => { db.MultiTenancy = MultiTenancyStrategy.Database; db.MultiTenancyConnectionProvider<MultiTenancyConnectionProvider>(); db.Dialect<PostgreSQL83Dialect>(); db.ConnectionString = "User ID=postgres;Password=<password>;Host=localhost;Port=5432;Database=postgres;Pooling=true;"; db.Driver<NpgsqlDriver>(); db.LogSqlInConsole = true; });

Implementando o MultiTenancyConnectionProvider

O próximo passo é implementar o MultiTenancyConnectionProvider, que permitirá configurar a string de conexão específica para cada tenant.

public class MultiTenancyConnectionProvider : AbstractMultiTenancyConnectionProvider
{ public MultiTenancyConnectionProvider() { } protected override string GetTenantConnectionString(TenantConfiguration tenantConfiguration, ISessionFactoryImplementor sessionFactory) { var tenant = (AppSettingsTenantConfiguration)tenantConfiguration; return tenant.ConnectionString; }
}

Integração com Dependency Injection

Para facilitar a obtenção das strings de conexão a partir das configurações, você deve criar uma classe que herde de TenantConfiguration e configure a injeção de dependência para carregar as configurações do appSettings.json.

public class AppSettingsTenantConfiguration : TenantConfiguration
{ public string ConnectionString { get; } public AppSettingsTenantConfiguration(string tenantIdentifier, IConfiguration configuration) : base(tenantIdentifier) { ConnectionString = configuration.GetConnectionString(tenantIdentifier); }
}

Exemplo de AppSettings.json

O arquivo appSettings.json deve conter as configurações dos tenants, como no exemplo abaixo:

{ "ConnectionStrings": { "Tenant1": "Server=localhost;Database=tenant01;User Id=postgres;Password=<password>;", "Tenant2": "Server=localhost;Database=tenant02;User Id=postgres;Password=<password>;" }
}

Obtendo o ISession

Após configurar o NHibernate e o MultiTenancyConnectionProvider, é necessário configurar a obtenção da sessão (ISession) específica para cada tenant. Isso pode ser feito usando injeção de dependência e o IHttpContextAccessor para capturar o identificador do tenant a partir dos cabeçalhos da solicitação HTTP.

Registrando o ISession

Configurando a injeção de dependência para fornecer a sessão (ISession) correta com base no tenant atual:

builder.Services.AddScoped<ISession>(sp =>
{ var context = sp.GetRequiredService<IHttpContextAccessor>(); var tenant = context.HttpContext?.Request.Headers["x-customer"].ToString(); if (string.IsNullOrEmpty(tenant)) { throw new Exception("Tenant not specified in the request headers."); } var sessionFactory = sp.GetRequiredService<ISessionFactory>(); var tenantConfig = new AppSettingsTenantConfiguration(tenant, sp.GetRequiredService<IConfiguration>()); var session = sessionFactory.WithOptions() .Tenant(tenantConfig) .OpenSession(); return session;
});

No exemplo acima, o ISession é configurado dinamicamente com base no identificador do tenant fornecido no cabeçalho HTTP x-customer. O AppSettingsTenantConfiguration é utilizado para obter a string de conexão específica para o tenant, permitindo que a sessão se conecte ao banco de dados correto.

Executando

Database Tenant01

GET Tenant01

Database Tenant02

GET Tenant02

Conclusão

A implementação de MultiTenancy com NHibernate é um processo que alia simplicidade, robustez e escalabilidade. Utilizando a classe TenantConfiguration, podemos acessar/obter/montar as strings de conexão usando a Injeção de Dependência. Utilizando esse modelo de implementação e seguindo os passos e exemplos fornecidos, você usará o MultiTenancy em sua aplicação NHibernate, garantindo uma solução eficiente e adaptável para atender a diferentes necessidades de locatários.