钉钉-使用钉钉扫码登录O2OA

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

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

创建钉钉扫码登录应用

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

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

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

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

配置修改

在钉钉集成配置中，开启钉钉扫码登录，并填写下面的两个参数，扫码登录 agentId 和扫码登录 secret：

或者找到 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"

以上配置全部完成后，重启 o2oa 服务，登录界面会出现钉钉扫码登录的图标，点击后出现二维码，用钉钉扫码即可登录。

兰德网络 O2OA 平台软件

开源、自主可控的协同办公底座

研发与运营

纵横翱途（杭州）科技有限公司

企业级协同应用 · 工作流引擎 · AI 智能体

www.o2oa.net ｜ 400-888-0545