SaaS 平台架构设计(二):平台基础篇——多租户、组织、权限、统一认证与数据安全
一、为什么 SaaS 产品需要独立的平台基础层?
在设计 SaaS 产品时,我们通常会优先考虑业务功能。
例如:
- 项目协作:项目、任务、进度、成员管理。
- CRM:客户、联系人、销售线索、商机管理。
- ERP:订单、库存、采购、财务管理。
- 行业垂直 SaaS:设备管理、数据分析、业务流程管理。
随着业务不断扩展,系统会逐渐出现一些共性问题:
- 不同客户如何共享同一套系统,又保证数据相互隔离?
- 一个客户可能存在多个部门、多个项目、多个角色,如何管理组织关系?
- 不同用户可以访问哪些菜单、页面、接口和数据?
- 多个业务系统之间如何实现统一登录和身份认证?
- 用户密码、Token、业务密钥、个人敏感信息应该如何管理?
- 当业务规模扩大,如何避免每个业务模块重复实现这些基础功能?
如果每个业务模块都独立实现这些能力,势必产生大量重复代码,而且不同模块之间的权限逻辑、安全规范也容易出现不一致。
因此,我倾向于将这些通用能力抽离出来,建立独立的平台基础层。
它不直接承担具体业务,而是为业务系统提供统一的身份、组织、权限、安全和基础治理能力。
二、平台基础层的整体架构
从架构职责上,可以将 SaaS 平台划分为四个主要层次:
1. 基础设施层
提供系统运行所需的基础资源:
- 数据库及缓存。
- 消息队列。
- 文件存储。
- 日志与监控。
- 加密服务及密钥管理。
- 网关与网络基础设施。
2. 平台基础层
负责 SaaS 产品的通用基础能力:
- 多租户管理。
- 用户与组织管理。
- 角色与权限管理。
- 统一身份认证。
- 数据权限与访问控制。
- 敏感信息管理。
- 操作审计与安全治理。
3. 业务服务层
负责具体业务领域:
- 项目管理。
- 客户管理。
- 订单管理。
- 设备管理。
- 数据分析。
- 工作流管理。
4. 应用展示层
面向不同用户提供业务入口:
- Web 管理后台。
- 业务工作台。
- 移动端。
- 大屏展示。
- 第三方系统集成。
这里需要明确一个原则:
平台基础层提供能力,业务层消费能力,应用层负责交互和展示。
平台层不应该过度侵入业务逻辑,也不应该把所有业务功能都塞进一个庞大的管理后台。
三、多租户设计:如何实现客户之间的数据隔离?
多租户(Multi-Tenant)是 SaaS 产品区别于传统单客户软件的重要特征。
传统软件通常为每个客户部署一套独立系统,而 SaaS 产品希望通过共享基础设施和服务,为多个客户提供独立的业务空间。
这里涉及一个核心问题:
如何让多个租户共享同一套系统,同时保证数据、权限和资源相互隔离?
1. 租户模型设计
首先需要建立租户(Tenant)的概念。
租户代表一个独立的客户空间,可以是企业、机构、部门,也可以是一个独立购买 SaaS 服务的组织。
基本关系:
- 平台:管理所有租户。
- 租户:拥有独立的业务空间。
- 用户:可以属于一个或多个租户。
- 组织:租户内部的部门及组织结构。
- 角色:用户在特定范围内拥有的权限集合。
需要注意,租户、组织和用户不是同一个概念。
例如,一个企业购买 SaaS 服务后,该企业是一个租户,企业内部的研发部、销售部、财务部属于组织,而员工则是用户。
2. 多租户数据隔离方案
常见的多租户数据隔离方式主要有三种:
方案 A:独立数据库
每个租户拥有独立数据库。
优点:
- 数据隔离性强。
- 可以针对不同客户独立备份和恢复。
- 方便满足特定客户的数据部署要求。
缺点:
- 数据库资源成本较高。
- 数据库迁移、版本升级和运维复杂。
- 租户数量增长后,管理成本明显增加。
适合对数据隔离、合规性和独立部署要求较高的客户。
方案 B:共享数据库,独立 Schema
多个租户共享数据库实例,但使用不同 Schema。
优点:
- 相比独立数据库节省基础设施资源。
- 具备一定的逻辑隔离能力。
缺点:
- Schema 数量增长后,维护成本增加。
- 跨租户统一查询和版本升级较复杂。
适合中等规模、需要一定隔离能力的 SaaS 系统。
方案 C:共享数据库,共享数据表
所有租户共享数据库和数据表,通过 tenant_id 区分不同租户的数据。
优点:
- 资源利用率高。
- 部署和维护成本较低。
- 更适合标准化 SaaS 产品。
缺点:
- 需要严格控制查询条件。
- 容易出现跨租户数据泄露。
- 数据权限设计和测试要求更高。
适合租户数量较多、业务模型相对标准化的 SaaS 产品。
3. 多租户数据隔离的工程实现
以共享数据库为例:
每张租户业务表都需要关联 tenant_id。
例如:
CREATE TABLE project (
id BIGINT PRIMARY KEY,
tenant_id BIGINT NOT NULL,
project_name VARCHAR(255),
created_at DATETIME
);
CREATE INDEX idx_project_tenant
ON project(tenant_id);
查询时:
SELECT *
FROM project
WHERE tenant_id = ?;
但这里有一个容易被忽略的问题:
不能仅仅依赖前端传递 tenant_id,也不能依赖开发人员在每个 SQL 中手动添加租户条件。
更合理的设计是:
- 用户登录后,由服务端确定当前租户上下文。
- 通过认证上下文建立可信的 tenant_id。
- 在服务端数据访问层统一执行租户隔离。
- 对特殊跨租户管理操作建立独立授权机制。
- 通过数据库约束、自动化测试和安全审计防止越权访问。
对于 PostgreSQL 等数据库,还可以进一步使用 Row-Level Security(行级安全策略)增加数据库层面的防护。
多租户隔离不是一个字段设计问题,而是一条贯穿认证、授权、业务服务、数据访问和审计的安全边界。
四、组织架构:如何管理用户之间的关系?
租户解决的是客户之间的隔离问题,而组织架构解决的是租户内部的人员管理问题。
例如:
一个企业可能包含:
- 总公司。
- 分公司。
- 研发中心。
- 销售部门。
- 项目组。
- 普通员工。
因此,组织架构不能简单地设计为用户与部门的一对多关系。
1. 组织模型
常见的数据结构:
- Tenant:租户。
- Organization:组织。
- Department:部门。
- User:用户。
- Membership:用户与租户或组织的成员关系。
组织关系可以使用树形结构管理:
租户 A
├── 总公司
│ ├── 研发部
│ │ ├── 前端组
│ │ └── 后端组
│ └── 销售部
└── 分公司
├── 市场部
└── 运维部
这里还需要考虑:
- 用户是否允许加入多个组织?
- 用户是否允许同时属于多个租户?
- 部门调整后,历史业务数据归属如何处理?
- 离职用户是否保留历史操作记录?
- 一个用户在不同组织中是否拥有不同角色?
这些问题决定了组织模型是否具备长期扩展能力。
2. 组织与业务数据的关系
组织架构不仅用于展示通讯录,还可能影响业务数据的归属和访问范围。
例如:
销售部门只能查看本部门客户,部门负责人可以查看下级部门客户,而企业管理员可以查看整个租户的数据。
因此,组织关系需要与数据权限模型配合,而不是单独存在。
五、权限系统:从菜单权限到数据权限
权限管理是整个 SaaS 平台最重要的基础能力之一。
传统前端项目经常采用简单的菜单权限:
用户登录
↓
获取用户角色
↓
根据角色生成菜单
↓
控制页面访问
这种方式只能解决一部分问题。
真正完整的权限体系,至少需要考虑四个层次。
1. 页面与菜单权限
控制用户可以访问哪些系统菜单和页面。
例如:
- 管理员可以访问系统设置。
- 普通员工只能访问业务工作台。
- 销售人员可以访问客户管理。
前端可以根据权限动态生成路由和菜单,但这只是用户体验层面的控制。
不能因为隐藏了菜单,就认为接口已经安全。
2. 功能操作权限
控制用户可以执行哪些操作。
例如:
- 查看。
- 新增。
- 编辑。
- 删除。
- 审批。
- 导出。
- 发布。
可以通过资源与操作的组合形成权限标识:
project:view
project:create
project:update
project:delete
project:export
前端通过权限标识控制按钮、操作入口和交互行为,后端则必须对实际请求再次进行授权验证。
3. 数据权限
数据权限解决的是:
用户可以查看哪些数据?
例如:
- 仅本人数据。
- 本部门数据。
- 本部门及下级部门数据。
- 指定项目数据。
- 当前租户全部数据。
数据权限往往比菜单权限更复杂。
因为同一个页面,不同用户看到的数据范围可能完全不同。
例如,两个销售人员都拥有客户列表的查看权限,但一个人只能查看自己的客户,另一个部门负责人则可以查看整个部门的客户。
因此,数据权限需要结合组织关系、业务归属和角色授权进行计算。
4. 接口与服务权限
当系统逐渐拆分成多个业务服务时,权限管理还需要覆盖服务之间的访问。
例如:
- Web 应用调用业务 API。
- 业务服务调用文件服务。
- 第三方系统调用开放 API。
- 定时任务访问内部数据服务。
这里需要区分用户身份和服务身份。
用户访问可以基于用户身份和授权范围判断;服务之间的访问则需要使用服务凭证、服务账号或其他机器身份认证机制。
5. RBAC 与 ABAC
常见的权限模型有:
RBAC(基于角色的访问控制)
用户通过角色获得权限。
用户 → 角色 → 权限
优点:
- 模型简单。
- 容易理解和管理。
- 适合大多数企业管理系统。
缺点:
- 当权限规则非常细致时,角色数量容易膨胀。
- 不容易表达复杂的动态条件。
ABAC(基于属性的访问控制)
通过用户、资源、操作、环境等属性动态判断权限。
例如:
用户部门 = 研发部
资源所属部门 = 研发部
操作 = 查看
当前时间 = 工作时间
系统根据规则决定是否允许访问。
优点:
- 灵活。
- 可以表达复杂的业务授权条件。
缺点:
- 规则设计和调试成本较高。
- 权限计算和维护复杂度更高。
实际项目中,我更倾向于 RBAC 作为基础模型,针对复杂数据范围和业务场景引入 ABAC 思想。
不必一开始就构建非常复杂的权限引擎。
六、统一认证:如何让多个业务系统共享身份?
当 SaaS 产品包含多个独立业务模块时,用户通常不希望每进入一个系统都重新登录一次。
例如:
SaaS 平台
├── 项目管理系统
├── CRM 客户管理
├── ERP 企业管理
├── 数据分析平台
└── 系统管理后台
这些系统需要共享用户身份,但不应该各自维护一套独立的登录逻辑。
这就需要统一身份认证体系(IAM / Identity Provider)。
1. 认证与授权的区别
认证(Authentication)解决:
你是谁?
授权(Authorization)解决:
你可以做什么?
用户成功登录,只能说明身份经过验证,并不代表用户可以访问所有业务资源。
这两个概念必须分开设计。
2. 常见认证协议
Session + Cookie
传统 Web 应用常见方式。
用户登录后,服务端创建 Session,通过 Cookie 维持登录状态。
适合传统的服务端会话体系。
JWT
服务端签发 Token,客户端在请求中携带 Token。
优点:
- 适合分布式服务之间传递身份声明。
- 服务端可以进行无状态 Token 验证。
缺点:
- Token 泄露后可能被重放。
- 已签发 Token 不容易即时撤销。
- Token 过大也会增加请求开销。
需要注意,JWT 只是令牌格式,并不等于完整的统一认证协议。
OAuth 2.0
主要用于授权委托,例如允许第三方应用在获得用户授权后访问特定资源。
OpenID Connect(OIDC)
建立在 OAuth 2.0 之上的身份认证协议,用于实现统一登录和身份信息传递。
如果需要构建多个业务系统之间的统一登录,我更倾向于采用 OIDC,而不是自行设计一套 Token 交换协议。
3. 统一认证的基本流程
用户访问业务系统 A
↓
检查登录状态
↓
跳转统一身份认证中心
↓
用户完成身份验证
↓
认证中心签发授权结果
↓
业务系统验证身份
↓
建立本地登录状态
↓
访问业务资源
实际落地时还需要考虑:
- Access Token 与 Refresh Token。
- Token 有效期及轮换。
- 单点登录与单点退出。
- 多设备登录管理。
- 登录失败限制。
- MFA 多因素认证。
- 企业 LDAP / AD 对接。
- 第三方身份源接入。
七、加密与敏感信息管理:平台安全不能只停留在登录层
在企业级 SaaS 系统中,安全不仅仅是用户能不能登录,还包括数据如何存储、如何传输、如何使用以及如何追踪。
我认为可以把安全管理拆分为几个层次。
1. 传输安全
系统通信应该使用 HTTPS / TLS。
尤其是:
- 用户登录。
- Token 传递。
- API 请求。
- 文件上传下载。
- 第三方服务调用。
避免通过明文传输密码、认证凭证和敏感业务数据。
2. 密码安全
用户密码不应该使用可逆加密或明文保存。
推荐使用专门的密码哈希算法:
- Argon2id。
- bcrypt。
- scrypt。
密码保存时应使用独立随机盐值。
密码验证通过哈希比对完成,而不是解密原密码。
3. 敏感数据加密
对于身份证号码、手机号、银行卡号、企业密钥等敏感信息,需要根据数据类型和业务使用场景进行分类管理。
可以考虑:
- 数据库字段级加密。
- 应用层加密。
- 数据库透明加密(TDE)。
- 文件加密存储。
- 传输过程加密。
这里需要注意,密码哈希和数据加密是两个不同的概念。
密码通常只需要验证,不需要还原;而业务敏感数据可能需要在授权后读取,因此需要可控的加解密机制。
4. 密钥管理
加密的核心不仅是算法,还包括密钥管理。
不应该将数据库密码、API Secret、加密密钥直接写入代码仓库或前端环境变量。
建议将密钥交给专门的密钥管理服务:
- KMS:密钥管理服务。
- HSM:硬件安全模块。
- Secret Manager:敏感配置管理。
同时需要考虑密钥轮换、权限隔离、密钥访问审计和密钥泄露后的应急处理。
5. 前端敏感信息管理
这是前端开发中容易被忽略的地方。
浏览器运行环境并不可信,任何交付到浏览器的内容,都有可能被用户查看。
因此:
- 不要在前端代码中保存数据库账号密码。
- 不要将长期有效的 API Secret 写入环境变量并打包。
- 不要将敏感 Token 随意存入 localStorage。
- 不要在控制台输出用户密码、Token 和敏感业务信息。
- 不要在 URL 参数中传递密码和敏感凭证。
- 对敏感字段进行脱敏展示。
- 下载、导出等操作必须经过服务端授权。
对于浏览器端登录态,可以考虑采用 HttpOnly、Secure、SameSite Cookie,并配合 CSRF 防护等机制。
6. 敏感数据脱敏
不同角色看到的数据可能不同。
例如:
原始手机号:13812345678
普通员工:138****5678
管理员:13812345678
这里需要注意,脱敏展示并不等于数据安全。
如果前端已经获取了完整手机号,只是在页面上通过 CSS 或 JS 隐藏部分字符,那么用户仍然可以通过浏览器开发工具获取原始数据。
正确的设计应该是由服务端根据用户权限决定返回完整数据还是脱敏数据。
7. 操作审计
企业系统还需要具备可追溯能力。
例如:
- 谁登录了系统?
- 谁修改了用户权限?
- 谁导出了客户数据?
- 谁删除了业务记录?
- 谁访问了敏感信息?
建议建立统一审计日志,记录操作者、操作时间、操作对象、操作类型、结果及必要的上下文。
对于高风险操作,还需要记录审批信息和变更前后的关键数据。
审计日志本身也需要防篡改、访问控制和保留周期管理。
八、AI 编程时代:平台架构设计需要发生哪些变化?
这是我认为这一篇文章最值得展开讨论的部分。
随着 AI 编程工具逐渐普及,前端、后端、数据库和基础设施的代码实现门槛都在降低。
过去需要花费大量时间实现的用户管理、角色管理、菜单管理、Token 校验等基础模块,现在 AI 已经可以快速生成。
但代码生成能力提高,并不代表系统设计能力同步提高。
尤其是 SaaS 平台这种涉及租户隔离、用户身份、数据权限和敏感信息的系统,AI 生成代码可能存在一些隐蔽问题:
1. 代码能运行,不代表权限正确
例如:
AI 可能在一个业务接口中自动生成:
return projectMapper.selectById(id);
代码本身没有问题,但如果没有验证当前用户是否有权访问该项目,就可能产生越权访问。
又或者:
SELECT * FROM customer;
忘记添加租户隔离条件,最终造成跨租户数据泄露。
因此,AI 编程不能只关注功能是否实现,还需要检查安全边界是否完整。
2. 从代码规范转向架构约束
在 AI 辅助开发过程中,我认为应该提前建立项目级规则:
- 每个业务请求必须具备租户上下文。
- 所有业务资源访问必须经过服务端授权。
- 禁止在前端存储长期有效的服务端密钥。
- 敏感字段必须遵循统一的数据处理规范。
- 数据库访问必须遵循租户隔离规则。
- 高风险操作必须具备审计记录。
- 认证与授权逻辑不能由业务页面自行实现。
这些规则应该被沉淀到项目架构文档、AI 开发规范和代码检查工具中。
3. 建立 AI 可理解的项目上下文
AI 编程最容易出现的问题之一,就是缺少完整的项目上下文。
例如,AI 在开发一个客户管理页面时,如果不知道:
- 当前系统采用什么租户模型?
- 用户与组织是什么关系?
- 当前项目采用 RBAC 还是 ABAC?
- 数据权限由谁负责计算?
- Token 是如何签发和验证的?
- 哪些字段属于敏感信息?
那么它可能按照自己的理解生成一套局部可用、整体不一致的代码。
因此,建议建立统一的架构文档:
/docs
├── architecture.md
├── tenant-design.md
├── organization-design.md
├── permission-design.md
├── authentication-design.md
├── security-design.md
└── development-rules.md
让 AI 在开发前先理解项目的基础模型、接口规范和安全约束。
4. 从人工代码审核转向自动化安全验证
AI 可以帮助生成代码,但最终仍然需要通过自动化手段验证系统行为。
例如:
- 单元测试:验证权限判断逻辑。
- 集成测试:验证租户数据隔离。
- 越权测试:尝试访问其他用户、其他组织和其他租户的数据。
- 静态代码扫描:检查硬编码密钥及危险代码。
- 依赖安全扫描:检查第三方依赖漏洞。
- API 安全测试:检查未授权访问、参数篡改等问题。
尤其是多租户系统,应该把跨租户访问测试作为基础测试项,而不是等到出现安全事故之后再补充。
AI 可以降低代码实现成本,但不能代替架构设计、安全评审和系统验证。
九、前端视角:平台基础层如何与前端应用协作?
回到前端架构本身。
如果平台基础层已经提供了统一的认证、用户、组织和权限服务,那么前端不应该再独立维护一套完整的权限体系。
前端更适合承担以下职责:
1. 登录与身份状态管理
- 统一登录入口。
- 登录状态维护。
- Token 或 Cookie 协作。
- 租户切换。
- 用户信息获取。
- 登录过期处理。
2. 动态路由与菜单
根据服务端返回的菜单和页面访问权限,生成当前用户可访问的路由。
但需要注意,动态路由只是前端导航控制,不是服务端安全授权。
3. 按钮与操作权限
通过统一权限指令或组件控制操作入口。
例如:
<template>
<button v-if="hasPermission('project:delete')">
删除项目
</button>
</template>
在 React 中也可以封装统一的权限组件。
4. 数据展示与脱敏
根据服务端返回的数据权限和脱敏结果展示业务信息。
前端可以负责交互体验,但不应该成为数据安全的最终判断者。
5. 多业务系统协作
如果平台存在多个独立业务应用,可以通过统一身份认证和统一用户上下文,构建共享的应用入口。
但不建议将认证、权限判断、组织关系等核心业务规则复制到每一个前端项目中。
前端应该消费平台能力,而不是重新实现平台能力。
十、总结:平台基础层决定 SaaS 产品的长期扩展能力
从整个架构来看,平台基础层并不是某一个独立业务模块,而是所有业务系统共同依赖的基础能力。
多租户解决客户之间的隔离问题。
组织架构解决用户之间的组织关系问题。
权限系统解决资源访问和操作控制问题。
统一认证解决跨系统身份识别问题。
加密与敏感信息管理解决数据安全问题。
审计体系解决系统行为追溯问题。
这些能力共同构成了 SaaS 产品的基础治理体系。
我认为,SaaS 产品的架构设计不应该只关注业务功能如何实现,更应该考虑这些基础能力如何沉淀、复用和演进。
尤其是在 AI 编程时代,代码本身越来越容易生成,真正决定系统质量的,是我们能否建立清晰的业务边界、数据边界、权限边界和安全边界。
本专栏的思考方向
这一篇主要围绕 SaaS 平台的基础能力展开,下一步还可以继续深入:
- 多租户架构如何支持 SaaS、私有化部署与混合部署?
- RBAC 与 ABAC 如何结合,构建可配置的数据权限体系?
- 如何设计独立的 IAM 身份认证中心?
- 前端微前端架构如何与统一身份认证体系协作?
- 如何利用 AI Agent 理解项目架构、遵循权限规范并自动完成代码安全检查?
这些问题也会逐渐构成一个完整的 SaaS 平台架构设计体系。