📚 课程目录第3章租户与客户管理

3. 租户与客户管理：租户概念、创建与管理租户、客户实体、客户与设备的关系

在 ThingsBoard 平台中，租户（Tenant）与客户（Customer）是构建多租户架构的核心实体。理解这两个概念及其关系，是进行设备配置、数据隔离与权限管理的基础。本章将深入剖析租户与客户的定义、创建流程以及它们与设备之间的关联。

租户是 ThingsBoard 中的顶级隔离单元，代表一个独立的组织、企业或项目。每个租户拥有自己独立的设备、资产、仪表板、规则链和用户体系，彼此之间数据完全隔离。

特性	说明
数据隔离	租户 A 无法看到租户 B 的任何设备、遥测数据或告警。
资源配额	系统管理员可为每个租户设置设备数量、API 调用频率、存储容量等上限。
自定义配置	租户管理员可自定义邮件服务器、OAuth 2.0 登录、规则链等全局设置。
层级管理	租户下可创建多个客户，实现二级组织架构。

关键认知：租户是 ThingsBoard 多租户架构的基石。在 SaaS 部署模式下，一个平台实例可以同时服务数百个租户，每个租户都感觉自己在使用一个独立的系统。

租户的创建通常由系统管理员（SysAdmin）完成。以下是标准创建流程：

    租户创建表单关键字段：
    标题（Title）：租户的显示名称，如“智慧农业科技有限公司”。
邮箱（Email）：租户管理员的登录邮箱。
时区（Timezone）：影响设备遥测数据的时间戳显示。
默认仪表板（Default Dashboard）：租户管理员登录后默认看到的仪表板。

客户是租户下的子实体，代表租户的终端用户、部门或合作伙伴。客户无法创建新的租户，但可以在租户分配的权限范围内管理设备、查看遥测数据。

创建客户时，租户管理员需要指定客户标题、邮箱（用于客户管理员登录）、以及可选的附加信息。每个客户创建后，系统会自动生成一个客户管理员账号。

设备与客户之间是多对一的归属关系。一个设备只能属于一个客户（或不属于任何客户，直接归属租户），而一个客户可以拥有多个设备。这种关系决定了数据访问权限：

权限边界：客户无法查看或操作不属于自己的设备。即使设备与客户在同一个租户下，客户也无法通过设备名称或ID直接访问其他客户的设备数据。这是 ThingsBoard 实现数据安全隔离的关键机制。

当设备归属于某个客户后，数据访问遵循以下流程：

    实践建议：在设备配置阶段，建议先创建好租户和客户结构，再将设备批量分配给对应的客户。如果设备已经上线，可以通过“分配设备到客户”功能进行后绑定，无需重启设备。

重要提醒：删除客户是一个不可逆操作。如果客户下仍有设备，系统会阻止删除操作。建议在删除前，先将设备转移到其他客户或直接归属租户。

通过合理规划租户与客户结构，可以实现灵活的多级权限管理，确保不同组织、部门或终端用户只能访问属于自己的设备数据，为物联网平台的安全运营奠定坚实基础。