跳至内容

设置SAML#

功能可用性

  • 企业版计划中可用。
  • 您需要访问n8n实例所有者账户才能启用和配置SAML

从版本0.225.0开始可用。

本页面介绍如何在n8n中启用SAML单点登录(SSO)。本文假设您已熟悉SAML协议。若需了解SAML工作原理及其优势,可参考SAML简明指南

启用SAML#

  1. 在n8n中,前往设置 > 单点登录
  2. Make a note of the n8n Redirect URL and Entity ID.
    1. 可选: 如果您的身份提供商(IdP)允许通过导入元数据设置SAML,请导航至实体ID URL并保存XML文件。
    2. 可选: 如果您在负载均衡器后运行n8n,请确保已配置N8N_EDITOR_BASE_URL
  3. 使用您的身份提供商(IdP)设置SAML。您需要重定向URL和实体ID。可能还需要IdP用户的电子邮件地址和姓名。
  4. After completing setup in your IdP, load the metadata XML into n8n. You can use a metadata URL or raw XML:
    1. 元数据URL: 将您身份提供商的元数据URL复制到n8n的身份提供商设置字段中。
    2. 原始XML: 从您的身份提供商(IdP)下载元数据XML,将身份提供商设置切换为XML,然后将原始XML复制到身份提供商设置中。
  5. 选择保存设置
  6. 选择测试设置来检查您的SAML配置是否正常工作。
  7. 将SAML 2.0设置为已激活

通用身份提供商设置#

配置身份提供者(IdP)的步骤因您选择的IdP而异。以下是一些常见的设置任务:

  • 在您的身份提供商(IdP)中为n8n创建一个应用。
  • 将n8n属性映射到身份提供者(IdP)属性:

    名称 名称格式 值(IdP端)
    http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress URI引用 用户邮箱
    http://schemas.xmlsoap.org/ws/2005/05/identity/claims/firstname URI引用 用户名字
    http://schemas.xmlsoap.org/ws/2005/05/identity/claims/lastname URI引用 用户姓氏
    http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn URI引用 用户邮箱

为常见身份提供商设置资源#

常见身份提供商的文档链接。

身份提供商 文档
Auth0 将Auth0配置为SAML身份提供商:手动配置SSO集成
Authentik ApplicationsSAML Provider
Azure AD 使用Azure Active Directory进行SAML认证
Keycloak 根据您的托管方式选择入门指南
Okta n8n提供了劳动力身份设置指南
PingIdentity PingOne SSO
优云智算