使用Next.js构建多租户SaaS应用（后端集成）

什么是多租户SaaS应用？

多租户SaaS应用允许通过单一代码库为多个客户提供服务。但需要管理安全且特定于租户的访问权限，手动实现这一过程可能具有挑战性。因此，我决定使用Permit这一现代化授权工具来简化此过程。

本文将展示如何使用Permit简化SaaS应用的授权流程，通过逐步示例演示如何构建具有租户隔离和基于角色访问控制（RBAC）的演示应用，技术栈包括Next.js和Appwrite。

Next.js和Appwrite简介

Next.js

Next.js是基于React的框架，提供开箱即用的服务器端渲染（SSR）、静态站点生成（SSG）、API路由和性能优化。

在本项目中使用Next.js的原因：

• 允许页面预渲染，提高性能和SEO
• 内置路由便于管理页面转换和动态内容
• 轻松与Appwrite和Permit.io等后端服务集成进行身份验证和授权

Appwrite

Appwrite是后端即服务（BaaS）平台，提供用户身份验证、数据库、存储和无服务器功能。使用此类服务无需从零构建后端，可以专注于前端开发同时获得后端能力。

在本项目中使用Appwrite：

• 处理用户注册、登录和会话管理
• 提供结构化NoSQL数据库存储租户特定数据

结合使用Next.js和Appwrite可以创建可扩展的高性能多租户SaaS应用，同时保持开发过程高效。

多租户SaaS授权介绍

多租户SaaS应用是使用单一软件实例为多个用户或用户组（称为租户）提供服务的软件。

在多租户SaaS架构中，多个客户（租户）共享相同的应用基础设施或使用相同的应用，但保持数据隔离。实际例子如Trello项目管理工具：

• 在共享服务器上运行的单一基础设施，所有用户使用相同代码库
• 使用Trello的每个公司（如公司A和公司B）都是一个租户
• 数据隔离：公司A的员工只能看到自己的项目、任务和看板，公司B的员工无法访问或查看公司A的数据，反之亦然

这确保在共享资源的同时，每个租户的数据和活动都是私有和安全的。

在多租户应用中，即使在租户内部，某些用户对某些信息具有更高访问权限，而某些成员仅限于特定资源。此类应用中的授权必须：

• 确保用户无法访问其他租户或客户的数据或资源（称为租户隔离）
• 通过提供细粒度访问控制，确保租户内的用户只能访问其角色允许的资源
• 处理更多用户、租户和角色而不会降低性能

租户隔离和细粒度访问控制的重要性

租户隔离通过确保每个客户的信息保持私密来保护数据安全，而细粒度访问控制确保组织内的用户仅获得所需权限。

在SaaS应用中实施授权可能复杂且棘手，但使用Permit等授权工具时可以简化这一过程。

Permit及其优势

Permit是易于使用的授权工具，用于管理任何应用中的访问权限，包括多租户应用。在应用中使用Permit.io可以轻松定义和分配具有特定权限的角色以进行访问控制。除了在应用中创建角色外，还可以基于用户或资源属性添加条件和规则，以指定每个用户可以做什么和不可以做什么。

技术栈概述

系统架构

应用采用后端优先方法：

后端（Node.js + Express）

• 处理API请求和业务逻辑
• 使用Appwrite进行身份验证和数据库管理
• 实施Permit进行授权，定义角色和权限
• 确保在数据访问前验证每个请求

前端（Next.js）

• 安全连接到后端获取数据
• 使用基于角色的UI渲染，意味着用户只能看到他们被授权访问的内容
• 基于权限限制操作（如创建作业）

通过在API级别强制执行授权，确保即使用户操纵前端也无法绕过限制。

后端实现与Permit集成

为实施基于角色的访问控制（RBAC）和租户隔离，需要：

1. 设置Permit并定义角色、租户和策略
2. 在后端（Node.js + Express）中集成Permit
3. 使用中间件保护API路由，在允许请求前检查权限

1. 设置Permit

在编写任何代码前，需要：

• 在Permit上创建账户
• 创建资源和可在该资源上执行的操作
• 创建角色（删除自动分配的角色，创建新角色）
• 在策略编辑器中配置权限
• 复制API密钥（使用开发环境密钥）

2. 安装依赖

确保系统已安装Node.js，然后创建项目并安装所需包：

1

npm install express dotenv permitio cors appwrite axios jsonwebtoken

3. 设置Appwrite

在Appwrite中创建新项目，记录项目ID和API端点，在.env文件中配置：

1
2
3
4

PERMIT_API_KEY=你的permit密钥
APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
APPWRITE_PROJECT_ID=你的项目ID
APPWRITE_DATABASE_ID=你的数据库ID

创建以下集合及其属性：

• Profiles集合
• Students集合
• Assignments集合

4. 创建文件结构和文件

创建src文件夹和tsconfig.json文件，配置TypeScript编译器。在src文件夹内创建以下文件夹：api、config、controllers、middleware、models和utils。

详细代码实现包括：

• Permit初始化工具文件
• 错误处理中间件
• 数据模型接口（Profile、AssignmentData、StudentData）
• 认证中间件
• 权限检查工具
• 控制器实现（认证、作业、学生、配置文件管理）
• Appwrite配置和环境变量管理
• API路由设置

5. 运行项目

安装开发依赖并更新package.json脚本：

1

npm install concurrently ts-node nodemon --save-dev

运行npm run dev启动服务器，成功后即可处理请求。

使用Appwrite创建扩展后端服务的原因

Appwrite通常被描述为后端即服务（BaaS）解决方案，提供现成的后端功能（如身份验证、数据库管理和存储），无需开发人员构建传统后端。

但本项目需要更多灵活性和对数据处理、安全和结构方式的控制，因此在使用Appwrite服务的同时，使用Node.js和Express创建了扩展的自定义后端。

这种方法允许：

• 在将请求转发到Appwrite前使用Permit.io实施细粒度访问控制
• 为多租户构建API端点以确保租户特定数据隔离
• 创建自定义业务逻辑（如在提交到Appwrite数据库前处理基于角色的操作）
• 维护集中式API层，便于实施安全策略、记录活动和扩展应用

Appwrite提供了应用的核心身份验证和数据库功能，但这额外的后端层增强了安全性、灵活性和可维护性，确保任何操作到达Appwrite前都经过严格的访问控制。

结论

这是本文系列的第一部分。在第二部分中，我们将通过设置带有授权的API调用、初始化和安装必要依赖、编写组件文件代码以及处理状态管理和路由来处理前端集成。