钉钉微应用免登实现
用户在使用软件应用的过程中,第一步往往都是登录。输入账号密码,进行登录,登录的目的就是让应用识别张三是张三,而不是李四。相对应,如果能够不用输账号密码,应用就知道你是你,就叫做免登。
免登的源头还是需要登录的。业内企业内部登录往往采用统一登录中心SSO的方案,比如集成CAS。一个同一地址登录,同一域名下采用识别cookie的方式解析用户名。也就是,登录了OA之后,访问HR、邮箱等等,在关闭浏览器之前,不需要再次登录。钉应用实现免登,本质上也是通过钉钉实现登录。因为使用者已经输入账号密码或者手机号验证码在钉钉实现了登录,钉钉已经保存了用户的信息。
具体实践,实现钉应用免登可以分为下面几个步骤。
1、钉应用用户信息与钉钉通讯录打通。比如用户通过手机号实现关联。
2、前端代码,调用JSapi获取免登授权码。
3、后端代码,调用服务端接口解析授权码,实现登录。
4、后端代码,识别用户后,实现登录逻辑。
下面用后台java代码和前端vue代码来实际说明。
通讯录的同步忽略了,按照钉钉服务端接口能够实现同步。我们直接看前端的获取免登授权码该如何获取。
loginByCode(corpId) {
const _this = this;
console.log("requestAuthCode begin");
_this.dd.runtime.permission.requestAuthCode({
corpId: corpId,
onSuccess: function (result) {
console.log("requestAuthCode:" + result.code);
_this.httpUtils.appGet('/login/loginByCode?code=' + result.code).then(function (res) {
const user = res.data;
window.localStorage.setItem("user", JSON.stringify(user));
}, function (r) {
_this.commonUtils.commonAlert(r.msg);
})
},
onFail: function (err) {
alert("客户端-获取免登授权码失败:" + JSON.stringify(err));
}
})
},
上面的代码块封装了loginByCode的方法,其主要功能就是获取授权码,然后将授权码传到后台,获取用户信息。关键的代码就是
dd.runtime.permission.requestAuthCode
这一个函数需要传入一个corpId作为参数,该参数在企业后台能够找到。获取授权码失败,我们可以把错误信息弹框显示出来。获取成功,就可以请求后台的接口拉取用户信息。接下来看看后台是如何实现的。
@GetMapping("loginByCode")
public UserVO list(@RequestParam String code) {
log.info(code);
UserInfoByCodeResponse response = userInfoByCodeRequest.get(code);
return dingUserQueryService.getVOByUserId(response.getUserid());
}
上图后端代码展示了获取用户信息的顺序,即先解析授权码,得到用户信息,然后再去匹配用户信息,找到当前的用户。这里简化了登录的业务步骤,如果有集成鉴权,这一块是需要另写代码实现。接下来详细了解下userInfoByCodeRequest做了什么。
private String userInfoUrl = "https://oapi.dingtalk.com/user/getuserinfo?access_token={accessToken}&code={code}";
public UserInfoByCodeResponse get(String code) {
Map<String, Object> param = tokenService.getTokenMap();
param.put("code",code);
return requestUtils.getWithUrlParam(userInfoUrl, UserInfoByCodeResponse.class, param);
}
如图所示,其实就是做了个请求,请求URL关键标识为user/getuserinfo。钉钉会返回用户数据,且钉钉返回的数据会包含userid,通过userid这一数据在应用从钉钉通讯录同步过来的数据中,即可定位到一位用户,这也就是下面这行代码做的事情。
dingUserQueryService.getVOByUserId(response.getUserid()
注意这行代码是完全在应用内实现的,比如笔者这里就是去数据库根据userid查找用户,返回用户信息。至此,微应用免登就实现完毕,是不是很简单呢。觉得简单就点个赞留个言吧,有问题欢迎联系笔者共同探讨。