Core

Core · 多应用架构 · 多应用

统一登录与业务权限

平台身份与子应用账号

统一登录证明用户是谁,不决定他在子应用中能做什么。启用的平台用户可以使用有效的平台接入,无需额外配置应用成员资格;子应用保存自己的账号绑定和业务权限。

主应用管理员不会自动成为子应用管理员。不要通过同名、同邮箱或主应用角色直接授予子应用最高权限。

普通平台用户可以通过 SSO 进入子应用首页,但不会因此获得管理入口。
普通平台用户可以通过 SSO 进入子应用首页,但不会因此获得管理入口。

托管实例的自动登录接入

sub-app 模板已包含 Platform SSO 的服务端、配置和前端集成。创建托管实例时启用平台 SSO,主应用会为该实例签发客户端凭据,在部署时注入,运行激活后再启用访问。

无需手动复制 client ID 或 secret。普通应用要使用该功能,需要先完成 Platform SSO 集成并重新构建;仅开启实例开关不能给应用补装插件。

管理平台入口与统一登录开关

实例详情的平台访问中,平台入口和平台 SSO 是两个独立开关:

设置作用
平台入口控制应用是否通过平台提供访问
平台 SSO控制是否允许平台身份统一登录

关闭入口不停止实例,不删除数据。关闭托管实例的 SSO 后,平台入口使用本地登录,需先保证本地账号可用。重新启用 SSO 会使用保留的客户端配置;未完成接入的外部应用仍需先配置。

停用入口或 SSO 不是全局退出所有系统;已有平台会话会在后续访问检查中被拒绝。解除接入会撤销凭据,托管实例再次接入需要部署新凭据。

查看平台签发的登录配置

平台签发的凭据卡片展示 issuer、client ID、应用 ID 以及密钥签发状态,用于核对接入。issuer 是身份服务地址,包含认证路径,不是主应用首页地址。

这些配置由平台生成,不能在卡片中编辑。不要将一个实例的凭据复制给另一个实例,也不要把 secret 放入前端配置、源码或截图。

平台入口与 SSO 分别控制,签发的凭据仍由平台管理。
平台入口与 SSO 分别控制,签发的凭据仍由平台管理。

配置子应用业务权限

空白子应用模板包含预备的用户和角色管理页面,但默认未注册。开发业务功能时,按项目应用开发指引,在 client/routes.ts 中启用预备的 client/pages/settings/routes.ts 路由,再构建部署新版本。因此,刚创建的模板不会直接显示权限管理入口。

使用子应用本地管理员进入子应用的权限管理,为实际使用者分配所需角色、页面权限、操作权限和数据范围。按业务需求验证,例如销售人员只访问自己的客户,不能进入系统管理。

模板首页可以只要求已登录;能够打开首页并不代表业务角色已经配置。开发自定义功能时,还需要在服务端校验权限,不能只隐藏前端按钮。

保留本地管理员登录

在子应用入口路径下打开 login?auth=local,例如 https://apps.example.com/customer-dev/login?auth=local。使用该实例自己的本地管理员,不能使用主应用管理员密码代替。

保留本地登录供平台登录异常时恢复。保存初始凭据的方法见管理应用实例。退出子应用后若立即自动进入,应检查登录页的退出处理是否保留 signedOut=1,避免被现有平台会话自动登录。

子应用保留本地账号登录,同时提供平台登录入口。
子应用保留本地账号登录,同时提供平台登录入口。

验证登录、应用切换与权限

分别使用普通平台用户和本地管理员验证:

  1. 从工作台进入,SSO 回调完成并显示子应用页面。
  2. 实际打开应用切换器,验证列表、切换及返回主应用;只打开首页不会请求切换列表。
  3. 普通用户只能执行已授权的业务操作,不能访问子应用管理 API。
  4. 本地管理员仍可通过本地登录维护;本地账号不应获得伪造的平台应用列表。
  5. 停用平台用户或入口后,新的登录和后续访问检查受到限制。
打开应用切换器,可以返回平台工作台。
打开应用切换器,可以返回平台工作台。

排查回调地址与登录失败

现象检查
SSO_REDIRECT_NOT_ALLOWED使用 HTTPS;受控 HTTP 场景在主应用配置精确 origin 并重启,见运行节点配置
回调地址不匹配核对浏览器 origin、子应用 base path 和已登记回调,不自行猜测 provider ID
issuer 不一致主应用发现地址、令牌 issuer 与子应用配置须完全一致,包括协议和认证路径
能登录但没有业务权限在子应用配置角色和数据权限,不调整 SSO 来绕过权限
首页可用但没有应用切换器检查实际部署版本、前端集成和平台 URL;已有应用需要在布局中挂载切换器
平台可访问但子应用 404 或实时连接失败反向代理须转发子应用路径并支持 WebSocket

更换主应用域名或 issuer 之前,先按已安装 Platform SSO 的接入指引处理身份命名空间与回调,避免将原有用户识别为新身份。

NocoBase 文档助手

关于 NocoBase,你想了解什么?

每次提问独立回答,不会参考之前的问答。请提供完整背景。