管理用户、角色和权限

完成后,每位成员只持有其工作所需权限的角色,你也可以暂停或封禁任意账号。

访问控制基于角色。用户持有角色,每个角色授予若干权限键。进入 /admin 需要 admin.access,每个后台页面再各自检查权限,所以成员能看到哪些页面由其角色确定。

准备工作

  • 已用 pnpm db:bootstrap-super-admin 创建第一个管理员,见 安装后的第一步。
  • 创建角色需要 roles.write;分配角色或修改用户状态需要 users.write。
  • 带说明的完整权限目录在 /admin/permissions。

创建角色

一般来说,.read 权限用于打开页面,对应的 .write 权限用于在页面上修改数据。

打开角色表单

进入 运营 → 角色(/admin/roles),切换到 新增角色 标签页。

从预设开始(可选)

在 侧边栏角色预设 中点击一个预设填入表单。预设包括 Admin Overview、Admin Operations、Commerce Manager、Platform Operator、Content Manager、Security Manager 和 Settings Manager。角色列表中已有同样 Key 的角色,可以直接分配。

描述角色

填写 Key(稳定的标识,例如 support.lead)、名称 和 描述,三项都必填。

勾选权限

在 权限 中勾选要授予的权限。权限按侧边栏区域分组:Overview、Operations、Commerce、Platform、Content、Security、Settings 和 Other。务必包含 admin.access。

保存

点击 保存角色。

之后要修改角色,切换到 角色与用户 标签页,在 角色列表 中该角色所在行点击 编辑。删除 仅在没有用户持有该角色时可用。带说明的完整权限列表在 /admin/permissions(权限目录,侧边栏中没有入口)。

为用户分配角色

找到用户

进入 概览 → 用户(/admin/users/dashboard),找到该用户,点击用户名或 详情。

检查状态

在 访问状态 中,状态 必须是 正常。待审核或已封禁的用户无论持有什么角色都没有任何权限。

选择角色

在 角色 卡片上点击 角色 按钮,在 更新用户角色 对话框中勾选要授予的角色、取消要移除的角色,然后点击 保存角色。

已经持有角色的用户也会出现在 /admin/roles 的 角色下的用户 中,点击 更新角色 打开同一个对话框。

暂停或封禁用户

打开用户

在 概览 → 用户 中点击该用户的 详情。

设置状态

把 状态 设为 正常、待审核 或 已封禁。封禁时可以填写 封禁原因 和 封禁到期。

保存

点击 保存。页面提示已保存,并记录审计日志。

被封禁的用户无法登录,访问页面会被带到 /system/permission-denied,其 API 密钥也会失效。封禁到期 时间过后,账号重新视为正常。待审核的用户会被带到 /system/session-expired。

无需重新登录即可生效

角色和状态的变更在用户下次加载页面时生效,不需要让用户重新登录。

验证

在无痕窗口中以该用户登录。侧边栏只显示其角色允许的页面。通过 URL 打开缺少权限的页面时显示 Permission denied: <权限>。安全 → 审计(/admin/audit)中能看到状态变更。在命令行运行 pnpm validate:users,会检查角色保存、分配和状态变更。

常见问题

/admin 跳转到 /system/permission-denied

用户缺少 admin.access。分配包含该权限的角色;如果是第一个管理员,运行 pnpm db:bootstrap-super-admin。

页面显示 Permission denied: <权限>

用户能进入后台,但缺少该页面检查的权限。/admin 仪表盘需要四项:admin.dashboard.read、users.read、credits.read 和 ai.read,所以范围较窄的角色打开它会报错。

用户持有正确的角色却仍然没有权限

该用户的 状态 是待审核或已封禁。在用户详情页把状态改为 正常。

新权限没有授予 Super Admin

角色权限在运行 pnpm db:bootstrap-super-admin 时写入。升级新增权限后需要再运行一次。

参考

下一步