多租户 SaaS 的隔离:tenant_id 不是一个前端筛选条件

多租户产品常见错误是让浏览器提交 tenant_id,然后相信它。正确做法是服务端先验证用户身份,再根据用户与组织的成员关系确定可访问租户;任何资源操作都必须在该授权范围内执行。

查询时必须绑定租户

读取项目应类似 WHERE tenant_id = ? AND id = ?,两个参数均来自服务端验证后的上下文。更新、删除和计数也要带相同约束。仅使用随机资源 ID 不能替代授权;即使 ID 难猜,也可能通过日志、共享链接或错误消息泄露。

在数据库建立合适的复合索引与唯一约束,例如 (tenant_id, external_id)。管理员跨租户操作应走独立、可审计的权限路径,不要复用默认用户接口并用一个可由客户端控制的标志跳过检查。

容易遗漏的通道

缓存键要包含租户与权限维度;后台任务必须携带已验证的租户上下文,消费者执行时重新验证资源归属。文件 URL、搜索索引、导出任务、Webhook 和日志都可能泄露跨租户数据。共享缓存失效时还要避免一个租户清理另一个租户的内容。

测试至少包括:用户 A 读取 B 的 ID、修改 URL 参数、重放已撤销成员身份的任务、缓存命中跨租户请求,以及具有不同角色的同一租户成员。隔离策略不是一次性中间件,而是每条数据路径都要遵循的约束。

参考:OWASP 访问控制指南;Cloudflare D1 索引。