使用企业身份协议

更新时间:
复制 MD 格式

AgentCore 的企业身份协议用于将企业已有的身份体系接入 AgentCore:企业可以使用 SAML 单点登录认证用户身份,并通过 SCIM 用户同步将用户和用户组从企业身份提供商(IdP)同步至 AgentCore。本文介绍如何在 AgentCore 控制台完成这两项服务的初始化与配置。

了解企业身份协议

在 AgentCore 控制台左侧,选择账号集成,在企业身份协议分组中可以查看以下服务:

服务

协议

状态

SAML 单点登录

SAML 2.0

未初始化时显示未配置

OIDC 单点登录

OpenID Connect

即将推出,暂不支持配置

SCIM 用户同步

SCIM 2.0

未初始化时显示未配置

OIDC 单点登录尚未开放配置,本文介绍 SAML 单点登录与 SCIM 用户同步的控制台侧配置操作。SAML 单点登录负责认证用户身份,初始化生成的 SP Entity ID、ACS URL 和 Metadata 用于 IdP 侧的 SSO 集成配置;SCIM 用户同步负责将用户和用户组从 IdP 同步至 AgentCore,启用同步前需在 IdP 侧配置 Base URL 和 Token。

整体配置顺序为:

  1. 在 AgentCore 控制台分别初始化 SAML 与 SCIM。

  2. 创建 SCIM Token。

  3. 在企业 IdP 侧完成 SSO 集成配置以及 Base URL、Token 配置。

  4. 确认 IdP 已完成配置后,启用 SCIM 同步。

前提条件

  • 企业已具备可用的 IdP,且能够在其管理端完成 SSO 集成与 SCIM 同步配置。

  • 已登录 AgentCore 控制台。

初始化 SAML

初始化 SAML 会创建共享企业身份池。

  1. 在 AgentCore 控制台左侧,选择账号集成。

  2. 在企业身份协议分组中,选择SAML 单点登录。

  3. 在详情页的初始化 SAML卡片中,单击初始化 SAML。

    结果:初始化完成后,系统创建共享企业身份池,并生成权威的 SP Entity ID、ACS URL 和 Metadata。

说明

此操作不会自动开启登录。

配置 SCIM 用户同步

SCIM 用户同步负责将用户和用户组从 IdP 同步至 AgentCore。控制台侧依次完成初始化 SCIM、创建 SCIM Token、启用 SCIM 同步;其中启用同步前,需先在 IdP 侧完成 Base URL 和 Token 配置(IdP 侧配置说明见“后续步骤”)。

初始化 SCIM

  1. 在 AgentCore 控制台左侧,选择账号集成。

  2. 在企业身份协议分组中,选择SCIM 用户同步。

  3. 在SCIM 接收配置区域,单击初始化 SCIM。

    结果:SCIM 接收配置初始化完成,Base URL 和一次性 Token 需配置到企业 IdP。

说明

初始化 SCIM 为准备操作,不会自动开启本地同步。

创建 SCIM Token

SCIM Token 与 Base URL 一起用于企业 IdP 侧的配置。

  1. 在SCIM 用户同步页面,找到SCIM Token 区域。同步池中尚无 Token 时,该区域显示暂无 Token。

  2. 单击+ 创建 Token。

  3. 立即复制页面展示的 Token 并妥善保存。

    结果:Token 创建成功,展示在SCIM Token 区域中。

重要

Token 只在创建时展示一次,未及时保存只能重新创建。同一同步池最多可有 2 个 Token。

启用或停用 SCIM 同步

启用同步前,必须确认 IdP 已完成 Base URL 和 Token 配置。

  1. 在SCIM 用户同步页面,找到启用 SCIM 同步区域。

  2. 打开启用 SCIM 同步开关开启同步;如需停用,关闭同一开关。

    结果:开启后,用户和用户组开始从 IdP 同步至 AgentCore。

说明

停用同步不会删除用户或 Token。

配置通讯录同步范围

通讯录同步范围(选择性同步)用于圈选需要同步的通讯录范围,仅范围内的账号进入 Workspace 用户池。适用于大型组织仅在部分部门或团队中试点 AgentCore,或需要满足账号最小化合规要求、仅同步与平台使用相关人员的场景。同步范围按维度圈选,每次只能选择一个维度:

维度

选择方式

支持情况

按部门

在部门树中勾选一个或多个部门

支持

按用户组

在列表中搜索并多选用户组

即将支持

按指定用户

在列表中搜索并多选用户

即将支持

配置同步范围

  1. 在 AgentCore 控制台左侧,选择账号集成,进入已连接集成的详情页。

  2. 在通讯录同步卡片中,打开同步开关。开启后,页面自动展开同步范围区块。

  3. 在同步范围区块,选择同步维度,例如按部门。

  4. 在部门树中勾选需要同步的部门。

  5. 查看页面显示的将同步约 N 名用户预览。该人数包含所选部门下子部门的成员,为估算值。

  6. 单击保存并同步。

    结果:系统保存同步范围,并按该范围触发一次全量对齐。仅范围内的账号进入 Workspace 用户池。

说明

配置同步范围时,需注意以下事项:

  • 打开同步开关后不会立即开始同步。单击保存并同步后,系统先保存同步范围,再开启同步并触发首次同步,即先配置同步范围、后开启同步。

  • 新建集成时必须配置同步范围,系统不会默认同步整个通讯录。存量集成升级后,默认同步范围为全量,同步行为与升级前一致。

  • 选择的维度下未勾选任何对象时无法保存,页面提示请至少选择一个同步范围。

  • 存在未保存的修改时,通讯录同步卡片顶部会持续显示当前配置有未保存的修改。

修改同步范围

  • 调整已选对象后,单击保存并同步。范围变更保存后立即生效,系统按新范围执行全量对齐。

  • 已选范围不为空时切换维度,系统弹出确认框,提示切换维度将清空当前已选范围,保存后按新维度全量对齐,移出用户将被禁用。确认后已选范围被清空,需按新维度重新选择并保存;取消则保留当前已选范围。

  • 同步范围保存后,日常的组织架构变更由增量同步自动处理,无需人工维护同步范围。

部门权限不足

如果 IdP 应用未授予读取部门等所需权限,拉取部门树时页面会提示权限不足,并引导管理员前往 IdP 开放平台补充权限。