SSO 环境变量

信息

通过文件配置

可以为单个变量添加 _FILE 后缀，通过单独的文件提供配置。更多信息请参阅将敏感数据保存在单独的文件中。

信息

功能可用范围

单点登录可用于：

• **自托管：**商业版、企业版。

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

应用内设置步骤及身份提供商指南请参阅设置 SSO。启用机制请参阅通过环境变量管理实例设置。

启用与共享设置

变量	类型	默认值	说明
N8N_SSO_MANAGED_BY_ENV	Boolean	false	设为 true，通过环境变量管理 SSO。当值为 true 时，n8n 会在每次启动时应用 SSO 变量，并锁定对应的界面控件。
N8N_SSO_USER_ROLE_PROVISIONING	枚举字符串：disabled、instance_role、instance_and_project_roles	disabled	n8n 为通过 SSO 登录的用户配置角色的方式。disabled 不配置任何角色；instance_role 仅配置实例级角色；instance_and_project_roles 同时配置实例角色和项目角色。

OIDC

变量	类型	默认值	说明
N8N_SSO_OIDC_LOGIN_ENABLED	Boolean	false	是否启用 OIDC 登录。
N8N_SSO_OIDC_CLIENT_ID	String	-	身份提供商签发的 OIDC 客户端 ID。
N8N_SSO_OIDC_CLIENT_SECRET	String	-	身份提供商签发的 OIDC 客户端密钥。
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	-	以 XML 字符串提供的 SAML 身份提供商元数据。与 N8N_SSO_SAML_METADATA_URL 互斥，不要同时设置。
N8N_SSO_SAML_METADATA_URL	String	-	用于获取 SAML 身份提供商元数据的 URL。与 N8N_SSO_SAML_METADATA 互斥，不要同时设置。

相关资源

• 环境变量