n8n 中文文档

在项目中使用个人凭据

你可以在自己所属的任何团队项目中使用个人凭据,无需共享它们。只有你和你共享了凭据的用户,才能使用这些凭据运行工作流。

本页介绍凭据访问级别、个人凭据在团队项目中的工作方式、当工作流使用其他人的凭据时团队成员可以看到什么,以及工作流运行代表哪位用户执行。要授予其他用户或项目访问凭据的权限,请参阅安全地共享凭据。

关键术语

  • 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 读取执行时,同样适用这些规则。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。