Okta Workforce Identity SAML 设置
在 n8n 中使用 Okta 设置 SAML SSO。
提示
Workforce Identity and Customer Identity 劳动力身份和客户身份
本指南涵盖设置员工身份。这是原始的 Okta 产品。客户身份是 Okta 为 Auth0 命名的名称,他们已获得该名称。
先决条件
您需要一个 Okta Workforce Identity 账户,以及来自 n8n SAML 设置的重定向 URL 和实体 ID。
Okta Workforce 可能会根据您的 Okta 配置为用户强制执行双因素认证。
首先阅读设置 SAML 指南。
设置
除以下说明外,还可以参考这份可视化分步指南,了解如何在 n8n 中使用 Okta 设置 SAML:
使用 Okta 设置 SAML 的可视化分步指南
- 在你的 Okta 管理面板中,选择应用程序 > 应用程序。
- 选择创建应用程序集成。Okta 打开应用程序创建模态框。
- 选择 SAML 2.0,然后选择下一步。
- 在常规设置选项卡上,输入
n8n作为应用程序名称。 - 选择下一步。
- 在配置 SAML 选项卡上,完成以下常规字段:
- 单点登录 URL:来自 n8n 的重定向 URL。
- 受众 URI (SP 实体 ID):来自 n8n 的实体 ID。
- 默认 RelayState:保留为空。
- 名称 ID 格式:
EmailAddress。 - 应用程序用户名:
Okta username。 - 更新应用程序用户名于:
Create and update。
-
创建属性声明:
名称 名称格式 值 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/firstnameURI 参考 用户.名字 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/lastnameURI 参考 用户.姓氏 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upnURI 参考 用户登录 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddressURI 参考 用户.电子邮件 -
选择 Next 下一步。Okta 可能会提示你完成营销表单,或可能直接将你带到新的 n8n Okta 应用程序。
- 将 n8n 应用程序分配给人员:
- 在 Okta 中的 n8n 应用程序仪表板上,选择 Assignments 分配。
- 选择 Assign 分配 > Assign to People 分配给人员。Okta 显示一个包含可用人员列表的模态框。
- 在要添加的人员旁边选择 Assign 分配。Okta 显示确认用户名的提示。
- 将用户名保留为电子邮件地址。选择 Save and Go Back 保存并返回。
- 选择 Done 完成。
- 获取 metadata XML:在 Sign On 登录选项卡上,复制 Metadata URL。导航到它,并复制 XML。将其粘贴到 n8n 中的 Identity Provider Settings 身份提供商设置中。
- 选择 Save settings 保存设置。
- 选择 Test settings 测试设置。n8n 打开一个新标签页。如果你当前未登录,Okta 会提示你登录。然后 n8n 显示一条成功消息,确认 Okta 返回的属性。
实例和项目访问配置
n8n 支持通过 SSO 配置实例角色和项目角色的两种方式。请根据你希望将映射逻辑放在哪里来选择:
- Map rules on your IdP 在您的 IdP 上映射规则:在 Okta 中配置 n8n 特定的属性(
n8n_instance_role和n8n_projects),n8n 直接从 SAML 响应中读取它们。步骤如下。 - Map rules inside n8n n8n 内的映射规则:从 Okta 发送组成员身份作为 SAML 属性,并在 n8n 内定义映射表达式。除了组属性之外,Okta 中不需要特定于 n8n 的配置。请参阅 SAML 设置主页面上的 n8n 内部映射规则。
在 n8n 中,将 Role assignment 设置为 Instance roles via SSO 或 Instance and project roles via SSO,然后选择你偏好的 Role mapping method。
IdP 上的映射规则
添加所需属性
- 在你的 Okta 管理面板中,选择 Applications 应用程序 > Applications 应用程序。
- 转到你的 n8n 应用程序的配置
- 在 General 常规选项卡上,点击 SAML Settings SAML 设置旁边的 Edit 编辑
- 在打开的页面中,继续执行步骤 2:Configure SAML 配置 SAML
-
添加以下两个 Attribute Statements 属性声明:
Name 名称 Name format 名称格式 Value 值 n8n_instance_role n8n_instance_role 基本 n8n_项目 基本 appuser.n8n_projects -
点击 Next 下一步
- 点击 Finish 完成
更新应用程序配置文件
- 在你的 Okta 管理面板中,选择 Directory 目录 > Profile Editor 配置文件编辑器。
- 转到你的 n8n 应用程序的配置文件
- 点击 Add Attribute 添加属性
- 添加 n8n_instance_role 属性
- Data type 数据类型:string
- Display name 显示名称:n8n_instance_role
- Variable name 变量名称:n8n_instance_role
- Attribute type 属性类型:Group
- 添加 n8n_projects 属性
- Data type 数据类型:string array
- Display name 显示名称:n8n_projects
- Variable name 变量名称:n8n_projects
- Attribute type 属性类型:Group
- Group priority 组优先级:Combine values across groups
现在,当你转到 Directory 目录 > Groups 组并编辑分配的 n8n 应用程序时,你可以配置 n8n_instance_role 和 n8n_projects,以便在通过 SAML 登录时发送到 n8n。
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。