使用企业身份协议
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。
整体配置顺序为:
在 AgentCore 控制台分别初始化 SAML 与 SCIM。
创建 SCIM Token。
在企业 IdP 侧完成 SSO 集成配置以及 Base URL、Token 配置。
确认 IdP 已完成配置后,启用 SCIM 同步。
前提条件
企业已具备可用的 IdP,且能够在其管理端完成 SSO 集成与 SCIM 同步配置。
已登录 AgentCore 控制台。
初始化 SAML
初始化 SAML 会创建共享企业身份池。
在 AgentCore 控制台左侧,选择账号集成。
在企业身份协议分组中,选择SAML 单点登录。
在详情页的初始化 SAML卡片中,单击初始化 SAML。
结果:初始化完成后,系统创建共享企业身份池,并生成权威的 SP Entity ID、ACS URL 和 Metadata。
此操作不会自动开启登录。
配置 SCIM 用户同步
SCIM 用户同步负责将用户和用户组从 IdP 同步至 AgentCore。控制台侧依次完成初始化 SCIM、创建 SCIM Token、启用 SCIM 同步;其中启用同步前,需先在 IdP 侧完成 Base URL 和 Token 配置(IdP 侧配置说明见“后续步骤”)。
初始化 SCIM
在 AgentCore 控制台左侧,选择账号集成。
在企业身份协议分组中,选择SCIM 用户同步。
在SCIM 接收配置区域,单击初始化 SCIM。
结果:SCIM 接收配置初始化完成,Base URL 和一次性 Token 需配置到企业 IdP。
初始化 SCIM 为准备操作,不会自动开启本地同步。
创建 SCIM Token
SCIM Token 与 Base URL 一起用于企业 IdP 侧的配置。
在SCIM 用户同步页面,找到SCIM Token 区域。同步池中尚无 Token 时,该区域显示暂无 Token。
单击+ 创建 Token。
立即复制页面展示的 Token 并妥善保存。
结果:Token 创建成功,展示在SCIM Token 区域中。
Token 只在创建时展示一次,未及时保存只能重新创建。同一同步池最多可有 2 个 Token。
启用或停用 SCIM 同步
启用同步前,必须确认 IdP 已完成 Base URL 和 Token 配置。
在SCIM 用户同步页面,找到启用 SCIM 同步区域。
打开启用 SCIM 同步开关开启同步;如需停用,关闭同一开关。
结果:开启后,用户和用户组开始从 IdP 同步至 AgentCore。
停用同步不会删除用户或 Token。
配置通讯录同步范围
通讯录同步范围(选择性同步)用于圈选需要同步的通讯录范围,仅范围内的账号进入 Workspace 用户池。适用于大型组织仅在部分部门或团队中试点 AgentCore,或需要满足账号最小化合规要求、仅同步与平台使用相关人员的场景。同步范围按维度圈选,每次只能选择一个维度:
维度 | 选择方式 | 支持情况 |
按部门 | 在部门树中勾选一个或多个部门 | 支持 |
按用户组 | 在列表中搜索并多选用户组 | 即将支持 |
按指定用户 | 在列表中搜索并多选用户 | 即将支持 |
配置同步范围
在 AgentCore 控制台左侧,选择账号集成,进入已连接集成的详情页。
在通讯录同步卡片中,打开同步开关。开启后,页面自动展开同步范围区块。
在同步范围区块,选择同步维度,例如按部门。
在部门树中勾选需要同步的部门。
查看页面显示的将同步约 N 名用户预览。该人数包含所选部门下子部门的成员,为估算值。
单击保存并同步。
结果:系统保存同步范围,并按该范围触发一次全量对齐。仅范围内的账号进入 Workspace 用户池。
配置同步范围时,需注意以下事项:
打开同步开关后不会立即开始同步。单击保存并同步后,系统先保存同步范围,再开启同步并触发首次同步,即先配置同步范围、后开启同步。
新建集成时必须配置同步范围,系统不会默认同步整个通讯录。存量集成升级后,默认同步范围为全量,同步行为与升级前一致。
选择的维度下未勾选任何对象时无法保存,页面提示请至少选择一个同步范围。
存在未保存的修改时,通讯录同步卡片顶部会持续显示当前配置有未保存的修改。
修改同步范围
调整已选对象后,单击保存并同步。范围变更保存后立即生效,系统按新范围执行全量对齐。
已选范围不为空时切换维度,系统弹出确认框,提示切换维度将清空当前已选范围,保存后按新维度全量对齐,移出用户将被禁用。确认后已选范围被清空,需按新维度重新选择并保存;取消则保留当前已选范围。
同步范围保存后,日常的组织架构变更由增量同步自动处理,无需人工维护同步范围。
部门权限不足
如果 IdP 应用未授予读取部门等所需权限,拉取部门树时页面会提示权限不足,并引导管理员前往 IdP 开放平台补充权限。