如何设置 SCIM 用户配置

预计阅读 4 分钟 | 更新于 2026年4月21日 9:56 AM EST

你将会学到

了解如何在账户或投资组合中设置跨域身份管理 (SCIM) 用户配置系统。您必须拥有付费计划并且是管理员或所有者才能设置此功能。

开始之前

在设置 SCIM 之前,您还需要在 Klaviyo 中打开 SSO。请注意,SCIM 配置通常是身份提供商 (IdP) 的附加组件。例如,除了 SSO 计划之外,IdP 通常还需要单独的 SCIM 计划。如果您在 IdP 中没有看到以下步骤,请确认您的计划正确。

打开 SCIM 用户配置

  1. 单击左下角您的组织名称。
  2. 单击设置> 安全。
帐户设置中的安全选项卡
帐户设置中的安全选项卡
  1. 选中SCIM 配置框。
  2. 复制或下载访问密钥,包括前缀“Klaviyo-API-Key”。请注意,此密钥仅显示一次,因此请确保您可以访问它。如果复制,请立即将其粘贴到安全的地方。
访问密钥示例
访问密钥示例
  1. 单击完成。
  2. 复制基本 URL 并将其粘贴到某个位置,最好是存储访问密钥的位置。接下来,您必须联系 SSO 提供商来完成该过程。此过程因提供商而异。下面,我们提供了有关 OKTA、One Login 和 Azure 的说明,尽管您可以使用任何其他提供商进行设置。 奥克塔
  1. 导航至应用程序 > 应用程序。
  2. 选择 Klaviyo 应用程序。
  3. 转到登录选项卡。
具有 SSO 的应用程序的四个选项卡:常规、登录、导入和分配
具有 SSO 的应用程序的四个选项卡:常规、登录、导入和分配
  1. 在 凭证详细信息 下,检查:
  1. 单击进入常规选项卡。
应用程序的常规选项卡,当没有配置时
应用程序的常规选项卡,当没有配置时
  1. 选择编辑。
  2. 在配置下,选择 SCIM。
选择 SCIM 进行配置
选择 SCIM 进行配置
  1. 单击保存。
  2. 单击进入配置选项卡。
  3. 选择编辑 打开SCIM 连接 页面(如下所示)。
无信息的 SCIM 连接页面
无信息的 SCIM 连接页面
  1. 在 SCIM 连接器基本 URL 中,粘贴来自 Klaviyo 的基本 URL。
  2. 对于用户的唯一标识符字段,输入“userName”。
  3. 在支持的配置操作下,选中以下复选框:
  • 导入新用户和配置文件更新
  • 推送新用户
  • 推送个人资料更新
  1. 将 身份验证模式 选项更改为 HTTP 标头。
  2. 将访问密钥粘贴到授权下。
填写完毕后 SCIM 连接的外观
填写完毕后 SCIM 连接的外观
  1. 单击测试连接器配置。
  2. 单击保存。
  3. 在“配置到应用程序”旁边,单击“编辑”。
  4. 勾选启用以下功能:
  1. 单击保存。
  2. 向下滚动到应用程序的属性映射部分。
  3. 单击转到配置文件编辑器。
  4. 单击添加属性。
Okta 中的配置文件编辑器页面顶部,显示添加属性的按钮
Okta 中的配置文件编辑器页面顶部,显示添加属性的按钮
  1. 为 显示名称、变量名称 和 外部名称 键入“角色”。
  2. 在外部命名空间中,输入以下内容:
  3. 瓮:ietf:参数:scim:模式:核心:2.0:用户

  4. 选中定义枚举值列表复选框。
角色属性的第一个必需设置
角色属性的第一个必需设置
  1. 添加角色和价值观;有效的角色值如下:
  1. 向下滚动到需要属性并选中是。
  2. 选择属性类型(个人或团体)。
  3. 建议:将用户权限保留为只读。
角色属性的其余必需设置
角色属性的其余必需设置
  1. 单击保存。
  2. 导航至应用程序 > 应用程序,然后选择您的应用程序。
  3. 单击分配。
  4. 选择是将应用程序分配给个人(即人员)还是组。
显示“分配”下拉列表的“分配”选项卡
显示“分配”下拉列表的“分配”选项卡
  1. 找到您想要为其分配 Klaviyo 的人员或组,然后单击其姓名旁边的分配。
搜索分配给应用程序的用户的示例
搜索分配给应用程序的用户的示例
  1. 向下滚动到 角色 字段并为他们分配正确的角色。
角色下拉列表,显示 Klaviyo 中角色的所有值
角色下拉列表,显示 Klaviyo 中角色的所有值
  1. 单击保存并返回。 一次登录
  1. 在管理门户中,单击应用程序。
  2. 单击添加应用程序。
  3. 搜索“Klaviyo”。
  4. 单击Klaviyo 添加它。
  5. 可选:重命名连接。
  6. 单击配置。
  7. 在 SCIM 承载令牌 字段中,粘贴您的 SCIM 访问密钥。
  8. 单击“API 连接”下的“启用”。
  9. 单击保存。
  10. 转到左侧边栏中的配置。
  11. 选中启用配置框。
  12. 不要取消选中创建用户、删除用户或更新用户框。
具有正确设置的凭据详细信息部分
具有正确设置的凭据详细信息部分
  1. 建议:在 当在 OneLogin 中删除用户或删除用户的应用程序访问权限时,请执行以下操作 的下拉列表中选择 删除。
  2. 单击保存。 Microsoft Entra ID(以前称为 Azure AD)
  1. 登录Microsoft Entra ID。
  2. 单击Microsoft Entra ID(以前称为“Azure Active Directory”)
  3. 单击左侧的企业应用程序。
左侧边栏中的企业应用程序选项
左侧边栏中的企业应用程序选项
  1. 选择您的应用程序。 – 如果您尚未创建应用程序,请按照 SSO 指南 中的步骤操作。
  2. 单击左侧的配置,然后选择开始。
突出显示“配置”时应用程序的左侧边栏
突出显示“配置”时应用程序的左侧边栏
  1. 在名为 配置模式 的字段中,选择 自动。
将配置模式更改为自动
将配置模式更改为自动
  1. 转至 管理员凭据。
  2. 将 Klaviyo 中的 SCIM 基本 URL 粘贴到 租户 URL 字段中。
  3. 将 SCIM API 密钥粘贴到 秘密令牌 字段中。请注意,粘贴此令牌时应不带任何前缀(例如,不包含“Bearer”或“Klaviyo-API-Key”)。
  4. 测试连接。 11.连接成功后,点击左上角的保存。
  5. 在同一页面中,向下滚动并打开 Mappings 下拉列表。
映射下拉列表以配置(按顺序)Azure AD 组或用户
映射下拉列表以配置(按顺序)Azure AD 组或用户
  1. 选择配置 Azure Active Directory 用户。
  2. 可选:删除不支持的属性。请注意,Klaviyo 仅支持 SCIM 的 customappsso Attribute 列中的以下属性:
  • “用户名”
  • “活跃”
  • 电子邮件[类型 eq“工作”].value’
  • “名字.givenName”
  • “姓名.家庭名称”
  • emails[primary eq “True”].value’
  • 角色[primary eq “True”].value’
  • SingleAppRoleAssignment([appRoleAssignments])
  • 不支持appRoleAssignments
  1. 单击保存,然后单击主页。
  2. 导航回Microsoft Entra ID > 企业应用程序 > Klaviyo > 配置。
  3. 选择开始配置。
配置选项卡,显示开始配置按钮
配置选项卡,显示开始配置按钮