WeCom 同步器

该WeCom同步器会将您企业微信组织中的用户导入Casdoor。它使用WeCom API从所有部门获取用户，并保持数据同步。

配置

必填字段：

• 组织：将导入用户的Casdoor组织
• 名称: 此同步器的唯一名称
• 类型: 选择“企业微信”
• 类型: 选择“企业微信”
• 企业密钥：您的WeCom应用的密钥

设置步骤

步骤1：获取WeCom凭据

在企业微信管理后台进入 My Company，在 Company Information 中获取 Corp ID。

在您的自建应用中获取应用密钥（企业密钥）。

或者，在联系人管理工具的同步功能中，您可以获取联系人同步密钥以进行高级配置。

步骤2：在Casdoor中配置同步器

转到同步器选项卡，选择企业微信类型并填写所需信息：

• 在企业 ID 字段中输入您的企业微信企业 ID
• 在 Corp Secret 字段中填写应用的 Secret（App secret）

然后保存更改。

点击测试连接以在启用同步器之前验证您的凭据。

字段映射

同步器会自动将WeCom用户字段映射到Casdoor用户字段：

WeCom字段	Casdoor字段	描述
userid	Id	用户的唯一标识符
name	DisplayName	用户显示名称
电子邮件	邮箱	电子邮件地址
手机	电话	电话号码
头像	头像	个人资料图片URL
position	职称	职位名称
性别	性别	性别（1=男，2=女）
status/enable	是否禁止	账户状态

同步器会根据WeCom的状态和启用字段自动处理用户账户状态：

• 已激活用户（状态=1，启用=1）：正常Casdoor用户
• 已禁用、未激活或已退出的用户（状态=2/4/5 或启用=0）：在Casdoor中被标记为禁止

OAuth登录绑定

从企业微信同步过来的用户，其企业微信 userid 保存在 Casdoor 用户的 wecom 字段中。这意味着，同步的用户可以直接通过WeCom OAuth提供商登录，无需单独的账号链接步骤——同步时设置的提供商ID将用于在登录时匹配OAuth身份。

运行同步器

配置完成后，您可以：

• 启用已启用以允许按计划自动同步
• 使用同步按钮手动触发同步
• 同步器将从所有部门获取用户并自动去重