文档中心

智能体身份和权限管理平台

用户池用户

外部身份与账号关联

外部身份把 Identity 用户记录与上游身份提供方中的用户身份连接起来。当某个人需要通过企业或第三方身份提供方登录，但仍然要在 UserPool 内拥有稳定用户记录时，可以使用外部身份。

能力

直接创建外部身份用户

管理员可以在创建用户时同时提供外部身份提供方连接和上游用户标识，让该用户成为外部提供方托管的身份。这适合迁移、预创建账号或批量入职场景。

批量创建外部身份用户

批量创建和 CSV 导入也可以创建外部身份用户。当大量上游用户需要在首次登录前先出现在 UserPool 中时，可以使用这类方式。

将外部身份关联到已有用户

管理员可以把上游身份关联到已有 Identity 用户。这样同一个用户记录可以作为账号锚点，同时接受来自已配置外部提供方的登录。

禁用用户的外部身份

当某个上游账号不应再作为该 Identity 用户登录时，管理员可以禁用或移除这条外部身份关联。

查看已关联外部身份

用户详情响应会包含外部身份信息，管理员可以据此确认某个用户已经关联了哪些上游身份。

外部身份 API

API	使用场景	说明
CreateUser	创建单个外部身份用户	当请求中包含提供方连接和外部用户标识时，可以创建由外部身份提供方托管的用户。
CreateUsers	批量创建外部身份用户	批量创建多个用户，并可使用外部提供方连接创建外部身份。
CreateUsersCSV	导入外部身份用户	通过 CSV 导入用户；当导入数据包含外部标识和连接上下文时，可以创建外部身份用户。
LinkIdentityProviderToUser	关联外部身份	将上游提供方身份关联到已有 Identity 用户。这是当前管理面中用于管理员主动关联外部身份的 API 名称。
DisableIdentityProviderForUser	禁用外部身份	禁用或移除用户上的外部身份关联。这是当前管理面中用于管理员主动解绑的 API 名称。
GetUser	查看身份关联	返回用户详情，并在可用时包含已关联外部身份。

关键 API 参数

创建外部身份用户

参数	相关能力
UserPoolUid	选择同时拥有用户和连接的 UserPool。
ExternalProviderConnectionUid	选择用于创建外部身份用户的外部提供方连接。
ExternalProviderUserIdentifier	保存上游提供方中的稳定用户标识。
标准用户字段	为 Identity 用户记录提供资料、标识和自定义属性值。

账号关联和解绑

参数	相关能力
UserUid	选择要新增或移除外部身份关联的 Identity 用户。
ConnectionUid	选择外部身份提供方连接。
ExternalProviderUserIdentifier	标识要关联或禁用的上游用户身份。

查看和排障

下一步

最近更新时间：2026.08.24 15:13:49

这个页面对您有帮助吗？

有用

无用