配置

验证

您可以通过设置用户管理（n8n 的内置身份验证功能）来保护 n8n 的安全。

n8n 支持LDAP和SAML 。

凭证覆盖

为了向用户提供 OAuth 登录，可以全局覆盖凭证。这些凭证数据对用户不可见，但后端会自动使用。

在编辑器 UI 中，n8n 默认隐藏所有被覆盖的字段。这意味着用户可以通过点击凭证上的“连接”按钮使用 OAuth 进行身份验证。

n8n 提供两种应用凭证覆盖的方法：使用环境变量和使用 REST API。

使用环境变量

您可以通过将设置为 使用环境变量来设置凭据覆盖。

使用 REST API

推荐使用自定义 REST 端点加载数据。请将 设置为此端点可用的路径。

例如：

1. 通过在 n8n 运行的环境中设置环境变量来激活端点：

   1	export CREDENTIALS_OVERWRITE_ENDPOINT=send-credentials

2. 然后需要一个包含要覆盖的凭据的 JSON 文件。例如，用于覆盖 Asana 和 GitHub 凭据的文件可能如下所示：

   1 2 3 4 5 6 7 8 9 10

   { "asanaOAuth2Api": { "clientId": "<id>", "clientSecret": "<secret>" }, "githubOAuth2Api": { "clientId": "<id>", "clientSecret": "<secret>" } }

3. 然后通过使用 curl 发送它来将其应用到实例：

   1	curl -H "Content-Type: application/json" --data @oauth-credentials.json http://localhost:5678/send-credentials

环境变量

n8n 有许多环境变量可供配置。以下是与您的托管解决方案最相关的环境变量：

后端钩子

可以定义外部钩子，n8n 会在特定操作运行时执行这些钩子。例如，您可以使用这些钩子来记录数据、更改数据，或通过抛出错误来禁止某个操作。

可用的钩子

注册钩子

通过注册包含钩子函数的钩子文件来设置钩子。要注册钩子，请设置环境变量。

您可以将变量设置为单个文件：

EXTERNAL_HOOK_FILES=/data/hook.js

或者包含用分号分隔的多个文件：

EXTERNAL_HOOK_FILES=/data/hook1.js;/data/hook2.js

后端钩子文件

钩子文件是具有以下格式的常规 JavaScript 文件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

module.exports = {
    "frontend": {
        "settings": [
            async function (settings) {
                settings.oauthCallbackUrls.oauth1 = 'https://n8n.example.com/oauth1/callback';
                settings.oauthCallbackUrls.oauth2 = 'https://n8n.example.com/oauth2/callback';
            }
        ]
    },
    "workflow": {
        "activate": [
            async function (workflowData) {
                const activeWorkflows = await this.dbCollections.Workflow.count({ active: true });

                if (activeWorkflows > 1) {
                    throw new Error(
                        'Active workflow limit reached.'
                    );
                }
            }
        ]
    }
}

后端钩子函数

一个钩子或一个钩子文件可以包含多个钩子函数，所有函数都会依次执行。

如果钩子函数的参数是对象，那么就可以改变该参数的数据来改变n8n的行为。

您还可以使用任何挂钩函数访问数据库（请参阅后端挂钩文件中的代码示例）。

前端外部钩子

与后端外部钩子类似，您可以在前端代码中定义外部钩子，当用户执行特定操作时，n8n 就会执行这些钩子。例如，您可以使用它们来记录数据和更改数据。

可用的钩子

注册钩子

您可以通过在页面上加载 hooks 脚本来设置 hooks。一种方法是在项目中创建一个 hooks 文件，并在文件中添加 script 标签：

1

<script src="frontend-hooks.js"></script>

前端钩子文件

前端外部钩子文件是常规 JavaScript 文件，具有以下格式：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

window.n8nExternalHooks = {
  nodeView: {
    mount: [
      function (store, meta) {
        // do something
      },
    ],
    createNodeActiveChanged: [
      function (store, meta) {
        // do something
      },
      function (store, meta) {
        // do something else
      },
    ],
    addNodeButton: [
      function (store, meta) {
        // do something
      },
    ],
  },
};

前端钩子函数

每个钩子可以定义多个钩子函数。每个钩子函数使用以下参数调用：

• ：Vuex 存储对象。你可以使用它来更改或获取存储中的数据。
• ：包含钩子提供的任何数据的对象。要查看传递的内容，请在包中搜索该钩子。