外部身份把 Identity 用户记录与上游身份提供方中的用户身份连接起来。当某个人需要通过企业或第三方身份提供方登录，但仍然要在 UserPool 内拥有稳定用户记录时，可以使用外部身份。 ## 能力 ### 直接创建外部身份用户管理员可以在创建用户时同时提供外部身份提供方连接和上游用户标识，让该用户成为外部提供方托管的身份。这适合迁移、预创建账号或批量入职场景。 ### 批量创建外部身份用户批量创建和 CSV 导入也可以创建外部身份用户。当大量上游用户需要在首次登录前先出现在 UserPool 中时，可以使用这类方式。 ### 将外部身份关联到已有用户管理员可以把上游身份关联到已有 Identity 用户。这样同一个用户记录可以作为账号锚点，同时接受来自已配置外部提供方的登录。 ### 禁用用户的外部身份当某个上游账号不应再作为该 Identity 用户登录时，管理员可以禁用或移除这条外部身份关联。 ### 查看已关联外部身份用户详情响应会包含外部身份信息，管理员可以据此确认某个用户已经关联了哪些上游身份。 ## 外部身份 API |**API** |**使用场景** |**说明** | |---|---|---| |[CreateUser](https://api.volcengine.com/api-explorer/?action=CreateUser&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |创建单个外部身份用户 |当请求中包含提供方连接和外部用户标识时，可以创建由外部身份提供方托管的用户。 | |[CreateUsers](https://api.volcengine.com/api-explorer/?action=CreateUsers&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |批量创建外部身份用户 |批量创建多个用户，并可使用外部提供方连接创建外部身份。 | |[CreateUsersCSV](https://api.volcengine.com/api-explorer/?action=CreateUsersCSV&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |导入外部身份用户 |通过 CSV 导入用户；当导入数据包含外部标识和连接上下文时，可以创建外部身份用户。 | |[LinkIdentityProviderToUser](https://api.volcengine.com/api-explorer/?action=LinkIdentityProviderToUser&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |关联外部身份 |将上游提供方身份关联到已有 Identity 用户。这是当前管理面中用于管理员主动关联外部身份的 API 名称。 | |[DisableIdentityProviderForUser](https://api.volcengine.com/api-explorer/?action=DisableIdentityProviderForUser&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |禁用外部身份 |禁用或移除用户上的外部身份关联。这是当前管理面中用于管理员主动解绑的 API 名称。 | |[GetUser](https://api.volcengine.com/api-explorer/?action=GetUser&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |查看身份关联 |返回用户详情，并在可用时包含已关联外部身份。 | ## 关键 API 参数 ### 创建外部身份用户 |**参数** |**相关能力** | |---|---| |UserPoolUid |选择同时拥有用户和连接的 UserPool。 | |ExternalProviderConnectionUid |选择用于创建外部身份用户的外部提供方连接。 | |ExternalProviderUserIdentifier |保存上游提供方中的稳定用户标识。 | |标准用户字段 |为 Identity 用户记录提供资料、标识和自定义属性值。 | ### 账号关联和解绑 |**参数** |**相关能力** | |---|---| |UserUid |选择要新增或移除外部身份关联的 Identity 用户。 | |ConnectionUid |选择外部身份提供方连接。 | |ExternalProviderUserIdentifier |标识要关联或禁用的上游用户身份。 | ### 查看和排障 |**参数** |**相关能力** | |---|---| |ExternalIdentities |在用户详情响应中展示已经关联到该用户的外部身份。 | |Connection 或连接过滤条件 |帮助按当前身份来源或提供方关系查找用户。 | ## 下一步 * 在连接中配置上游提供方。 * 在用户中管理用户记录。 * 在连接属性映射中设计映射字段。

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