需通过角色与分组机制实现禅道模块级权限精细化控制:一、创建权限分组;二、为分组分配模块操作权限;三、将用户加入分组;四、验证权限效果;五、可选API批量配置。

如果您在禅道系统中需要为不同人员分配差异化的操作能力,则需通过角色与分组机制对模块级权限进行精细化控制。以下是配置用户角色权限的具体步骤:
一、创建权限分组
权限分组是禅道中组织权限的基本单元,所有用户必须归属至少一个分组才能获得相应权限。分组独立于部门结构,专用于权限隔离与复用。
1、使用管理员账号登录禅道系统。
2、进入后台 → 人员视图 → 权限,打开分组列表页面。
3、点击“新增分组”按钮,在弹出表单中填写分组名称(如“测试工程师组”、“产品经理组”)和描述信息。
4、点击“保存”,新分组即创建完成,后续可进行权限维护或成员添加。
二、分配模块操作权限
每个分组可被赋予对特定模块(如任务、缺陷、需求、文档等)的查看、编辑、删除、提交等细粒度权限,确保最小权限原则落地。
1、在分组列表页面,找到目标分组,点击其操作栏中的“权限维护”。
2、进入权限列表页后,展开任一模块(例如“缺陷管理”),可见该模块下全部可配置权限项(如“提交缺陷”“修改缺陷”“关闭缺陷”)。
3、勾选所需权限项;若需批量操作,点击模块名后方的复选框可全选或取消该模块全部权限。
4、如使用禅道7.2.stable及以上版本,还可点击“视野维护”,设置该分组仅能访问指定项目集、产品或项目,实现数据级隔离。
5、确认无误后,点击页面右上角“保存”按钮提交配置。
三、将用户加入分组并生效权限
用户权限由所属分组决定,不直接绑定个人账户。因此需将用户明确划入已配置好权限的分组中,权限才实际生效。
1、返回后台 → 人员视图 → 用户列表,找到待授权用户。
2、点击该用户行末的“编辑”按钮,进入用户编辑页。
3、在“所属分组”字段中,从下拉菜单选择一个或多个已配置权限的分组(支持多选)。
4、点击“保存”,用户立即继承所选分组的全部权限配置。
四、验证权限配置效果
权限变更后需以目标用户身份实测,避免因缓存或配置遗漏导致功能异常。验证应覆盖核心操作路径,而非仅界面显示。
1、退出管理员账号,使用被授权用户账号重新登录。
2、依次访问各目标模块(如“缺陷”“任务”“需求”),观察顶部操作按钮是否按预期出现或隐藏。
3、尝试执行关键动作(如点击“提交缺陷”按钮、编辑他人创建的任务),确认系统响应符合权限设定(允许操作或提示无权限访问)。
4、若发现权限未生效,检查该用户是否确属对应分组,且该分组的权限维护页面已点击“保存”。
五、通过API批量设置权限(高级方式)
适用于大规模团队或自动化运维场景,可绕过Web界面,调用禅道开放API完成角色权限的程序化配置,提升部署一致性与效率。
1、确保已开启禅道API服务,并获取具备权限管理能力的Bearer Token。
2、构造POST请求,目标URL为 http://your.zentao.server/api/permission。
3、请求头包含 Authorization 与 Content-Type,其中 Authorization 值为 Bearer your_token。
4、请求体为JSON格式,包含 roleId 和 permissions 字段,例如:{"roleId": 3, "permissions": ["bug-submit", "task-edit"]}。
5、发送请求后,检查响应状态码:200 表示成功;非200则根据 response.text 中的错误信息定位问题。










