springboot实现第三方钉钉扫码登录
本篇博客主要作为本人的日记，如果各位博友对以下内容有所疑问欢迎留言探讨。
一、准备工作
1、钉钉开放平台注册登录：
登录地址：https://open.dingtalk.com/
2、注册登录成功后选择你加入的组织
3、创建应用
4、相关权限开通（权限开通都是免费） 
5、设置扫描成功后的回调域名
如果开发者没有域名可以随便写一个域名，在本地host中配置对应的域名即可
6、本地host文件配置域名
host文件路径为：C:\Windows\System32\drivers\etc\host，打开host文件添加以上输入的回调域名，本人写的回调地址为“www.chenyuanbo.com”,配置如下所示：
7、开发环境下配置好内网穿透
(1)登录natApp官网注册;https://natapp.cn/，在右上角点击“客户端下载”，下载对应的natApp客户端，登录成功后的界面如下，authToken用于启动natApp
（2）启动内网穿透
打开下载好的natApp,运行natapp.exe,输入命令：natapp -authtoken="NatApp的隧道authtoken"，出现以下界面说明内网穿透启动已成功
二、功能实现思路：
1、获取钉钉二维码界面（即下方：dingdingLogin方法）
2、扫二维码成功后进入回调方法，获取code。
3、请求获取accessToken
4、根据code和accessToken获取用户信息（含用户openId）
5、根据用户openId去自己系统的用户表中查询是否存在对应的用户，如果存在则登录成功，跳转至系统首页
三、功能开发
1、maven坐标：
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>dingtalk</artifactId>
<version>1.2.43</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>alibaba-dingtalk-service-sdk</artifactId>
<version>2.0.0</version>
</dependency>
2、具体代码实现
package com.cyb.sso.server.controller; import com.dingtalk.api.DefaultDingTalkClient; import com.dingtalk.api.DingTalkClient; import com.dingtalk.api.request.OapiGettokenRequest; import com.dingtalk.api.request.OapiSnsGetuserinfoBycodeRequest; import com.dingtalk.api.response.OapiGettokenResponse; import com.dingtalk.api.response.OapiSnsGetuserinfoBycodeResponse; import lombok.extern.slf4j.Slf4j; import org.apache.commons.lang3.StringUtils; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.ResponseBody; /** *@ClassName UnionLoginController *@Description 联合登录控制层 *@Author cyb *@Date 2022/1/25 23:06 */ @Controller @RequestMapping("/unionLogin") @Slf4j public class UnionLoginController { /*** * 钉钉APPKey或SuiteKey */ private static final String DING_TALK_APP_ID="dingrd9jvv0i2z0eu62q"; /*** * 钉钉SuiteSecret或appSecret */ private static final String DING_TALK_SECRET ="HkOsehRYCwhJBg-nChBGdxAg2eoLA9A3T1ykbR1kR4HU5XzrO_D79s8Y6BJ-Pjzy"; /*** * 钉钉扫码后回调地址 * http://www.chenyuanbo.com:8080/xxl-sso-server/unionLogin/dingdingCallback */ private static final String DING_TALK_CALL_BACK_URL = "http%3A%2F%2Fwww.chenyuanbo.com%3A8080%2Fxxl-sso-server%2FunionLogin%2FdingdingCallback"; /*** * 获取accessToken请求URL */ private static final String getTokenUrl ="https://oapi.dingtalk.com/gettoken"; /*** * 获取用户详情URL */ private static final String getUserInfoUrl= "：https://oapi.dingtalk.com/sns/getuserinfo_bycode"; /*** * 获取钉钉联合登录二维码 * @return 钉钉二维码 */ @ResponseBody @RequestMapping("/dingdingLogin") public Object dingdingLogin() { String time = String.valueOf(System.currentTimeMillis());//产生一个当前的毫秒 StringBuilder stringBuilder = new StringBuilder(); String result=""; stringBuilder .append("https://oapi.dingtalk.com/connect/qrconnect?appid=") .append(DING_TALK_APP_ID)//APP_ID .append("&response_type=") .append("code")//code .append("&scope=") .append("snsapi_login")//snsapi_login .append("&state=") .append(time) .append("&redirect_uri=") .append(DING_TALK_CALL_BACK_URL);//回调地址 try { result = stringBuilder.toString(); } catch (Exception e) { System.out.println(e.getMessage()); } return result; } /*** * 扫码后的回调方法 * @param code 钉钉扫码返回的code * @return */ @RequestMapping(value="/dingdingCallback", produces="text/html; charset=utf-8") public Object getUserInfo(String code) { log.info("进入回调"); //1、获取accesstoken String accessToken = getAccessToken(); if(StringUtils.isEmpty(accessToken)){ return "未获取到accessToken，跳转到登录页"; } //2、根据accessToken和code获取用户OpenId String openId = getPersistentCode(accessToken, code); if(StringUtils.isEmpty(openId)){ return "未获取到用户OpenId，跳转到登录页使用账户密码登录"; } //3、根据openId查询数据库用户表，如果查询到用户则登录成功，未查询到则返回到登录首页使用账号密码登录并进行绑定钉钉openId return null; } /** * @method 获取accesstoken * @description 获取accesstoken * @date: 2022/1/26 22:00 * @author: cyb * @return 钉钉accessToken */ public String getAccessToken() { try { DingTalkClient clientDingTalkClient = new DefaultDingTalkClient(getTokenUrl); OapiGettokenRequest request = new OapiGettokenRequest(); // 填写步骤一创建应用的Appkey request.setAppkey(DING_TALK_APP_ID); // 填写步骤一创建应用的Appsecret request.setAppsecret(DING_TALK_SECRET); request.setHttpMethod("GET"); OapiGettokenResponse response =clientDingTalkClient.execute(request); if(response.getErrcode() == 0){ return response.getAccessToken(); } log.info("获取accessToken失败:{}",response.getMsg()); }catch (Exception e){ log.error("获取accessToken失败:",e); } return null; } /** * @method getPersistentCode * @description 获取用户openId * @date: 2022/1/26 22:08 * @author: cyb * @param accessToken 用户的accessToken * @param code 扫码返回的code * @return openId */ public String getPersistentCode(String accessToken,String code) { try { DefaultDingTalkClient client = new DefaultDingTalkClient(getUserInfoUrl); OapiSnsGetuserinfoBycodeRequest req = new OapiSnsGetuserinfoBycodeRequest(); req.setTmpAuthCode(code); OapiSnsGetuserinfoBycodeResponse response = client.execute(req,DING_TALK_APP_ID,DING_TALK_SECRET); if(0 != response.getErrcode()){ return null; } OapiSnsGetuserinfoBycodeResponse.UserInfo userInfo = response.getUserInfo(); if(null != userInfo){ return userInfo.getOpenid(); } }catch (Exception e){ log.error("获取用户信息失败:",e); } return null; } }
以上则为钉钉扫码登录的主要流程，如有其他功能需求，可以查阅官网的文档说明，以扫码登录为例，访问网站：https://open.dingtalk.com/document/orgapp-server/obtain-the-user-information-based-on-the-sns-temporary-authorization。转载请说明出处
