钉钉微应用怎么进入_钉钉微应用的免登录流程

最近做了个钉钉企业内部微应用的项目。记录下自己的心得。

首先根据官方文档明白免登流程

免登录的流程如上。首先我们需要拿到自己企业的corpId&＃xff0c;和corpSecret&＃xff0c;访问企业后台https://oa.dingtalk.com/index.htm#/microApp/microAppList登录后就可以拿到(当然你得有管理员权限)&＃xff0c;拿到这两个参数后&＃xff0c;通过调用钉钉的接口&＃xff0c;我们就可以拿到令牌了&＃xff0c;也就是access_Token。根据官方文档的的说明&＃xff0c;申请一个access_Token的有效时间是两个小时&＃xff0c;同时该接口对每分钟的访问量有限制&＃xff0c;所以最好请求到缓存在本地。代码如下。

function getToken(){

if(Session::has(&＃39;dingToken&＃39;)){

$accessToken &＃61; Session::get(&＃39;dingToken&＃39;);

}else{

$corpId &＃61; config(&＃39;ding.CorpId&＃39;);

$corpSecret &＃61; config(&＃39;ding.CorpSecret&＃39;);

$urlToken &＃61; "https://oapi.dingtalk.com/gettoken?corpid&＃61;$corpId&corpsecret&＃61;$corpSecret";

$resToken &＃61; apiGet($urlToken);

$resToken &＃61; json_decode($resToken,true);

$accessToken &＃61; $resToken[&＃39;access_token&＃39;];

Session::set(&＃39;dingToken&＃39;,$accessToken);

}

return $accessToken;

}

在登录前&＃xff0c;首先要在前端引入钉钉的js文件&＃xff0c;以前钉钉的js是要分pc端与移动端的&＃xff0c;引入的js也不一样&＃xff0c;pc端为前缀为dingTalkPc&＃xff0c;移动端前缀为dd。但是钉钉前不久有重新更新了开发文档&＃xff0c;将两种js合并在了一起&＃xff0c;通过传入type参数区分设备&＃xff0c;如下图代码所示。

dd.config({

agentId: "{$data[&＃39;agentId&＃39;]}", //必填&＃xff0c;微应用ID

corpId: "{$data[&＃39;corpId&＃39;]}",//必填&＃xff0c;企业ID

timeStamp: "{$data[&＃39;timeStamp&＃39;]}", //必填&＃xff0c;生成签名的时间戳

nonceStr: "{$data[&＃39;nonceStr&＃39;]}", //必填&＃xff0c;生成签名的随机串

signature: "{$data[&＃39;signature&＃39;]}", //必填&＃xff0c;签名

type:0/1, //选填。0表示微应用的jsapi,1表示服务窗的jsapi&＃xff1b;不填默认为0。该参数从dingtalk.js的0.8.3版本开始支持

jsApiList :[&＃39;runtime.info&＃39;,

&＃39;​runtime.permission.requestAuthCode&＃39;,

&＃39;device.notification.confirm&＃39;,

&＃39;device.notification.alert&＃39;,

&＃39;device.notification.prompt&＃39;,

&＃39;biz.ding.post&＃39;,

&＃39;biz.util.uploadImage&＃39;,]//必填&＃xff0c;需要使用的jsapi列表&＃xff0c;注意&＃xff1a;不要带dd。

});

js的地址我就不写了&＃xff0c;开发文档中有。上面的代码在钉钉开发文档中称之为鉴权。在钉钉的api中有部分api必须是要先进行鉴权才能调用的&＃xff0c;而有部分则不需要。为什么要说这个呢。因为有两种免登的方式&＃xff0c;一种比较简单&＃xff0c;一种比较复杂。相信你也猜到了&＃xff0c;简单的不需要鉴权&＃xff0c;而复杂的需要鉴权。这两种方式也互有利弊。

我们先来说简单的。当我们拿到access_Token后就可以进行免登了。在页面中引入钉钉的js文件后&＃xff0c;调用js中的api&＃xff0c;如下

dd.ready(function() {

dd.runtime.permission.requestAuthCode({

corpId: "corpid",onSuccess: function(result) {

{

code: &＃39;hYLK98jkf0m&＃39; //string authCode

}

},onFail: function(err) {}

});

});

这个api是不用鉴权的&＃xff0c;需要你把corpId传到前台来&＃xff0c;当页面加载完成后自动执行&＃xff0c;执行成功后会返回code码&＃xff0c;值得一提的是钉钉做了限制&＃xff0c;它的jsapi只能在钉钉应用中访问&＃xff0c;所以如果直接在浏览器中查看时没有效果的&＃xff0c;所以如果你要在电脑上调试&＃xff0c;就需要下载一个RC版的钉钉&＃xff0c;打开钉钉后&＃xff0c;在浏览器中输入http://localhost:16888/就可以在浏览器中看到控制台了&＃xff0c;手机上的话同样也有开发版的钉钉app&＃xff0c;在app设置中打开调试模式&＃xff0c;开启手机usb调试权限&＃xff0c;通过下图中google浏览器的工具来捕捉输出。

回归正题&＃xff0c;通过钉钉的jsapi拿到code&＃xff0c;code也是有过期时间的&＃xff0c;为5分钟有效时间。拿到code后将code传回后台加上access_Token访问钉钉的免登api&＃xff0c;验证成功后返回用户信息&＃xff0c;其中就有用户的唯一标识Id&＃xff0c;再使用拿到de用户Id加上access_Token访问另外一个api&＃xff0c;代码如下。

public functiongetUserInfo(){//code

$data &＃61;input();$code &＃61; $data[&＃39;code&＃39;];//Access_Token

$accessToken &＃61;getToken();//userId

$urlId &＃61; "https://oapi.dingtalk.com/user/getuserinfo?access_token&＃61;$accessToken&code&＃61;$code";$resId &＃61; apiGet($urlId);$resId &＃61; json_decode($resId,true);$userId &＃61; $resId[&＃39;userid&＃39;];//登录用户信息

$urlInfo &＃61; "https://oapi.dingtalk.com/user/get?access_token&＃61;$accessToken&userid&＃61;$userId";$resInfo &＃61; apiGet($urlInfo);$resInfo &＃61; json_decode($resInfo);$resInfo &＃61; get_object_vars($resInfo);

}

就此&＃xff0c;免登录完成了。当然这种方法也有缺陷&＃xff0c;那就是返回的用户信息比较少&＃xff0c;不是那么全面。只能拿到如下参数

如果需要更多的用户信息&＃xff0c;那我们就需要进行比较复杂的免登方式了。也就是说我们在请求用户信息前必须进行一次鉴权&＃xff0c;才能拿到更多的用户信息。回到拿到access_Token的开头&＃xff0c;我们从后端开始&＃xff0c;从一开始的流程图来看&＃xff0c;鉴权需求ticket&＃xff0c;nonceStr&＃xff0c;timeStamp&＃xff0c;signature&＃xff0c;agentId&＃xff0c;corpId这六个参数agentId和corpId是直接可以拿到的&＃xff0c;不再赘述&＃xff0c;ticket带上accessToken参数通过接口获得&＃xff0c;noceStr用于生成密钥的参数&＃xff0c;我是直接给的随机数。timeStamp当前时间戳&＃xff0c;而

signature则是上述几个参数通过一定算法得到。

function ddconfig(){//Access_Token

$accessToken &＃61;getToken();//$accessToken &＃61; "08bbf680be4f3a028aa652e75a0ad754";//ticket

$urlTicket &＃61; "https://oapi.dingtalk.com/get_jsapi_ticket?access_token&＃61;$accessToken";

$resTicket&＃61; apiGet($urlTicket,false);

$resTicket&＃61; json_decode($resTicket,true);

$ticket&＃61; $resTicket[&＃39;ticket&＃39;];//signature

$nonceStr &＃61; md5(rand(10000000,99999999));

$agentId&＃61; 181397144;

$timeStamp&＃61;time();

$url&＃61;get_current_url();

$plain&＃61; &＃39;jsapi_ticket&＃61;&＃39;. $ticket .&＃39;&noncestr&＃61;&＃39;. $nonceStr .&＃39;×tamp&＃61;&＃39;. $timeStamp .&＃39;&url&＃61;&＃39;. $url;

$signature&＃61;sha1($plain);

$corpId&＃61; config(&＃39;ding.CorpId&＃39;);

$data[&＃39;nonceStr&＃39;] &＃61;$nonceStr;

$data[&＃39;agentId&＃39;] &＃61;$agentId;

$data[&＃39;timeStamp&＃39;] &＃61;$timeStamp;

$data[&＃39;url&＃39;] &＃61;$url;

$data[&＃39;signature&＃39;] &＃61;$signature;

$data[&＃39;corpId&＃39;] &＃61;$corpId;return$data;

}

拿到这几个参数后将其返回到前端页面。首先进行钉钉鉴权&＃xff0c;代码前面已经贴过&＃xff0c;值得注意的是鉴权过程中需要初始化jsapi&＃xff0c;只有初始化了的jsapi在后面才能被调用&＃xff0c;鉴权后的过程就跟第一种方法一样&＃xff0c;拿着返回的code码&＃xff0c;请求userId和用户信息。最终可以拿到用户的完整信息。再通过与自己数据库的数据作对比就完成了免登。