钉钉微应用免登实现

　　用户在使用软件应用的过程中，第一步往往都是登录。输入账号密码，进行登录，登录的目的就是让应用识别张三是张三，而不是李四。相对应，如果能够不用输账号密码，应用就知道你是你，就叫做免登。
　　免登的源头还是需要登录的。业内企业内部登录往往采用统一登录中心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查找用户，返回用户信息。至此，微应用免登就实现完毕，是不是很简单呢。觉得简单就点个赞留个言吧，有问题欢迎联系笔者共同探讨。