关键词:移动办公,O2OA扫码登录,扫码登录,快捷登录,OAuth认证

O2OA平台可以使用符合OAuth2标准的第三方认证进行平台的登录认证。本篇主要介绍如何将在O2OA中集成微信扫码登录功能。

开启钉钉扫码登录的功能前提条件是需要o2oa集成到钉钉，并且已经从钉钉同步组织和人员到o2oa服务器，方式：《集成到钉钉》

配置修改

找到o2server/config目录下的dingding.json 配置文件（如果文件不存在，可以从o2server/configSample目录拷贝一个至config目录），使用文本编辑器打开进行编辑：

{
  "enable": true,
  "corpId": "",
  "agentId": "",
  "appKey": "",
  "appSecret": "",
  "syncCron": "10 0/10 * * * ?",
  "forceSyncCron": "10 45 8,12 * * ?",
  "oapiAddress": "https://oapi.dingtalk.com",
  "messageEnable": false,
  "workUrl": "",
  "messageRedirectPortal": "",
  "scanLoginEnable": false,
  "scanLoginAppId":"",
  "scanLoginAppSecret":"",
  "###enable": "是否启用###",
  "###corpId": "钉钉corpId###",
  "###agentId": "agentId###",
  "###appKey": "应用的key,唯一标识###",
  "###appSecret": "应用的密钥###",
  "###syncCron": "组织同步cron,默认每10分钟同步一次.###",
  "###forceSyncCron": "强制拉入同步cron,默认在每天的8点和12点强制进行同步.###",
  "###oapiAddress": "oapi服务器地址###",
  "###messageEnable": "是否启用消息推送###",
  "###scanLoginEnable": "是否开启钉钉扫码登录##",
  "###scanLoginAppId": "钉钉扫码登录的AppId###",
  "###scanLoginAppSecret": "钉钉扫码登录的appSecret###"
}

这里关注最后三个参数：scanLoginEnable、scanLoginAppId、scanLoginAppSecret 。
"scanLoginEnable": "是否开启钉钉扫码登录: true | false",
"scanLoginAppId": "钉钉扫码登录的AppId",
"scanLoginAppSecret": "钉钉扫码登录的appSecret"

创建钉钉扫码登录应用

这里的scanLoginAppId和scanLoginAppSecret这两个参数需要到钉钉管理端去创建一个扫码登录的应用才能获取具体方式如下：


如上图，到钉钉开放平台，找到左边菜单中的移动应用接入->登录 ，然后点击右上角的 创建扫码登录应用授权 按钮，创建一个扫码登录的应用，成功后下面的列表中会列出应用的appId和appSecret这两个字端，把这两个字端的值对应到上面我们的配置文件中的scanLoginAppId和scanLoginAppSecret这两个参数。

创建这个应用的表单如下：


这里注意最后一个表单项 回调域名 这里要写整串地址： http://域名:端口/x_desktop/oauth.html

如上所有这些都配置好后，重启o2oa服务，在登录界面会出现钉钉扫码登录的图标，点击出现二维码，用钉钉扫码就可以登录了。