【第三方互联】十三、码云（Gitee）授权第三方登录

悠悠 2023-07-20 13:34 100阅读 0赞

**今天我们来学习：码云（Gitee）授权第三方登录，相比之前 [支付宝登录][Link 1]、[腾讯QQ登录][QQ] 以及 [新浪微博登录][Link 2] 来说，相对于比较简单**

### 一、准备工作 ###

*  1、登录 [码云官网][Link 3]

官网地址：https://gitee.com/

*  2、创建应用  
    ![设置][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70]  
    在右上角菜单找到 “设置” 选项  
    ![第三方应用][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 1]  
    在 “安全设置” 下找到 “第三方应用”  
    ![我的应用][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 2]  
    点击 “创建应用” 开始创建第三方应用  
    ![创建应用信息][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 3]  
    按照要求填写应用信息即可  
    ![应用详情][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 4]
 *  3、将应用信息保存到项目中  
    ![应用配置信息][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 5]  
    由于我使用的是 SpringBoot 项目，我放在了 application.yml 文件中

### 二、开始开发 ###

*  1、引入 Maven 依赖

<dependency>
    	<groupId>org.apache.httpcomponents</groupId>
    	<artifactId>httpclient</artifactId>
    	<version>4.5.6</version>
    </dependency>
    
    <dependency>
    	<groupId>com.alibaba</groupId>
    	<artifactId>fastjson</artifactId>
    	<version>1.2.51</version>
    </dependency>

其余的依赖请自行加入

*  2、在页面放置 “码云（Gitee）” 授权登录的 DOM 元素

这里使用的是阿里的 iconfont 图标

### 三、接口类 ###

创建 “码云（Gitee）” 授权登录的 Controller，GiteeController.java

*  1、从配置文件中获取 “码云（Gitee）” 配置信息

/** * gitee授权中提供的 appid 和 appkey */
    @Value("${gitee.oauth.clientid}")
    public String CLIENTID;
    @Value("${gitee.oauth.clientsecret}")
    public String CLIENTSECRET;
    @Value("${gitee.oauth.callback}")
    public String URL;

*  2、页面登录按钮点击后的接口

/** * 请求授权页面 */
    @GetMapping(value = "/auth")
    public String qqAuth(HttpSession session) { 
        // 用于第三方应用防止CSRF攻击
        String uuid = UUID.randomUUID().toString().replaceAll("-", "");
        session.setAttribute("state", uuid);
    
        // Step1：获取Authorization Code
        String url = "https://gitee.com/oauth/authorize?response_type=code" +
                "&client_id=" + CLIENTID +
                "&redirect_uri=" + URLEncoder.encode(URL) +
                "&state=" + uuid +
                "&scope=user_info";
    
        return PasswordUtils.redirectTo(url);
    }

接口文档中建议我们在授权登录时传入一个加密的数据防止被攻击，我们传入了UUID，最后重定向到授权页面  
![授权页面][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 6]

*  3、当该用户点击“授权”按钮，同意授权后，就会回调到我们在应用中填写的回调地址里去

/** * 授权回调 */
    @GetMapping(value = "/callback")
    public String qqCallback(HttpServletRequest request) throws Exception { 
        HttpSession session = request.getSession();
        // 得到Authorization Code
        String code = request.getParameter("code");
        // 我们放在地址中的状态码
        String state = request.getParameter("state");
        String uuid = (String) session.getAttribute("state");
    
        // 验证信息我们发送的状态码
        if (null != uuid) { 
            // 状态码不正确，直接返回登录页面
            if (!uuid.equals(state)) { 
                return PasswordUtils.redirectTo("/login");
            }
        }
    
        // Step2：通过Authorization Code获取Access Token
        String url = "https://gitee.com/oauth/token?grant_type=authorization_code" +
                "&client_id=" + CLIENTID +
                "&client_secret=" + CLIENTSECRET +
                "&code=" + code +
                "&redirect_uri=" + URL;
        JSONObject accessTokenJson = GiteeHttpClient.getAccessToken(url);
    
        // Step3: 获取用户信息
        url = "https://gitee.com/api/v5/user?access_token=" + accessTokenJson.get("access_token");
        JSONObject jsonObject = GiteeHttpClient.getUserInfo(url);
        /** * 获取到用户信息之后，就该写你自己的业务逻辑了 */
        return PasswordUtils.redirectTo("/success");
    }

### 四、网络请求方法 ###

上面回调方法中所用到的网络接口方法，我放在了 GiteeHttpClient.java 文件中，主要有两个方法

*  1、网络接口

/** * 获取Access Token * post */
    public static JSONObject getAccessToken(String url) throws IOException { 
        HttpClient client = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost(url);
        httpPost.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36");
        HttpResponse response = client.execute(httpPost);
        HttpEntity entity = response.getEntity();
        if (null != entity) { 
            String result = EntityUtils.toString(entity, "UTF-8");
            return JSONObject.parseObject(result);
        }
        httpPost.releaseConnection();
        return null;
    }
    
    /** * 获取用户信息 * get */
    public static JSONObject getUserInfo(String url) throws IOException { 
        JSONObject jsonObject = null;
        CloseableHttpClient client = HttpClients.createDefault();
    
        HttpGet httpGet = new HttpGet(url);
        httpGet.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36");
        HttpResponse response = client.execute(httpGet);
        HttpEntity entity = response.getEntity();
    
        if (entity != null) { 
            String result = EntityUtils.toString(entity, "UTF-8");
            jsonObject = JSONObject.parseObject(result);
        }
    
        httpGet.releaseConnection();
    
        return jsonObject;
    }

分别就是使用 code 获取 token，在使用 token 获取 用户信息

**注意：**我们需要在请求时加上请求头

User-Agent Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36

最终我们获取到一个 JSON 对象，该对象包含了用户的信息，例如：id，name，email，phone 等等。

*  2、官方 [OAuth 文档][OAuth]

https://gitee.com/api/v5/oauth_doc#/

### 五、总结 ###

该授权认证过程符合 OAuth2 认证基本流程，流程如下：  
![授权过程][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 7]

> 1、用户点击页面登录按钮，请求授权页面，用户在此页面登录账号并同意授权  
> 2、用户同意授权后，回调至我们项目中，首先验证 state 是否一致  
> 3、使用上一步拿到的 code 请求 access\_token  
> 4、使用 access\_token 请求 用户信息，完成授权登录过程

**下一篇：**

[【第三方互联】十四、Github授权第三方登录][Github]

如您在阅读中发现不足，欢迎留言！！！

[Link 1]: https://blog.csdn.net/qq_40065776/article/details/104979271
[QQ]: https://blog.csdn.net/qq_40065776/article/details/104497177
[Link 2]: https://blog.csdn.net/qq_40065776/article/details/104583624
[Link 3]: https://gitee.com/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70]: /images/20230528/48b9f1fdfd974465a95e94963cbcec4d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 1]: /images/20230528/c0aac5388ffe49aea49ce181cf36cc3f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 2]: /images/20230528/fa19e71aa405466b954da32fc3d7ce58.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 3]: /images/20230528/048c51ebf0764ba1a51672edbe73a235.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 4]: /images/20230528/8c0cbdba1f2d4726a533248805fed997.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 5]: /images/20230528/e594e67b992f4e12a88795bca537edea.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 6]: /images/20230528/1e69ccfc38d64e0194cac15b50d979c6.png
[OAuth]: https://gitee.com/api/v5/oauth_doc#/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQwMDY1Nzc2_size_16_color_FFFFFF_t_70 7]: /images/20230528/0b4ca22c3a584473a7af4eccd45312ce.png
[Github]: https://blog.csdn.net/qq_40065776/article/details/105395646