写在前面

这里记录下,接入钉钉的相关配置,步骤等

场景:在我们公司内部开发的OA系统接入钉钉,将公司钉钉上的相关数据(组织架构和人员)同步到OA系统,并且允许OA系统钉钉扫码登陆(同时支持扫码登陆和账号/密码登陆)

特别注意的是:
钉钉开发文档2018年左右,有过调整

调整如下

获取 access_token,

之前是这样的

现在,看不到corpsecret这个字段了,获取token,更改为

一、环境/条件准备

  • 公司管理员身份,用来登录公司的钉钉管理后台,添加相关配置,允许自研项目接入
  • OA外网条件:OA部署环境
  • 钉钉接口服务部署((IP+端口)需配置外网环境)

二、管理后台配置相关

2.1、创建微应用

第一步

第二步

最后生成微应用,点击详情,如下

2.2、创建移动接入/登录

第一步

第二步

需要注意的是,这个回调地址,如下

http://外网:port/DingDingOa/callback.aspx

是在钉钉接口部署系统中实现,创建好这个之后,会有如下参数
appid,appSecret

三、开发接入

准备好以上环境后,在钉钉管理后台,总有如下的参数

还有,登录相关

3.1、常用认证

这里只是参考钉钉开发文档,具体可参考 官网 介绍
在开发文档介绍中,可支持在线调试,在线调试

这里简单截了几张示例图

3.1.1、获取凭证

3.1.2、应用授权

3.1.3、获取登陆身份

3.1.4、通讯录管理(即用户、部门、权限管理)

3.2、白名单IP相关

即外网IP