钉钉接入步骤,2020最新指导
写在前面
这里记录下,接入钉钉的相关配置,步骤等
场景:在我们公司内部开发的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