创建和编辑凭据
凭据是安全存储的身份验证信息，用于将 n8n 工作流连接到 API、数据库等外部服务。
在 n8n Cloud 上，支持的 AI 模型和服务甚至无需配置凭据：在节点上选择 Use Gateway credits（使用 Gateway 额度），即可使用 Gateway 额度运行，而无需使用自己的 API 密钥。
创建凭据
- 选择侧边菜单左上角的
Create（创建） 按钮，再选择凭据。 - 如果 n8n 实例支持项目1，还需要选择是在个人空间中创建凭据，还是在你有权访问的某个项目中创建。使用社区版时，凭据会在个人空间中创建。
- 选择要连接的应用或服务。
或者：
- 在 Overview（概览） 页面或某个项目中，选择右上角的 Create（创建） 按钮，再选择 Credential（凭据）。
- 如果从 Overview（概览） 页面操作，凭据会创建在个人空间中；如果从项目中操作，则会创建在该项目中。
- 选择要连接的应用或服务。
在工作流编辑器中编辑节点时，也可以通过凭据下拉菜单创建新凭据。
打开凭据弹窗后，输入该服务要求的信息。配置指南请参阅凭据库中对应服务的页面。
保存凭据时，n8n 会进行测试，确认其可以正常工作。
凭据命名
n8n 默认将新凭据命名为“节点名称 account”。与重命名节点类似，可以点击名称来重命名凭据。建议使用能够标识应用或服务、类型和用途的名称。统一的命名规则有助于跟踪和识别凭据。
选择凭据类型
创建或编辑 OAuth 凭据时，可以选择 Credential type（凭据类型）：
- Fixed credential（固定凭据）：无论谁运行工作流，都使用相同凭据。这是默认行为。
- End-user credential（最终用户凭据）：运行时使用各个用户自己的凭据，且只有该用户能够查看和使用它。
最终用户凭据让工作流使用触发者的凭据运行，并确保每个用户的数据仅对其本人可见。n8n Cloud Enterprise 和自托管 Enterprise 的 OAuth 凭据提供 Fixed credential（固定凭据） 与 End-user credential（最终用户凭据） 类型选择。设置方法请参阅最终用户凭据。
允许的 HTTP 请求域名
许多面向 Web API 和服务的 n8n 凭据都包含 Allowed HTTP Request Domains（允许的 HTTP 请求域名） 字段。在 HTTP Request 节点中选择该凭据时，此字段控制允许将凭据用于哪些域名。凭据用于其专属节点时，此字段不生效。
此字段有三个选项：
- All（全部）：凭据可用于任意 URL。
- Specific Domains（指定域名）：限制为特定域名，填写以逗号分隔的列表，例如
httpbin.org, api.github.com。 - None（无）：完全禁止在 HTTP Request 节点中使用此凭据。
此字段用于防止凭据被误用，例如将凭据发送到预期域名之外的 URL。
在凭据中使用表达式
可以使用表达式2，在工作流运行时动态设置凭据：
- 在工作流中找到包含凭据的数据路径。具体路径取决于数据中的参数名称。确保运行到需要凭据的节点时，包含凭据的数据在工作流中可用。
- 创建凭据时，将鼠标悬停在要使用表达式的字段上。
- 开启 Expression（表达式）。
- 输入表达式。
示例工作流
使用示例
将模板加载到 n8n 实例的步骤如下：
- 下载工作流 JSON 文件。
- 在 n8n 实例中打开一个新工作流。
- 粘贴 JSON，或选择 Workflow menu（工作流菜单）
> Import from file...（从文件导入……）。
示例工作流使用便笺提供指引：
- 黄色：备注和信息。
- 绿色：运行工作流的说明。
- 橙色：需要修改某些内容，工作流才能正常运行。
- 蓝色：突出展示示例中的关键功能。