多租户与身份基座
租户隔离怎么声明、缺省安全语义、身份从哪来(身份缝/系统身份/匿名)。 审计归因消费同一身份基座——见审计与操作日志。
声明——两条路,殊途同归
生成器双检,物化一致:影子 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 上下文 |