租户隔离怎么做的
请求级上下文用 AsyncLocalStorage 挂当前租户,仓储层统一取值。跨租户的查询、修改、删除与指令下发一律返回 404,不靠前端过滤。设备侧按 accessToken 反查归属,设备不需要知道自己属于谁。
设备只要能发 HTTP,就能接进来。业务层完全自研,数据落在自己的服务器;设备量上来后,设备层可以换成 ThingsBoard CE,业务侧一行不用改。
本机运行形态为 Node 22 + 内置 SQLite 单进程;生产规模化形态为「ThingsBoard CE 设备层 + 飞葵业务后端 + 本品牌前端」。
设备侧只认 accessToken,不碰登录态。换成真 ThingsBoard 时,设备固件不用改,只需把地址和 token 换掉。
| 能力 | 接口 |
|---|---|
| 遥测上报 | POST /api/v1/{token}/telemetry |
| 设备属性 | POST /api/v1/{token}/attributes |
| 指令下发 | GET /api/v1/{token}/rpc(长轮询) |
| 指令回执 | POST /api/v1/{token}/rpc/{id} |
桥接已对仿真 ThingsBoard 做过 31 项联调测试,尚未对接真实 TB 实例;真机联调需在现场完成。
一套部署可以管多个基地公司。除传感器字典外,所有业务表都带租户标识;请求进来先定租户,仓储层统一取值,漏传也不会跨租户泄露。
请求级上下文用 AsyncLocalStorage 挂当前租户,仓储层统一取值。跨租户的查询、修改、删除与指令下发一律返回 404,不靠前端过滤。设备侧按 accessToken 反查归属,设备不需要知道自己属于谁。
服务端通过 SSE 推送遥测、告警、阀门、指令、地块、农事、病虫害、阈值与快照事件。前端合并进内存状态后节流重绘,用户在输入框里打字时不会被打断。
这些是已经落地的默认行为,不靠部署时记得配。安全护栏不等于渗透通过,正式上线前仍需独立的安全测试。
| 项 | 做法 |
|---|---|
| 静态资源白名单 | 只放行页面、样式、脚本与图片;源码、工具、部署脚本与数据库一律 404 |
| 路径穿越 | 先解码再规范化,含 .. 或非法编码直接 404 |
| 安全响应头 | 禁止被嵌入、内容类型嗅探关闭、地理定位只允许同源、CSP 不放行任意脚本与内联脚本 |
| 接口限流 | 按来源 IP 令牌桶,超限返回 429 并给出重试时间 |
| 登录防爆破 | 按「账号 + IP」记失败次数,超限锁定;锁定期内口令正确也先拒绝 |
| 账号枚举 | 账号不存在与密码错误返回同一句提示 |
| 代理来源 | 默认只信 socket 地址,显式开启后才读转发头,避免伪造头绕过限流 |
| 审计 | 阈值变更、地块增改、告警处理、指令下发、合规放行全部留痕 |
哪些是自己写的、哪些是站在成熟底座上、哪些需要另外授权,一次说明白。
规则引擎、告警、灌溉闭环、施药合规、进销存、多租户、审计与前端界面,全部自研。本机形态零第三方运行时依赖。
规模化生产路径采用 ThingsBoard CE(Apache-2.0)。飞葵与它按协议对接,不修改上游代码;本机形态为等价的轻量实现。
卫星底图使用腾讯位置服务,需自备 key 并按官方条款使用;未配置时降级为坐标示意图。系统内不内置任何可用 key。
不夸大的部分:未声称已通过等保三级,未声称大规模商用;卫星地图不是测绘成果;AI 能力不在本产品范围内。设备控制的安全最终由现场硬件互锁与操作规程承担。