总体介绍

从2.4.0版本开始，集成企业微信通讯录同步，用于同步机构、用户。

通过参数管理->数据同步模式（datasync_mode）进行控制

datasync_mode=1 覆盖默认根节点

datasync_mode=2 以默认根节点为父节点

通过参数管理->三方用户默认密码（third_user_password）设置同步用户的默认密码

默认值为SmP5TgD6wuA1XCe0HGx14w==即Kingdom2022

加密方式：前端encryptECB(password, "")

模块说明

后端

源码包含在脚手架工程中，按照前面步骤构建工程即可获得。

工程结构如下：

结构说明：

• common为基础实体包
• config为配置包
• constant为常量定义包
• controller顾名思义，为API定义包
• domain为实体定义包
• enums为枚举定义包
• exception全局异常处理
• mapper为DAO层接口定义包
• schedule定时任务
• service为service层接口定义包
• utils为当前工程需要使用到的额外的工具类包
• wecom企业微信数据同步额外实体

配置说明

1、定时任务配置schedule.yml

schedule:
  token: #定时刷新token
    enable: true
    cron: '0 */30 * * * ?'
  sync: #定时同步
    enable: false
    cron: '0 0 12 * * ?'

2、企业微信配置说明wecom.yml

corpweixin:
  corpid: wwd1d2a3de966a1779 #企业id
  address:
    sToken: j3ask #通讯录回调token
    sEncodingAESKey: DV75airwGS2sCTO4ZrDBFXA2oEBQUm96yEpBtmmgMkU #通讯录回调key
  app:
    - agentid: 1000002 #应用id
      secret: XUxLncaUvjZ16DSCvc2-DdlSMj9BsFkUhGn9xvOL7UI #应用秘钥
      auth-model: 2 #授权模式  1-部门与人员的差集 2-部门集合 3-部门与人员的交集 4-人员集合

企业微信数据同步说明

管理员进入企业微信管理后台

我的企业

企业ID

管理工具

通讯录同步

回调：设置接受事件服务器

url：服务部署之后配置，需要能连外网

Token：对应wecom.yml中${corpweixin.address.sToken}

EncodingAESKey：对应wecom.yml中${corpweixin.address.sEncodingAESKey}

权限-开启手动编辑

应用管理

自建应用

获取AgentId、Secret

AgentId：对应wecom.yml中${corpweixin.app.agentid}

Secret：对应wecom.yml中${corpweixin.app.secret}

网页授权及JS-SDK

配置域名

企业可信IP

服务部署服务器IP

企业微信授权登录

补充说明

回调内容

• ​ 机构修改名称没有回调，修改上下级有回调
• ​ 用户仅修改账号，所属部门有回调