企业微信扫码登录配置原创
金蝶云社区-cosmicstudio
cosmicstudio
8人赞赏了该文章 2543次浏览 未经作者许可,禁止转载编辑于2021年08月13日 14:21:39

1.    进入企业微信管理平台,创建“自建应用”

1-2.png


2. 配置自建应用信息

2-2.png


如下图所示配置“企业微信授权登录”信息

3.png

4-2.png


3. 创建全员部门

5-2.png

创建一个全员部门,该部门需要配置在“自建应用”可见范围内,这样在该部门的成员才能进行扫码登录

一、苍穹平台企业微信配置

  1. 企业微信配置信息配置再苍穹平台,如下图所示红线标注信息需配置在苍穹

6-2.png


红框标注的信息项全部来源于企业微信中,应用信息配置刚刚上面创建应用的信息

将企业微信的“企业ID”,“企业名称”,创建的自建应用的“应用ID”,“应用密钥”,“应用名称”配置在这里,需要打开用于扫码登录开关。开启后才能构建企业微信扫码的二维码

2.  开启企业微信扫码(和数据中心绑定的)

7-2.png

开启这个开关,才会出现如下所示企业微信扫码的登录方式

8.png


二、MC平台配置

  1.  mc平台需要配置一个参数

9-2.png


名字和编码为:login.after.handle.classes

值配置为:kd.bos.login.thirdauth.app.qrcode.ScanLoginAfter

如果环境有多个集群,需要每个集群配置

10.png


进入MC 基础数据维护/环境公共项配置 菜单,在 web/prop 目录下增加名字和编码为:login.after.handle.classes

值配置为:kd.bos.login.thirdauth.app.qrcode.ScanLoginAfter

的配置项,如果没有该目录,应该可以任意目录

11-2.png


选择对应集群增加配置如下图所示

12-2.png


点击右边添加按钮(我的账号没有权限,所以看不到),添加

配置项为:login.after.handle.classes

值配置为:kd.bos.login.thirdauth.app.qrcode.ScanLoginAfter

 

三、问题排查

二维码是否显示成功取决于以下几个因素

1. “系统服务云/配置工具/单点登录/企业微信中配置的扫码应用数据是否和企业微信管理平台应用信息一致,是否开启用于扫码登录

2. 平台租户和数据中心环境是否正常

 3. 前端请求传递参数scantype是否正确

4. 你所在的网段是否能够访问企业微信api地址

是否绑定成功(企业微信扫码登录需要企业微信号和一个存在的苍穹账号绑定(企业微信的手机号目前可以不用和苍穹账号的手机号信息一致),才能进行登录)

2.1校验是否绑定成功,可以再次企业微信扫码功能测试可以最初的判断是否绑定成功

2.2绑定失败可能原因有多种,MC中未配置ScanLoginAfter,也会导致绑定失败,该原因无法在monitor日志中查看,需先排查MC是否配置了

2.3绑定是有时长的,如果扫码成功后进入登录并绑定逻辑,如果5分钟后(该时长是企业微信授权成功后回调服务端检测到未绑定,会将绑定信息缓存至redis 中,时长设置5分钟,而前端测试的话感知该时长会小于5分钟,因为有网络因素)未绑定,也会绑定失败。该失败可以再monitor中查看到(monitor中的日志只会保存3天,希望能尽快排查)


赞 8