Skip to content

角色权限 ​

菜单:站点设置 → 角色权限(高级菜单)
深链:/_Admin/system/roles?SiteId={站点GUID}

角色权限定义本站 站点角色 可访问的后台 feature 与 action(查看 / 编辑 / 删除等)。在 站点用户 中为成员指定角色后,其登录后台时的菜单、按钮与 API 调用均受本页配置约束。

权限

操作权限
查看角色列表role
添加角色、编辑权限并 保存role·edit
多选 删除 自定义角色role·delete

高级菜单

本菜单在路由上标记为 advanced: true,除勾选 站点设置 分组外,还须能在 编辑菜单 中看到 角色权限 子项(或由 master 等全权限角色访问)。

如何打开 ​

  1. 在 编辑菜单 中勾选 站点设置 → 角色权限。
  2. 左侧 站点设置 → 角色权限。
角色权限

工具栏 ​

控件说明
添加角色打开 添加角色弹窗,新建自定义角色并勾选权限
角色权限工具栏

角色列表 ​

列说明
角色名name,以标签展示
编辑铅笔按钮,打开权限编辑弹窗

列表含 内置角色 与 自定义角色,按创建时间倒序。内置三项 master、developer、contentmanager 的复选框 不可选(不可批量删除),但仍可 编辑 其权限并保存到站点的 RolePermission 仓库。

角色列表

内置角色(概览) ​

角色名说明
master默认拥有全部已注册 feature 权限(全选)
developer预置开发相关 feature(页面、Code、数据库、服务集成、Hook 等)
contentmanager预置内容与电商运营相关 feature(内容、媒体、商品等)

具体 feature 集合以 Kooboo 版本内 PermissionService.EmbeddedRoles 为准;可在后台 编辑 查看或微调后保存。

删除限制 ​

  • 内置角色 不可删除。
  • 自定义角色 若仍有 站点用户 的 SiteRole 引用,删除时会报错(The role is in use and cannot be deleted)。

添加或编辑角色 ​

添加角色弹窗

编辑已有角色时弹窗标题为 编辑角色,角色名 输入框 禁用(不可改名);新建时须填写唯一名称(1~50 字符,且不能与内置角色名冲突)。

编辑角色权限

权限面板 ​

区域说明
全选勾选/取消当前角色全部 permission
Feature 列每项对应一个 feature(如 pages、content、domain),文案来自后台国际化(如「页面」「域名管理」「服务集成」)
单项复选框仅含一种 action 的 feature 直接勾选
带下拉的 Feature点击标签弹出 查看 / 编辑 / 删除(及 debug 等)子项;可对该 feature 全选

勾选 编辑、删除 或 debug 时,会自动勾选同 feature 的 查看;若子项仍选中,则 查看 不可单独取消。含多种 action 的 feature 点击标签可展开子复选框(如 查看 / 编辑 / 删除)。

保存调用 Role/post,写入站点 RolePermissionRepository。

feature 与后台菜单 ​

权限项由服务端 PermissionService.GetList() 汇总各 API 的 [Permission] 特性生成;新增 Kooboo 版本可能增加 feature。常见对应关系示例:

feature(部分)后台能力
pages页面设计与路由
content / contentType内容与数据类型
database数据库菜单
config服务集成
domain域名管理
siteUser / role站点用户、本页
frontEvents / backendEvents请求 Hook、操作 Hook
commerce* 系列电商各子菜单

左侧菜单可见性还会受前端 角色菜单过滤(运营/设计师/开发者预设)影响;API 与按钮仍以本页勾选的 Permissions 为准。

与站点用户的关系 ​

角色权限(本页)站点用户
回答某角色 能做什么谁 拥有某角色
顺序通常 先 定义或确认角色再 把成员加入站点并选角色

典型工作流 ​

  1. 查看内置 developer / contentmanager 是否满足团队分工,必要时 编辑 微调。
  2. 若无合适预设,添加角色(如 content-editor),按 feature 勾选权限并 保存。
  3. 在 站点用户 把协作者加入本站并分配角色。
  4. 让对方登录验证菜单与关键操作;权限不足时回到本页调整。
  5. 停用角色前,先移除或改派所有引用该角色的站点用户,再 删除 自定义角色。

相关 ​

文档说明
站点设置概述菜单总览
站点用户成员与角色绑定
编辑菜单菜单显示与高级项