【企业微信同步工具】（适配新企业微信接口2022.08.15）

【更新日志】

该版本【企业微信同步工具】适配企微2022.08.15的新接口，更新公告链接

https://developer.work.weixin.qq.com/document/path/96079

【业务概述】

企业微信同步工具使用场景说明：将EAS Cloud端组织及人员数据同步到企业微信端，并建立两者数据的映射关系，以实现EAS Cloud与企业微信端业务融合

【操作路径】

【集成管理】-【移动门户集成】-【企业微信同步工具】-【参数设置】、【同步数据范围设置】、【同步执行】、【日志查看】

【相关参数及配置】

PersonSensitiveDataMasking 个人敏感信息脱敏处理，同步工具相关界面所有手机号和邮箱信息是否脱敏显示。参数值为是，则脱敏显示；参数值为否，则不脱敏显示。（该参数V8.8及以上版本支持）

 【支持版本】

V 8.6.1 适用补丁号：PT168989

V8.8   适用补丁号：PT175849

【整体概述】

该版本与之前版本的使用习惯基本上是一致的，只是在参数配置界面需要多配置一个密钥（自建应用），流程上此前是通过通讯录同步实现查看和修改信息，现在需要通过自建应用查看信息，再通过通讯录同步更新人员信息。另外，手机、邮箱、地址、性别这四个字段是全量同步覆盖，不再是以前的支持同步对比，增量同步。

【操作指引】

一、      企业微信管理后台获取接口凭证

在使用企业微信同步工具前，需要建立企业微信与EAS Cloud之间的联系。该联系，通过企业微信的接口凭证来实现。

1）获取企业注册号

访问https://work.weixin.qq.com/ 企业微信管理后台，通过【我的企业】-【企业信息】路径找到【企业ID】字段，将该字段内容复制于本地待用。

2）获取自建应用接口密钥

 ① 进入应用管理，找到【应用】-【自建】，点击创建应用.支持小程序，进入创建自建应用流程

 ② 按要求填写，可见范围目前影响同步过程，需按照可支持的同步范围填写，即当前你要同步的组织范围，都框选上。

③ 填写自建应用的可信IP，进入自建应用后，在开发接口底部找到企业可信IP，并配置。此处填写的企业可信IP与通讯录同步内填写的一致。

 如在配置可信IP前需要配置域名，需要将上图可见的文件填写至域名根目录下，该根目录为eas\server\deploy\portal.ear\root.war

3）获取通讯录同步接口密钥

① 通过【管理工具】 -【通讯录同步】路径进入【通讯录同步】参数配置页面。

 ② 进入【管理工具】-【通讯录同步】，开启接口同步。。

 ③ 在通讯录同步配置页面，可见权限下已支持读取并编辑通讯录，可再开启手动编辑，以方便管理。另外在Secret下，将该模块字段复制于本地待用。企业可信IP需要填写企业网关固定IP。至此企业微信端的准备工作已完成。

通过以上3个步骤的操作，企业微信端的同步准备工作已完成。

二、在EAS Cloud 端配置同步信息

1）参数设置

用管理员administrator登录EAS Cloud网页端，进入如下图参数设置界面。菜单路径【集成管理】-【移动门户集成】-【企业微信同步工具】-【参数设置】。

①   配置同步环境参数。

将在企业微信管理后台获取接口凭证中，获取的企业ID、通讯录同步Secret、自建应用Secret 3个字段内容，填写到同步环境区域企业注册号、密钥（通讯录）、秘钥（自建应用）字段中；微信地址配置为：

https://qyapi.weixin.qq.co