SpringBoot接入钉钉扫码登录

朴灿烈づ我的快乐病毒、 2024-03-18 00:21 29阅读 0赞

## SpringBoot接入钉钉扫码登录 ##

--------------------

#### 文章目录 ####

*  SpringBoot接入钉钉扫码登录
 *  前言
 *  一、思路说明
 *  二、准备工作
 *   *  1.创建应用
     *  2.应用配置
 *  三、代码实现
 *   *  1.跳转登录
     *  2.登录回调
 *  四、实现效果
 *  五、系统结合
 *  总结

--------------------

## 前言 ##

--------------------

## 一、思路说明 ##

1、获取钉钉二维码界面  
2、用户扫描二维码成功后进入回调方法  
3、回调方法获取accessToken  
4、回调方法根据code和accessToken获取用户信息  
参考官方文档：[官方文档][Link 1]

## 二、准备工作 ##

**需要先登录自己的钉钉账号，创建应用，并设置权限，配置回调地址。**

### 1.创建应用 ###

![在这里插入图片描述][5e315bb9423b4e589ff7e57a86af58c6.png]  
![在这里插入图片描述][f2dba36c67764b519a8f0ad70da2dc0b.png]

### 2.应用配置 ###

![在这里插入图片描述][6c3e24ccc64e4eda9e75f3e98517543f.png]  
**权限功能，选择全部员工，申请这两个权限，其他权限根据自己需要添加**  
![在这里插入图片描述][1a518f829565424591aded53e0cc653f.png]  
**设置回调地址**  
![在这里插入图片描述][3933b6a515ab40d0953407272b288046.png]

**回调地址的话，有服务器的直接用自己的服务器就行，没有的就本地虚拟机+内外穿透。  
这里采用本地虚拟机演示。**

**内外穿透这里用的花生壳免费的、windows要下载对应的程序**

**穿透配置**  
![在这里插入图片描述][82773c5a84ab4baabdca412fa17c8798.png]

**配置成功**  
![在这里插入图片描述][73cb475c84834cd59fd6216341120399.png]

## 三、代码实现 ##

**依赖：**

<dependency>
                <groupId>com.aliyun</groupId>
                <artifactId>dingtalk</artifactId>
                <version>2.0.25</version>
            </dependency>
            
            <dependency>
                <groupId>cn.hutool</groupId>
                <artifactId>hutool-all</artifactId>
                <version>5.8.20</version>
            </dependency>
            
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>fastjson</artifactId>
                <version>1.2.6</version>
            </dependency>

### 1.跳转登录 ###

public String genAuthorize() {
        
            HashMap<String, Object> map = new HashMap<>();
            map.put("redirect_uri", dingTalkAppConfig.getRedirectUri());
            map.put("response_type", dingTalkAppConfig.getResponseType());
            map.put("client_id", dingTalkAppConfig.getAppKey());
            map.put("scope", dingTalkAppConfig.getScope());
            map.put("prompt", dingTalkAppConfig.getPrompt());
            log.info("请求参数为:" + JSONUtil.toJsonStr(map));
            String response = HttpUtil.toParams(map);
            log.info("相应参数为:" + JSONUtil.toJsonStr(response));
            return response;
        }

### 2.登录回调 ###

public GetUserTokenResponseBody getAccessToken(String authCode) throws Exception {
        
            com.aliyun.dingtalkoauth2_1_0.Client client = dingtalkoauth2_1_0();
            GetUserTokenRequest getUserTokenRequest = new GetUserTokenRequest()
                    .setClientId(dingTalkAppConfig.getAppKey())
                    .setClientSecret(dingTalkAppConfig.getAppSecret())
                    .setCode(authCode)
                    .setGrantType(dingTalkAppConfig.getGrantType());
            try {
        
                GetUserTokenResponse userToken = client.getUserToken(getUserTokenRequest);
                log.info("userToken" + JSONObject.toJSONString(userToken));
                return userToken.getBody();
            } catch (TeaException err) {
        
                if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
        
                    // err 中含有 code 和 message 属性，可帮助开发定位问题
                }
    
            } catch (Exception _err) {
        
                TeaException err = new TeaException(_err.getMessage(), _err);
                if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
        
                    // err 中含有 code 和 message 属性，可帮助开发定位问题
                }
    
            }
            return null;
        }

## 四、实现效果 ##

**未登录状态需要扫码登录**  
![在这里插入图片描述][c9eaf260c605490d9916e5beadbf270e.gif]

**已登录的直接登录**

![在这里插入图片描述][333153d2b72543e2800de1effb0f2c11.gif]

**本地日志**  
![在这里插入图片描述][8f51d87114ed46c5a3254e00c356feda.png]

## 五、系统结合 ##

在用户登录之后，我们可以拿到手机号，openid。  
我们可以根据openid和本地用户体系建立起联系，存到一张中间表。  
在用户扫码登录成功的时候，判断当前用户是否是新用户。  
如果是新用户则直接在本地创建一个账号并维护对应的关联关系，然后进入业务系统对应的功能模块。  
如果不是新用户则直接进入对应的功能模块。  
并且在登录的时候我们可以再url中携带自己想要的自定义参数，需要的可以自己去研究。

## 总结 ##

代码已经上传到gitee需要自取：`https://gitee.com/xyzissj/dingtalk-scanning-login.git`

以上就是钉钉扫码登录的全部内容，有问题请留言。

[Link 1]: https://open.dingtalk.com/document/orgapp/tutorial-obtaining-user-personal-information
[5e315bb9423b4e589ff7e57a86af58c6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/0403434ea8134fc881dccfd8d5943b99.png
[f2dba36c67764b519a8f0ad70da2dc0b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/828b31c9ff444085a733f670fdc2fc29.png
[6c3e24ccc64e4eda9e75f3e98517543f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/ea1d4d1a896347f1a5d5b5490d8c4fc6.png
[1a518f829565424591aded53e0cc653f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/2c7790cd48f84e8aa785fea827c53e90.png
[3933b6a515ab40d0953407272b288046.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/4eb1eed7a4b54e9fac6ff9d0aceafe1d.png
[82773c5a84ab4baabdca412fa17c8798.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/8f1b7fbe59414725b5f7dc72d22a34f1.png
[73cb475c84834cd59fd6216341120399.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/b7e3bd289d7947c8bf393cbb1dea31ac.png
[c9eaf260c605490d9916e5beadbf270e.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/7c8935684eda4bd5b0aad35f1b65f12a.png
[333153d2b72543e2800de1effb0f2c11.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/e6022f030b574a4090aec856ada900e5.png
[8f51d87114ed46c5a3254e00c356feda.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/fe8570845a8545d3acd05e4c2c4fb608.png