码迷,mamicode.com
首页 > 编程语言 > 详细

springboot整合QQ第三方登录

时间:2020-02-18 18:19:11      阅读:139      评论:0      收藏:0      [点我收藏+]

标签:exception   constant   官方文档   访问   ons   mapping   Nid   throw   tps   

QQ授权登录

参考官方文档和网上的博客

过程说明

按照官方文档

https://wiki.connect.qq.com/%E5%87%86%E5%A4%87%E5%B7%A5%E4%BD%9C_oauth2-0

准备工作,申请appid和appkey

定义你的网站地址和回调地址,我这里为了方便直接用本地

技术图片

放置"QQ登录"按钮,就是下文的html

获取AccessToken

点击登录的按钮之后就会进入后端的loginByQQ()方法。

以GET方式访问 https://graph.qq.com/oauth2.0/authorize,在后面添加参数

技术图片

也就是访问这个url ,并在后面加上必要的参数,参数代表的意思文档已经给出说明,下文的代码里会有具体例子。

String url = String.format(LoginQQConstant.GET_AUTHORIZATION_CODE + "?response_type=%s&client_id=%s&redirect_uri=%s&state=%s", response_type, client_id, redirect_uri, state);

resp.sendRedirect(url);

技术图片

这一步过后会出现用户QQ登录授权页面,用户授权后再进入我们定义的回调方法callbackHandler();

从回调方法中的request中取出authorization_code

技术图片

访问 https://graph.qq.com/oauth2.0/token

技术图片

技术图片

获取到accessToken。

获取用户的OpenID

使用accessToken去获取openid

请求 https://graph.qq.com/oauth2.0/me

技术图片

技术图片

OpenAPI调用

根据openid调用官方提供的api,来获取用户信息

https://graph.qq.com/user/get_user_info?access_token=YOUR_ACCESS_TOKEN&oauth_consumer_key=YOUR_APP_ID&openid=YOUR_OPENID

技术图片

代码分析

先建立一个html文件,图标就用百度的了,为了方便,就直接用a标签访问后端的登录接口

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>
    <div>
        点击图片登录,随便找了一张百度的图片表示登录按钮了
    </div>
    <a href="/login/loginByQQ">
        <img src="http://www.baidu.com/img/baidu_jgylogo3.gif"/>
    </a>
</body>
</html>

定义一个常量类,保存一下官方提供的网址,给其他地方调用

package com.qiankai.qqlogin.constant;

/**
 * 常量类
 *
 * @author kai_qian
 * @version v1.0
 * @since 2020/02/18 15:43
 */
public final class LoginQQConstant {
    private LoginQQConstant(){}

    /**
     * 登录处理回调地址,可自定义,此时是为了演示方便,实际开发不应该放在常量类中,应放在配置文件
     */
    public static final String CALLBACK_URL ="http://127.0.0.1:8080/login/callbackHandler";

    /**
     * 自己的appID和appKey
     */
    public static final String APP_ID = "自己的APP-ID";
    public static final String APP_KEY = "自己的APP-KEY";

    /**
     * 获取Authorization Code
     */
    public static final String GET_AUTHORIZATION_CODE = "https://graph.qq.com/oauth2.0/authorize";

    /**
     * 通过Authorization Code获取Access Token
     */
    public static final String GET_ACCESS_TOKEN = "https://graph.qq.com/oauth2.0/token";

    /**
     * 获取用户openId
     */
    public static final String GET_OPEN_ID = "https://graph.qq.com/oauth2.0/me";

    /**
     * 获取用户信息
     */
    public static final String GET_USER_INFO = "https://graph.qq.com/user/get_user_info";
}

后端进行业务逻辑处理,基本步骤就是先根据官方文档中提供的url,按要求添加参数进行访问,然后获得返回的数据。

package com.qiankai.qqlogin.controller;

import com.fasterxml.jackson.databind.ObjectMapper;
import com.qiankai.qqlogin.constant.LoginQQConstant;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.RestTemplate;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.util.Date;
import java.util.HashMap;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * 登录逻辑处理
 *
 * @author kai_qian
 * @version v1.0
 * @since 2020/02/18 13:55
 */
@Controller
@RequestMapping("/login")
public class LoginController {


    @Autowired
    private RestTemplate restTemplate;

    /**
     * 处理登录事件,点击前端的图片会访问到这个方法
     */
    @RequestMapping("/loginByQQ")
    public void loginByQQ(HttpServletRequest req, HttpServletResponse resp) throws IOException, ServletException {
        String response_type = "code";
        String client_id = LoginQQConstant.APP_ID;
        // 官方文档强调此处要对url进行URLEncode,我试了一下,直接使用原始回调地址也能正常使用
        String redirect_uri = URLEncoder.encode(LoginQQConstant.CALLBACK_URL, "UTF-8");
//        String redirect_uri = LoginQQConstant.CALLBACK_URL;
        //client端的状态值。用于第三方应用防止CSRF攻击。
        String state = new Date().toString();
        req.getSession().setAttribute("state", state);

        String url = String.format(LoginQQConstant.GET_AUTHORIZATION_CODE +
                "?response_type=%s&client_id=%s&redirect_uri=%s&state=%s", response_type, client_id, redirect_uri, state);

        resp.sendRedirect(url);

        // 如果一切顺利,就会进入callbackHandler方法
    }

    /**
     * 用户授权后的回调方法
     */
    @ResponseBody
    @RequestMapping("/callbackHandler")
    public String callbackHandler(HttpServletRequest req, HttpServletResponse resp) throws IOException, ServletException {
        // 1.获取回调的authorization
        String authorization_code = req.getParameter("code");
        if (authorization_code == null || authorization_code.trim().isEmpty()) {
            throw new RuntimeException("未获取到AuthorizationCode");
        }
        // 2.client端的状态值。用于第三方应用防止CSRF攻击。
        String state = req.getParameter("state");
        if (!state.equals(req.getParameter("state"))) {
            throw new RuntimeException("client端的状态值不匹配!");
        }

        // 3.获取accessToken
        String urlForAccessToken = getUrlForAccessToken(authorization_code);
        String access_token = getAccessToken(urlForAccessToken);

        // 4.根据accessToken获取openId
        if (access_token == null || access_token.trim().isEmpty()) {
            throw new RuntimeException("未获取到accessToken");
        }
        String openid = getOpenId(access_token);

        // 5.根据openid获取用户信息
        if (openid == null || openid.trim().isEmpty()) {
            throw new RuntimeException("未获取到openId");
        }
        String userInfo = getUserInfo(openid,access_token);
        return "userInfo为:" + userInfo;

        // ... 获取到用户信息就可以进行自己的业务逻辑处理了
    }

    // 下面是辅助方法

    /**
     * 拼接用于获取accessToken的链接
     */
    private String getUrlForAccessToken(String authorization_code) throws UnsupportedEncodingException {
        String grant_type = "authorization_code";
        String client_id = LoginQQConstant.APP_ID;
        String client_secret = LoginQQConstant.APP_KEY;
//        String redirect_uri = URLEncoder.encode(CALLBACK_URL, "UTF-8"); 此处进行URLEncode会导致无法获取AccessToken
        String redirect_uri = LoginQQConstant.CALLBACK_URL;

        String url = String.format(LoginQQConstant.GET_ACCESS_TOKEN +
                        "?grant_type=%s&client_id=%s&client_secret=%s&code=%s&redirect_uri=%s",
                grant_type, client_id, client_secret, authorization_code, redirect_uri);

        return url;
    }

    /**
     * 获取accessToken
     */
    private String getAccessToken(String urlForAccessToken) {
        //第一次用服务器发起模拟客户端访问,得到的是包含access_token的字符串,其格式如下
        //access_token=0FFD92ABD1DFD4F5&expires_in=7776000&refresh_token=04CE5D1F1E290B0974C5
        String firstCallbackInfo = restTemplate.getForObject(urlForAccessToken, String.class);
        String[] params = firstCallbackInfo.split("&");
        String access_token = null;
        for (String param : params) {
            String[] keyvalue = param.split("=");
            if (keyvalue[0].equals("access_token")) {
                access_token = keyvalue[1];
                break;
            }
        }
        return access_token;
    }

    /**
     * 根据accessToken获取openid
     */
    private String getOpenId(String access_token) throws IOException {
        String url = String.format(LoginQQConstant.GET_OPEN_ID + "?access_token=%s", access_token);
        //第二次模拟客户端发出请求后得到的是带openid的返回数据,格式如下
        //callback( {"client_id":"YOUR_APPID","openid":"YOUR_OPENID"} );
        String secondCallbackInfo = restTemplate.getForObject(url, String.class);

        //正则表达式处理
        String regex = "\\{.*\\}";
        Pattern pattern = Pattern.compile(regex);
        Matcher matcher = pattern.matcher(secondCallbackInfo);
        if (!matcher.find()) {
            throw new RuntimeException("异常的回调值: " + secondCallbackInfo);
        }

        //调用jackson
        ObjectMapper objectMapper = new ObjectMapper();
        HashMap hashMap = objectMapper.readValue(matcher.group(0), HashMap.class);

        String openid = ((String) hashMap.get("openid"));
        //return "获取到的openid为:" + openid;
        return openid;
    }

    /**
     * 根据openid获取用户信息
     */
    private String getUserInfo(String openid,String access_token) {
        String infoUrl = String.format(LoginQQConstant.GET_USER_INFO + "?access_token=%s&oauth_consumer_key=%s&openid=%ss", access_token, LoginQQConstant.APP_ID, openid);
        String userInfo = restTemplate.getForObject(infoUrl, String.class);
        return userInfo;
    }
}

参考

https://segmentfault.com/a/1190000020181967?utm_source=tag-newest

https://wiki.connect.qq.com/%E5%87%86%E5%A4%87%E5%B7%A5%E4%BD%9C_oauth2-0

springboot整合QQ第三方登录

标签:exception   constant   官方文档   访问   ons   mapping   Nid   throw   tps   

原文地址:https://www.cnblogs.com/codeclock/p/12327005.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!