WeCom 同步器

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

配置

必填字段：

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

设置步骤

步骤1：获取WeCom凭据

在您的WeCom管理平台中，导航至我的公司, 在公司信息中获取企业ID。

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

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

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

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

• 在企业 ID 字段中输入您的企业微信企业 ID
• 在“公司密钥”字段中输入您的应用密钥（应用密钥）

然后保存更改。

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

字段映射

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

WeCom字段	Casdoor字段	描述
userid	Id	用户的唯一标识符
name	DisplayName	用户显示名称
email	Email	电子邮件地址
mobile	Phone	电话号码
avatar	Avatar	个人资料图片URL
position	Title	职位名称
gender	Gender	性别（1=男，2=女）
status/enable	IsForbidden	账户状态

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

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

OAuth登录绑定

当用户从WeCom同步时，其WeCom用户ID</code>会存储在Casdoor用户的wecom字段中。 这意味着，同步的用户可以直接通过WeCom OAuth提供商登录，无需单独的账号链接步骤——同步时设置的提供商ID将用于在登录时匹配OAuth身份。

运行同步器

配置完成后，您可以：

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