n8n 中文文档

轻量级目录访问协议 (LDAP)

提示

Feature availability 功能可用性

LDAP 适用于:

  • n8n Cloud: Enterprise
  • Self-hosted: Business、Enterprise

您需要访问 n8n 实例所有者帐户。

本页告诉您如何在 n8n 中启用 LDAP。它假设您熟悉 LDAP,并且已经设置了现有的 LDAP 服务器。

LDAP 允许用户使用其组织凭据登录 n8n,而不是 n8n 登录。

启用 LDAP

  1. 以实例所有者身份登录 n8n。
  2. 选择 Settings 设置 Settings icon > Authentication 身份验证 > LDAP。
  3. 打开 Enable LDAP Login 启用 LDAP 登录。
  4. 使用 LDAP 服务器的详细信息填写字段。请参阅连接设置。
  5. 选择 Test connection 测试连接 检查连接设置,或选择 Save connection 保存连接 创建连接。

启用 LDAP 后,您的 LDAP 服务器上的任何人都可以登录 n8n 实例,除非您使用用户过滤器设置排除他们。

您仍然可以在设置 > 用户页面上创建非 LDAP 用户(电子邮件用户)。

连接设置

打开 Enable LDAP Login 启用 LDAP 登录 后,会显示以下字段。

字段 填写内容
LDAP Login LDAP 登录 n8n 在登录页面的用户名字段上显示的标签,用于替代 Email 电子邮件。
LDAP Server Address LDAP 服务器地址 LDAP 服务器的 IP 地址或域名。
LDAP Server Port LDAP 服务器端口 n8n 连接的端口。n8n 会预填标准 LDAP 端口 389。如果选择 TLS,请将其更改为服务器的 LDAPS 端口,默认值为 636。
Connection Security 连接安全性 None 无、TLS 或 STARTTLS。TLS 使用 ldaps:// 连接。None 无和 STARTTLS 使用 ldap:// 连接,之后 STARTTLS 会将该连接升级为 TLS。
Ignore SSL/TLS Issues 忽略 SSL/TLS 问题 即使证书检查失败也进行连接。此字段仅在 Connection Security 连接安全性不是 None 无时显示。
Base DN 基础 DN n8n 在目录树中开始查找用户的位置,例如 o=acme,dc=example,dc=com。
Binding as 绑定方式 Admin 或 Anonymous。请参阅绑定方法。
Binding DN 绑定 DN n8n 用于搜索目录的账户,例如 uid=2da2de69435c,ou=Users,o=Acme,dc=com。此字段仅在 Binding as 绑定方式为 Admin 时显示。
Binding Password 绑定密码 Binding DN 绑定 DN 用户的密码。此字段仅在 Binding as 绑定方式为 Admin 时显示。
User Filter 用户过滤器 限制哪些用户可以登录的 LDAP 查询,例如 (ObjectClass=user)。只有此查询返回的用户才能登录。

接下来是 Attribute mapping 属性映射字段。它们告诉 n8n,要读取哪些 LDAP 属性作为用户 ID、登录 ID、电子邮件、名字和姓氏。正确的值取决于你的目录,n8n 在这些字段中显示的示例并不适用于所有服务器。请使用 ldapsearch 等工具查询 LDAP 服务器,然后查看输出中的一个用户条目。记下保存这五个值的属性名称,并将这些名称输入映射字段。

最后是同步字段。只有打开 Enable periodic LDAP synchronization 启用定期 LDAP 同步后,它们才会显示。

Enforce Email Uniqueness 强制电子邮件唯一性位于表单底部的同步字段下方。当多个 LDAP 账户使用同一个电子邮件地址时,它会阻止登录。

绑定方法

n8n 使用简单绑定连接 LDAP 服务器。Binding as 绑定方式用于设置连接方式:

  • Admin:n8n 使用你输入的 Binding DN 绑定 DN 和 Binding Password 绑定密码进行绑定。
  • Anonymous:n8n 发送空的 DN 和密码,因此服务器必须允许匿名搜索。

n8n 不支持 SASL 绑定,包括 GSSAPI 和 Kerberos。界面中没有用于 SASL 机制、keytab 或 Kerberos ticket cache 的字段。如果你的目录要求基于 Kerberos 的绑定(这在 Active Directory 设置中很常见),则无法使用 LDAP 登录。n8n 还支持使用 SAML 和 OIDC 进行单点登录。

合并 n8n 和 LDAP 帐户

如果 n8n 为电子邮件用户和 LDAP 用户找到匹配的账户(匹配的电子邮件),用户必须使用其 LDAP 账户登录。n8n 实例所有者账户不受此影响:n8n 从不将所有者账户转换为 LDAP 用户。

n8n 中的 LDAP 用户帐户

首次登录时,n8n 会在 n8n 中为 LDAP 用户创建用户账户。

您必须在 LDAP 服务器上管理用户详细信息,而不是在 n8n 中。如果您在 LDAP 服务器上更新或删除用户,n8n 账户会在下次计划同步时或用户下次尝试登录时更新,以先发生者为准。

提示

User deletion 用户删除

如果您从 LDAP 服务器中删除用户,他们将在下次同步时失去 n8n 访问权限。

关闭 LDAP

要关闭 LDAP:

  1. 以实例所有者身份登录 n8n。
  2. 选择 Settings 设置 Settings icon > Authentication 身份验证 > LDAP。
  3. 关闭 Enable LDAP Login 启用 LDAP 登录。

如果您关闭 LDAP,n8n 会在现有 LDAP 用户下次登录时将其转换为电子邮件用户。用户必须重置其密码。

相关资源

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