在项目中使用个人凭据
你可以在自己所属的任何团队项目中使用个人凭据,无需共享它们。只有你和你共享了凭据的用户,才能使用这些凭据运行工作流。
本页介绍凭据访问级别、个人凭据在团队项目中的工作方式、当工作流使用其他人的凭据时团队成员可以看到什么,以及工作流运行代表哪位用户执行。要授予其他用户或项目访问凭据的权限,请参阅安全地共享凭据。
关键术语
- Personal credential 个人凭据: 你的个人空间中的凭据,或某人直接与你共享的凭据。
- Project credential 项目凭据: 由团队项目持有的凭据,即某人在项目中创建的凭据,或某人共享给项目的凭据。
- Acting user 执行用户: 工作流运行所代表的用户。对于手动运行,是选择 Execute 执行 的用户。对于触发的运行(调度、webhook、应用事件等),是最后发布工作流的用户。
凭据访问级别
凭据的 Sharing 共享 选项卡显示两种访问级别:
| 访问级别 | 你可以执行的操作 |
|---|---|
| Can view 可查看 | 查看凭据是否存在以及在哪里使用。你无法使用它运行或发布任何内容。 |
| Can use 可使用 | 使用凭据运行和发布工作流。你无法查看或更改其详细信息。 |
当你与某人共享凭据时,n8n 会向其授予 Can use 可使用 角色。要查看和更改凭据详细信息,你需要拥有该凭据,或拥有允许编辑所有凭据的实例角色。对于团队项目所持有的凭据,你的项目角色决定你的访问权限。
在团队项目中使用个人凭据
你可以在自己所属的任何团队项目的工作流中选择自己的个人凭据。无需先将凭据共享给项目。
当你在节点上打开凭据选择器时,n8n 会将可选凭据分组:
- Available to you 可供你使用: 你的个人凭据。
- Available in 可用于 项目名称:项目所持有的凭据,以及实例上所有人都可使用的凭据。
在你的个人空间中,第二组则显示为 Available to everyone 可供所有人使用。
在该项目中,只有你和你直接共享了凭据的用户,才能使用你的个人凭据运行工作流。其他项目成员可以看到工作流使用了该凭据,但不能使用它运行或发布工作流。要让整个项目都能使用该凭据,请将它共享给项目。
提示
Agents 仅使用项目凭据
Agents(包括 AI agents 以及 Slack 和 Microsoft Teams 集成)目前尚不支持个人凭据。它们只能使用项目所持有的凭据。
工作流使用你的凭据时,团队成员可以看到什么
无法使用你的凭据的团队成员,会在节点上看到凭据的名称和所有者,例如 Jane's Slack account。n8n 会为他们禁用 Execute 执行 和 Publish 发布。
要运行工作流,他们可以将节点切换为自己的凭据,或请你共享凭据。
工作流运行代表哪位用户执行
每次运行都代表一位用户执行,而该用户必须能够使用工作流所需的凭据。
- Manual runs 手动运行代表运行工作流的用户执行。该用户必须能够使用工作流中不由其项目持有的每个凭据。
- 已发布工作流的 Triggered runs 触发运行代表最后发布该工作流的用户执行。
项目所持有的凭据适用于该项目中的每次运行。即使发布者自身的访问权限之后发生变化,它们仍会按调度继续工作。
你无法发布使用了你无权使用的凭据的工作流。发布检查会列出阻止发布的凭据。如果工作流失去了发布者(例如发布者的账户已被删除),请重新发布,以便它代表你运行。有关发布的工作方式,请参阅保存和发布工作流。
Owner 和 Admin 的凭据访问权限
实例 Owner 和 Admin 可以查看并共享实例上的每个凭据。他们对凭据的使用权限取决于工作流所在的位置:
- 在他们自己的个人空间中: Owner 和 Admin 可以使用任何凭据。凭据的 Sharing 共享 选项卡会将他们的个人空间显示为 Can use in personal space 可在个人空间中使用。
- 在团队项目中: 如果某个成员的个人凭据没有共享给项目,则实例角色并不会让 Owner 或 Admin 获得使用权限。他们可以在节点上看到凭据,但不能使用它运行。
来自你无权使用的凭据的执行数据
如果某次执行使用了你无权使用的凭据,n8n 会向你隐藏其数据。你仍可以看到执行状态和时间。这包括从使用了该凭据的子工作流返回的数据,即使父工作流本身未使用它。通过公共 API 或 n8n MCP server 读取执行时,同样适用这些规则。