前端|钉钉微应用免登实现 json|后端

用户在使用软件应用的过程中，第一步往往都是登录。输入账号密码，进行登录，登录的目的就是让应用识别张三是张三，而不是李四。相对应，如果能够不用输账号密码，应用就知道你是你，就叫做免登。
免登的源头还是需要登录的。业内企业内部登录往往采用统一登录中心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 param = tokenService.getTokenMap(); param.put("code",code); return requestUtils.getWithUrlParam(userInfoUrl, UserInfoByCodeResponse.class, param); }

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