php钉钉企业微应用免登demo,钉钉微应用免登实现

用户在使用软件应用的过程中，第一步往往都是登录。输入账号密码，进行登录，登录的目的就是让应用识别张三是张三，而不是李四。相对应，如果能够不用输账号密码，应用就知道你是你，就叫做免登。

免登的源头还是需要登录的。业内企业内部登录往往采用统一登录中心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);returndingUserQueryService.getVOByUserId(response.getUserid());

}

上图后端代码展示了获取用户信息的顺序，即先解析授权码，得到用户信息，然后再去匹配用户信息，找到当前的用户。这里简化了登录的业务步骤，如果有集成鉴权，这一块是需要另写代码实现。接下来详细了解下userInfoByCodeRequest做了什么。

private String userInfoUrl = "https://oapi.dingtalk.com/user/getuserinfo?access_token={accessToken}&code={code}";

public UserInfoByCodeResponse get(String code) {

Map param =tokenService.getTokenMap();

param.put("code",code);returnrequestUtils.getWithUrlParam(userInfoUrl, UserInfoByCodeResponse.class, param);

}

如图所示，其实就是坐了个请求，请求URL关键标识为user/getuserinfo。钉钉会返回用户数据给你。钉钉返回的数据会包含userid这一数据，通过这一数据在应用从钉钉通讯录同步过来的数据中，即可定位到一位用户，这也就是下面这行代码做的事情。

dingUserQueryService.getVOByUserId(response.getUserid()

注意这行代码是完全在应用内实现的，比如笔者这里就是去数据库根据userid查找用户，返回用户信息。至此，微应用免登就实现完毕，是不是很简单呢。觉得简单就点个赞留个言吧，有问题欢迎联系笔者共同探讨。