WeCom 连接让 UserPool 将企业微信作为提供商专属的企业登录来源接入。

能力

绑定企业微信租户身份

配置企业微信企业和应用标识。

准备密钥和端点

提供企业微信用户查询和登录所需的密钥与端点。

处理校验和网络信息

使用返回的校验和出口信息完成企业微信侧设置。

控制用户落地

通过账号策略和映射决定企业微信身份如何进入 identity。

调试浏览器登录

在生产发布前使用共享调试流程。

WeCom 连接 API

API	使用场景	说明
ListIdentityProvidersWeCom	管理连接	管理 WeCom 连接生命周期。
CreateIdentityProviderWeCom	管理连接	管理 WeCom 连接生命周期。
GetIdentityProviderWeCom	管理连接	管理 WeCom 连接生命周期。
UpdateIdentityProviderWeCom	管理连接	管理 WeCom 连接生命周期。
DeleteIdentityProviderWeCom	管理连接	管理 WeCom 连接生命周期。
PrepareIdentityProviderSSODebug	管理连接	管理 WeCom 连接生命周期。

关键 API 参数

参数	相关能力
CorpId、AgentId、Secret	标识企业微信租户应用。
AuthorizationEndpoint、TokenEndpoint、UserEndpoint	配置企业微信登录和用户查询端点。
DetailedUserInfoEndpoint、RetrieveSensitiveUserInfoEnabled	控制是否读取更丰富的用户资料。
DomainVerifyFileName、DomainVerifyContent、OutboundEgressIps	支持可信域名和网络白名单配置。
ProviderOptions、AttributeMappings、ClaimsPropagationConfig	控制账号落地和身份数据流。

下一步

企业微信专题

本指南说明创建企业微信连接前后需要完成的提供商专属准备工作。

能力

准备企业微信应用

创建或确认企业微信企业应用，并决定哪些用户或部门可见。

收集租户和应用凭据

创建连接前，请准备企业标识、应用标识和密钥。

完成校验和网络设置

使用 identity 返回的校验材料和出口信息，在企业微信中完成可信域名和可信 IP 设置。

验证浏览器登录

登记回调地址，并在生产发布前运行共享 SSO 调试流程。

可视化引导

创建 identity 连接前后，可以按以下企业微信截图完成上游准备：创建企业应用、规划可见范围、采集凭证、配置可信域名、配置可信 IP，并登记回调地址。

企业微信 API

API	使用场景	说明
CreateIdentityProviderWeCom	创建连接	使用租户和应用设置创建企业微信连接。
UpdateIdentityProviderWeCom	更新连接	更新企业微信租户、端点、映射和策略设置。
GetIdentityProviderWeCom	查看连接	返回当前企业微信连接配置。
PrepareIdentityProviderSSODebug	调试登录	生成用于回调测试的调试授权地址。

关键 API 参数

参数	相关能力
CorpId、AgentId、Secret	标识企业微信企业应用。
DomainVerifyFileName、DomainVerifyContent	支持可信域名校验。
OutboundEgressIps	支持可信 IP 白名单配置。
AuthorizationEndpoint、TokenEndpoint、UserEndpoint、DetailedUserInfoEndpoint	配置企业微信登录和用户查询端点。
RetrieveSensitiveUserInfoEnabled	控制是否请求更丰富的用户资料。
ProviderOptions、AttributeMappings、ClaimsPropagationConfig	控制账号落地和身份数据流。

下一步