Table of Contents

多租户与身份基座

租户隔离怎么声明、缺省安全语义、身份从哪来(身份缝/系统身份/匿名)。 审计归因消费同一身份基座——见审计与操作日志。

声明——两条路,殊途同归

生成器双检,物化一致:影子 TenantId 列 + 全局查询过滤器 + 写面租户执法。

[EfEntity("Billing", EfEntityFeatures.Tenant)]          // 路 A:特征位(名称绑定——实体程序集零 EF 依赖)
public class Invoice { ... }

public class Ledger : ITenantEntity { ... }             // 路 B:标记接口(KernLab.Loom 根命名空间)

配对锁(KLSG201,Error):租户实体绑定的上下文必须挂租户约定(ITenantAwareContext)——实体说"我是租户数据"而上下文没挂约定 = 静默丢过滤器 = 跨租户泄露,生成器直接编译报错。生成路径自动满足(任一实体带租户 → 生成的上下文自动实现 ITenantAwareContext);此锁主要拦手写上下文的误配。

未标记 = 零介入:租户没有全局开关——它是逐实体的数据分类。不声明租户的实体:无列、无过滤器、无执法,运行时零开销。要问的是"这张表要不要隔离",不是"系统开不开租户"。

无租户身份时的两张面孔(缺省安全——两个方向都朝着"不泄露")

场景 行为 为什么不是反方向
查询(身份缝无租户 / 未注册身份缝) 空匹配——一行都查不到 无身份静默看全量 = 泄露方向
写入租户实体(无租户身份) 显式异常("当前无租户身份") 静默写入 = 跨租户污染

没有"开着但临时关一下"的中间态——那个中间态就是泄露口。

身份基座(LoomIdentity / ILoomIdentitySource)

// 最小载体(Subject + TenantId;外部 record 继承加字段)
using var _ = LoomIdentityScope.Run(new LoomIdentity("tester", "tenant-x"));   // AsyncLocal 环境挂载

// 缺省来源 = 环境位;宿主自管来源 = DI 注册自己的 ILoomIdentitySource 整体接管
services.AddSingleton<ILoomIdentitySource, MyIdentitySource>();

// 桥入审计缝(审计填值/租户列现成消费身份基座)
services.AddSingleton<ILoomAuditIdentity>(new LoomAuditIdentityAdapter(mySource));
// 或自定义实现:ILoomAuditIdentity 已派生 ILoomIdentitySource,实现者补 Current 即接入

系统任务与后台作业:身份基座自带系统身份——带租户干活 LoomIdentityScope.Run(LoomIdentity.SystemOf(tenantId))(显式声明为哪个租户干活);纯系统数据(迁移/种子记账)用无租户形态 LoomIdentity.System。宿主自管来源(DI 注册 ILoomIdentitySource)时由宿主供给等价形态。

未登录流(匿名):租户内匿名浏览 LoomIdentityScope.Run(LoomIdentity.AnonymousOf(tenantId))(查询过租户过滤、审计归因记 anonymous;读面语义,业务不应挂进写流);公共数据面(无租户)用 LoomIdentity.Anonymous。不挂任何身份 = 对租户数据不可见(缺省安全),与匿名的区别只在审计归因与显式声明意图。

旁路边界

IncludeDeletedScope() 只旁路软删子条件,租户条件永不旁路;IgnoreQueryFilters 双闸禁用(编译期 KLSG211 + 运行时 Throw)。跨租户运维查询走中枢面(受控运营通道),业务代码里没有临时跨租户的口。租户值每次查询执行经身份缝现读(上下文血统委托——多容器互不污染),池化安全。

反模式

症状 为什么错 正确形态
保存租户实体抛"当前无租户身份" 租户写入缺省安全执法——无身份静默写入 = 跨租户污染 宿主注册 ILoomAuditIdentity 并供给 TenantId;系统任务用显式系统身份
后台任务查租户数据一行都没有 缺省安全:无身份 = 空匹配 LoomIdentityScope.Run(LoomIdentity.SystemOf(tenantId)) 显式声明为哪个租户干活
租户条件写进业务 Where 觉得不放心又加了 IgnoreQueryFilters 旁路把租户条件一并撤了 什么都不加——过滤器自动生效;运维面走中枢通道
池化上下文串租户 旧库没有现读租户 上下文血统委托是内置行为——确保走 AddLoomEf* 装配而非手工 new 上下文

想深入