【OAuth2.0】Gitee OAuth 第三方登录示例

第三方登录的原理

所谓第三方登录,实质就是 OAuth 授权。用户想要登录 A 网站,A 网站让用户提供第三方网站的数据,证明自己的身份。获取第三方网站的身份数据,就需要 OAuth 授权。

举例来说,A 网站允许 GitHub 登录,背后就是下面的流程。

(1) A 网站让用户跳转到 Gitee。
(2) Gitee 要求用户登录,然后询问"A 网站要求获得 xx 权限,你是否同意?"
(3) 用户同意,Gitee 就会重定向回 A 网站,同时发回一个授权码。
(4) A 网站使用授权码,向 Gitee 请求令牌。
(5) Gitee 返回令牌.
(6) A 网站使用令牌,向 Gitee 请求用户数据。

下面就是这个流程的代码实现。

应用登记

一个应用要求 OAuth 授权,必须先到对方网站登记,让对方知道是谁在请求。

所以,你要先去 Gitee 登记一下。当然,我已经登记过了,你使用我的登记信息也可以,但为了完整走一遍流程,还是建议大家自己登记。这是免费的。

访问这个网址,填写登记表

应用的名称随便填,主页 URL 填写 http://localhost:8080 ,跳转网址填写 http://localhost:8080/oauth/redirect

提交表单以后,Gitee 应该会返回客户端 ID(client ID)和客户端密钥(client secret),这就是应用的身份识别码。

示例仓库

我以Java为例写了一个oauth2-demo,请将它克隆到本地。

$ git clone git@gitee.com:ricky_gu/oauth2-demo.git
$ cd node-oauth-demo

两个配置项要改一下,写入上一步的身份识别码。

application.yaml: 改掉变量clientID and clientSecret
static/index.html: 改掉变量client_id

将项目导入idea后,启动

浏览器跳转 Gitee

示例的首页很简单,就是一个链接,让用户跳转到 GitHub。

跳转的 URL 如下。

https://gitee.com/oauth/authorize?client_id=7824b1e825addbf65254da9da4bef9e841ec660a04a116b0cd5e9bd5d2dbee39&
redirect_uri=http://localhost:8080/oauth/redirect&
response_type=code

这个 URL 指向 Gitee 的 OAuth 授权网址,带有两个参数:client_id告诉 GitHee 谁在请求,redirect_uri是稍后跳转回来的网址,response_type是告诉Gitee请求授权码。

用户点击到了 Gitee,Gitee 会要求用户登录,确保是本人在操作。

授权码

登录后,Gitee 询问用户,该应用正在请求数据,你是否同意授权。

用户同意授权, Gitee 就会跳转到redirect_uri指定的跳转网址,并且带上授权码,跳转回来的 URL 就是下面的样子。

http://localhost:8080/oauth/redirect&code=e527b51265e2132170e4cb1b93c16d7414753986b9d5a9c67a85a8c80f824511

后端收到这个请求以后,就拿到了授权码(code参数)。

后端实现

实现 /oauth/redirect 接口,从url取出授权码code之后,通过post请求到Gitee获取token

        String url = "https://gitee.com/oauth/token?" + "grant_type=authorization_code" +
                "&client_id=" + oAuth2Config.getClientID() +
                "&redirect_uri=" + oAuth2Config.getRedirectUri() +
                "&code=" + code;
//        url = url + "&client_secret=" + oAuth2Config.getClientSecret();
        Map<String, Object> body = new HashMap<>();
        body.put("client_secret", oAuth2Config.getClientSecret());
        System.out.println(url);

        String resp = HttpUtil.post(url, body);
        System.out.println(resp);
        JSONObject tokenResp = new JSONObject(resp);
        String token = tokenResp.getStr("access_token");

这里code可以放在url参数中,但是推荐通过body传参

API数据

有了令牌以后,就可以向 API 请求数据了。

        String userInfo = HttpUtil.get("https://gitee.com/api/v5/user?access_token=" + token);
        JSONObject userResp = new JSONObject(userInfo);
        String userName = userResp.getStr("name");

Gitee 的 Open API 接口可以看文档

跳转

最后带着需要的参数跳转到主页

        RedirectView redirectTarget = new RedirectView();
        redirectTarget.setContextRelative(true);
        redirectTarget.setUrl("http://localhost:8080/welcome.html?name=" + userName);
        return redirectTarget;
# OAuth2 

评论

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×