最终用户凭证
最终用户凭证让工作流使用触发它们的用户的凭证运行,而不是使用固定凭证。项目管理员创建一个凭证作为模板,每个用户连接自己的账户。n8n 会使用每个用户已连接的账户,并保护其数据隐私。
使用固定凭证时,运行工作流的所有人都会使用同一个账户,这可能会把某个人的访问权限和数据暴露给其他人。最终用户凭证让每个用户拥有自己的连接,并隔离他们的执行数据。
提示
Feature availability 功能可用性
最终用户凭证可用于:
- n8n Cloud: Enterprise
- Self-hosted: Enterprise
提示
Preview status 预览状态
最终用户凭证处于 Preview 阶段,未来版本中可能会变化。不要在生产工作流中依赖它。
什么是最终用户凭证
创建或编辑凭证时,选择 Credential type 凭证类型:
- Fixed credential 固定凭证: 无论谁运行工作流,都使用同一个凭证。这是默认行为。
- End-user credential 最终用户凭证: 在运行时使用每个用户自己的凭证。只有该用户可以查看和使用自己的凭证。
最终用户凭证是一个模板。创建它的人只需配置一次连接,例如 Gmail 的 OAuth app 详情。每个有访问权限的用户都使用该模板连接自己的账户。每个连接属于建立连接的用户:只有他们可以使用该连接,也只有他们能看到它返回的数据。
示例
你构建了一个带手动触发器的工作流,用于从 Gmail 读取邮件并将摘要发送到 Slack。你为 Gmail 创建一个最终用户凭证作为模板。当用户 A 运行工作流时,n8n 读取用户 A 的收件箱。当用户 B 运行它时,n8n 读取用户 B 的收件箱。每个用户只能看到自己的数据。
工作原理
像往常一样,在节点上使用凭证下拉菜单选择凭证。节点上没有单独设置。节点行为取决于凭证类型:
- 使用固定凭证时,节点行为与以前相同。
- 使用最终用户凭证时,节点会显示它使用触发用户的账户,并在用户尚未连接时提示他们连接。
运行时,n8n 会将凭证解析为触发工作流的用户已连接的账户。每个拥有工作流访问权限的用户都会以自己的身份看到该节点。如果他们已连接账户,该连接会运行。如果没有,他们需要先连接再触发工作流。
你可以在同一个工作流中混用固定凭证和最终用户凭证。例如,使用最终用户凭证读取每个用户的个人 Google Calendar,但通过固定凭证使用共享的团队 Slack 账户发送结果。
要求和限制
- 仅限 Enterprise: 最终用户凭证需要 Enterprise 计划。
- 受控创建: 默认情况下,只有项目管理员可以创建最终用户凭证。可通过自定义角色将此权限授予其他用户。限制谁可以创建它们,有助于集中管理凭证:管理员一次性设置模板并共享到需要它的项目,而不是让许多用户分别设置自己的模板。
- 仅限团队项目: 只能在团队项目中创建最终用户凭证,不能在个人项目中创建。这样可确保凭证得到集中管理,由管理员设置凭证模板,而不是由各个用户在个人项目中自行创建。
- 仅支持 OAuth 凭证: 最终用户凭证只支持基于 OAuth 的凭证类型。
- 每个用户一个连接: 每个用户可为每个最终用户凭证模板连接一个账户。
- 支持的触发器: 最终用户凭证解析适用于手动触发器、Chat Hub、MCP Server Trigger、Webhook Trigger、n8n Form Trigger 和 Chat Trigger。Chat Trigger 仅支持 Hosted Chat,不支持 Embedded Chat/webhook 模式。Webhook Trigger、Form Trigger 和 Chat Trigger 使用 n8n User Auth 身份验证时会解析最终用户凭证,因此每个用户都会使用自己连接的账户运行工作流。在 Webhook 节点中,此选项名为 n8n User Auth (OAuth2)。
创建最终用户凭证
- 创建凭证,或打开现有凭证。
- 在 Credential type 凭证类型 下,选择 End-user credential 最终用户凭证。
- 配置连接。对于 OAuth 凭证,请包含 Client ID、Client Secret 和需要在服务中注册的 OAuth Redirect URL。
- 选择 Save 保存。
用户现在可以将自己的账户连接到此凭证。当用户运行使用该凭证的工作流时,如果尚未连接,n8n 会提示他们进行连接。拥有项目访问权限的用户也可以提前在 n8n UI 中连接:在画布上打开节点,或从项目的 Credentials 凭证 列表中连接。
提示
某些触发器节点(例如 MCP Server Trigger、Webhook、Chat Trigger 和 Form Trigger)可要求触发用户拥有执行触发器的权限。启用后,只有具备允许执行工作流的项目角色的用户才能触发它。没有该角色的用户无法连接自己的账户。
连接你的账户
在工作流中使用最终用户凭证之前,请先将你的账户连接到模板。你可以从以下位置连接:
- 节点:打开使用最终用户凭证的节点时,它会显示你是否已连接账户。如果没有,请选择 Connect 连接。
- 凭证:打开最终用户凭证,并在凭证弹窗中连接你的账户。
- 凭证列表:在项目的 Credentials 凭证 列表中,最终用户凭证卡片有 Connect 连接 选项。
完成你账户的 OAuth 流程。连接后,节点会显示你的账户,例如 Connected as [email protected]。
你的连接是私有的。其他用户会把自己的账户连接到同一个模板,绝不会使用你的账户。
执行数据和隐私
当工作流执行使用最终用户凭证时,拥有该工作流执行访问权限的任何人都可以看到执行元数据:状态、运行时间,以及它使用了最终用户凭证。变化的是谁可以看到其中的数据。
只有使用自己已连接账户触发工作流的用户可以看到这些节点的输入和输出数据,包括连接服务返回的数据。对其他所有人,包括实例管理员,这些节点都会显示已脱敏输出。
管理员可见性
管理员可以看到最终用户凭证模板存在,并且它附带了连接。例如,删除最终用户凭证时,管理员会看到附加了多少用户连接。这个数量是他们能看到的全部。他们不能:
- 查看单个连接的任何信息
- 查看连接的密钥
- 在自己的工作流中使用任何人的已连接账户
- 查看使用其他用户连接运行的执行中已脱敏的输出
共享方式与任何其他凭证相同,但只共享模板,而不是已连接的账户。管理员可以将其共享到其他项目或与其他用户共享,每个接收者都会连接自己的账户。
警告
删除最终用户凭证会移除所有连接
删除凭证模板会删除整个凭证,包括每个用户的连接,而不只是你自己的连接。依赖它的任何工作流都无法再为这些用户解析凭证,直到重新设置凭证并让他们重新连接。删除附带连接的最终用户凭证之前,n8n 会发出警告。
跨项目共享最终用户凭证
使用标准的凭证共享机制将最终用户凭证共享到其他项目。共享的是模板,不是某个连接。其他项目中的用户会看到连接自己账户的选项。他们不会获得原始所有者的连接。
每个用户只需为每个模板连接一次。随后,只要该模板被共享到多个项目,这一个连接都会为该用户解析,因此他们无需在每个项目中重新连接。
一种好的实践是在单个项目中创建最终用户凭证(例如 Gmail、Linear、Jira 和 Google Sheets),然后将它们共享到需要这些凭证的其他项目。每个项目都会获得同一个模板,每个用户的一次连接可在所有项目中使用。