n8n 中文文档

SSO环境变量

提示

File-based configuration 基于文件的配置

您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。

提示

Feature availability 功能可用性

单点登录可用于:

  • Self-hosted: Business、Enterprise

n8n Cloud Enterprise 也支持单点登录,但不能通过本页所述的环境变量配置。

请参阅设置 SSO 了解应用内设置步骤和身份提供商指南。请参阅使用环境变量管理实例设置 了解激活模式的工作原理。

激活和共享设置

变量 类型 默认 描述
N8N_SSO_OIDC_LOGIN_ENABLED Boolean false 是否启用 OIDC 登录。
N8N_SSO_OIDC_CLIENT_ID String - 身份提供商签发的 OIDC client ID。
N8N_SSO_OIDC_CLIENT_SECRET String - 身份提供商签发的 OIDC client secret。
N8N_SSO_OIDC_DISCOVERY_ENDPOINT String - OIDC 发现端点 URL,也就是身份提供商的 .well-known/openid-configuration URL。
N8N_SSO_OIDC_PROMPT String - 可选的 OIDC prompt 参数,会随授权请求一起发送,例如 login 或 consent。
N8N_SSO_OIDC_ACR_VALUES String - 可选的 OIDC acr_values 参数。可用于请求特定的认证上下文,例如升级 MFA 流程。

OIDC

变量 类型 默认 描述
N8N_SSO_OIDC_LOGIN_ENABLED Boolean false 是否启用 OIDC 登录。
N8N_SSO_OIDC_CLIENT_ID String - 身份提供商签发的 OIDC client ID。
N8N_SSO_OIDC_CLIENT_SECRET String - 身份提供商签发的 OIDC client secret。
N8N_SSO_OIDC_DISCOVERY_ENDPOINT String - OIDC 发现端点 URL,也就是身份提供商的 .well-known/openid-configuration URL。
N8N_SSO_OIDC_PROMPT String - 可选的 OIDC prompt 参数,会随授权请求一起发送,例如 login 或 consent。
N8N_SSO_OIDC_ACR_VALUES String - 可选的 OIDC acr_values 参数。可用于请求特定的认证上下文,例如升级 MFA 流程。

SAML

变量 类型 默认 描述
N8N_SSO_SAML_LOGIN_ENABLED Boolean false 是否启用 SAML 登录。
N8N_SSO_SAML_METADATA String - SAML 身份提供商 metadata 的 XML 字符串。与 N8N_SSO_SAML_METADATA_URL 互斥,不要同时设置。
N8N_SSO_SAML_METADATA_URL String - 用于拉取 SAML 身份提供商 metadata 的 URL。与 N8N_SSO_SAML_METADATA 互斥,不要同时设置。

相关资源

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