自定义项目角色
提示
Feature availability 功能可用性
自定义项目角色适用于:
- n8n Cloud: Enterprise
- Self-hosted: Enterprise
可用版本:n8n 1.122.0(2025 年 11 月 24 日发布)
提示
Instance roles vs project roles 实例角色与项目角色
n8n 有两种类型的自定义角色:
Custom instance roles 自定义实例角色:与用户在实例级别所需的管理功能相关的角色。请参阅创建自定义实例角色。
Custom project roles 自定义项目角色:适用于特定项目的角色。
自定义项目角色允许你创建符合团队需求的特定权限角色。与内置项目角色(Admin、Editor、Viewer)不同,自定义角色可让你对工作流、凭据和其他项目资源进行细粒度的访问控制。
创建自定义角色
实例所有者和实例管理员可以创建自定义角色。
创建自定义角色:
- 转到 Settings 设置 > Project roles 项目角色。
- 选择 Create role 创建角色。
- 输入角色名称和可选描述。
- 选择此角色的权限(范围):
- Workflow permissions 工作流权限:查看、执行、编辑、创建、发布、转移、删除工作流,或管理工作流的数据脱敏。
- Credential permissions 凭据权限:查看、编辑、创建、共享、取消共享、转移或删除凭据。
- Project permissions 项目权限:查看、编辑或删除项目。
- Folder permissions 文件夹权限:查看、编辑、创建、转移或删除文件夹。
- Execution permission 执行权限:显示已脱敏的执行数据。
- Secret vault permissions 密钥保管库权限:查看、创建、编辑、删除或同步项目的密钥保管库。
- Secrets permission 密钥权限:在凭据中使用密钥。
- Data table permissions 数据表权限:查看表、查看行、编辑表、编辑行、创建或删除表。
- Project variable permissions 项目变量权限:查看、编辑、创建或删除项目变量。
- Source control 源代码控制:推送到源代码控制。
- 选择 Create role 创建角色。
为用户分配自定义角色
项目管理员可以为项目成员分配自定义角色。自定义角色只在分配的项目内生效,用户可以在不同项目中拥有不同角色。
分配自定义角色:
- 选择项目。
- 选择 Project settings 项目设置。
- 在 Project members 项目成员 中浏览或搜索用户。
- 选择用户,并从下拉列表中选择自定义角色。
- 选择 Save 保存。
提示
Project-level permissions 项目级权限
自定义角色权限仅适用于分配该角色的项目内。要在多个项目中授予相同的权限,请在每个项目中单独分配自定义角色。
编辑自定义角色
要修改现有自定义角色:
- 前往 Settings 设置 > Project roles 项目角色。
- 找到要编辑的自定义角色。
- 选择 three-dot menu 三点菜单 > Edit 编辑。
- 更新角色名称、描述或权限。
- 选择 Save changes 保存更改。
警告
Editing affects all assigned users 编辑会影响所有分配的用户
对自定义角色的更改会立即影响任何项目中分配给该角色的所有用户。如果在多个项目中使用该角色,则权限更改将应用于分配该角色的所有位置。
复制自定义角色
要基于现有角色创建新角色:
- 前往 Settings 设置 > Project roles 项目角色。
- 找到要复制的角色。
- 选择 three-dot menu 三点菜单 > Duplicate 复制。
- 根据需要修改角色名称和权限。
- 选择 Create role 创建角色。
删除自定义角色
要删除自定义角色:
- 前往 Settings 设置 > Project roles 项目角色。
- 找到要删除的角色。
- 选择 three-dot menu 三点菜单 > Delete 删除。
- 确认删除。
提示
Reassign users before deletion 删除前重新分配用户
如果用户已分配给此角色,则必须先将其重新分配给其他角色,然后再删除该角色。
权限范围参考
自定义角色使用权限范围来定义用户在项目内可以执行的操作。以下每个范围都对应 Project roles 项目角色编辑器中的一个复选框。章节标题与编辑器中的章节名称一致;范围代码则会出现在 API 响应和审计日志中。
提示
Automatically granted scopes 自动授予范围
n8n 将一些范围配对在一起,因此它们不会显示为单独的复选框:
- 授予
<resource>:read还会授予该资源的匹配列表范围(例如,workflow:read授予workflow:list)。 - 授予
workflow:publish也授予workflow:unpublish。
工作流程范围
workflow:create- 创建新的工作流程workflow:read- 查看工作流程详细信息workflow:update- 编辑工作流程workflow:execute- 执行工作流程workflow:publish- 发布工作流程(还授予workflow:unpublish)workflow:delete- 删除工作流程workflow:move- 在项目之间传输工作流程workflow:enableRedaction- 打开工作流程的数据编辑(请参阅执行数据编辑)workflow:disableRedaction- 关闭工作流程的数据编辑(请参阅执行数据编辑)
凭证范围
credential:create- 创建新凭证credential:read- 查看凭证详细信息credential:update- 编辑凭据credential:delete- 删除凭据credential:move- 在项目之间传输凭证credential:share- 与其他用户共享凭证credential:unshare- 删除凭证共享
项目范围
project:read- 查看项目详细信息project:update- 编辑项目设置project:delete- 删除项目
文件夹范围
folder:create- 创建新文件夹folder:read- 查看文件夹内容folder:update- 重命名文件夹folder:delete- 删除文件夹folder:move- 传输文件夹
执行范围
execution:reveal- 显示编辑的执行数据(请参阅执行数据编辑)
秘密保险库范围
提示
Feature availability 功能可用性
秘密保管库范围从 n8n 2.13.0 起可用。
范围代码使用 externalSecretsProvider 前缀。角色编辑器将此部分列为 Secrets vaults 秘密金库。
externalSecretsProvider:create- 在项目中创建新的密钥保管库externalSecretsProvider:read- 查看项目中的密钥保管库externalSecretsProvider:update- 编辑密钥保管库配置externalSecretsProvider:delete- 从项目中删除密钥保管库externalSecretsProvider:sync- 重新加载保管库的密钥
秘密范围
范围代码使用 externalSecret 前缀。角色编辑器将此部分列为 Secrets 秘密。
externalSecret:list- 在凭据中使用密钥
数据表范围
dataTable:create- 创建新数据表dataTable:read- 查看数据表架构dataTable:update- 编辑数据表架构dataTable:delete- 删除数据表dataTable:readRow- 从数据表中读取行dataTable:writeRow- 在数据表中插入或更新行
项目变量范围
projectVariable:create- 创建新变量projectVariable:read- 查看变量值projectVariable:update- 编辑变量值projectVariable:delete- 删除变量
源代码控制范围
sourceControl:push- 将更改推送到源代码控制
常用自定义角色示例
以下是一些常见用例的自定义项目角色示例。请记住,这些角色只在单个项目内生效,而不是整个 n8n 实例范围。
工作流程开发人员
仅使用工作流程的用户的角色:
* workflow:create、workflow:read、workflow:update、workflow:execute、workflow:delete
* credential:read(查看凭据但不能编辑它们)
* project:read
凭证管理器
管理凭据的用户的角色:
* credential:create、credential:read、credential:update、credential:delete、credential:share
* workflow:read(查看工作流程以了解凭证的使用情况)
* project:read
秘密用户
在凭证中使用外部机密但不管理保管库的用户的角色:
* externalSecret:list(在凭证表达式中使用秘密)
* credential:create、credential:read、credential:update(使用秘密管理凭证)
* workflow:read
* project:read
工作流程发布者
可以在没有完全编辑权限的情况下发布工作流程的用户的角色:
* workflow:read、workflow:publish
* credential:read
* project:read
提示
Combining scopes 组合范围
您可以组合任何范围来创建符合您特定需求的角色。考虑最小权限原则:仅授予用户执行任务所需的权限。