【OAuth2】OAuth2概述及使用GitHub登录第三方网站

【OAuth2】OAuth2概述及使用GitHub登录第三方网站

0. 导言

我们在浏览器上可以访问成百上千个网站，使用每个网站的服务一般都要先注册账号，那么我们为了更好地记忆，一般都会在多个网站使用相同的账号和密码进行注册。那么问题就来了，如果在你注册的网站中有某些个网站的系统设计不够严谨和安全，数据库的用户信息使用明文存储，那么一旦这个网站遭到攻击或者是数据泄露，那么一些不怀好意的人就可能通过使用这些泄露的数据“撞库”，刚好就登录了你使用相同账号密码注册的其他网站。那么你的权益就有可能会受到损害。

由此行内大佬们便提出了 OAuth。

1. OAuth2 简介

OAuth 是一个开放的非常重要的认证标准/协议，允许用户授权第三方应用访问其存储在其他网站上资源，而无需将用户名密码提供给第三方网站的开放标准/协议。OAuth2 是 OAuth 的最新版本，同时也是被广泛应用的一个版本。我们在网站上常见的QQ登录，微信扫码登录，GitHub 授权登录就是基于 OAuth2.0 实现的。

官方文档：点击跳转

---

2. OAuth2 认证授权总体流程

整体认证授权流程如下：

从这张图中我们可以看出，整个 OAuth2 的认证授权流程中有4个不同角色：

1. Client：客户端，也就是第三方网站(相对于认证网站来说)。
2. Resource Owner：资源拥有者，也就是“我”。
3. Authorization Server：认证服务器或者说授权服务器。
4. Resource Server：资源服务器。

3. OAuth2 标准接口

• /oauth/authorize：授权端点

• /oauth/token：获取令牌端点

• /oauth/confirm_access：用户确认授权提交端点

• /oauth/error：授权服务错误信息端点

• /oauth/check_token：用于资源服务访问的令牌解析端点

• /oauth/token_key：提供公有密匙的端点，如果使用JWT令牌的话

---

4. OAuth2 四种授权模式

4.1 授权码模式

授权码模式(Authorization Code)：这是最常用的授权模式。在模式下，用户通过将重定向到授权服务器来进行身份验证，并获一个授权码。然后，应程序使用授权码与授权服务器进行交互，以获取访问牌和刷新令牌。访问令牌用于问受保护的资源，而刷新令牌用于获取新的访问令牌。微信扫码登录就是典型的授权码模式。

授权码模式的授权流程如下图所示：

具体流程如下:

• （A）用户访问第三方应用，第三方应用通过浏览器导向认证服务器。

• （B）用户选择是否给予客户端授权。

• （C）假设用户给予授权，认证服务器将用户导向客户端事先指定的"重定向URI"（redirection URI），同时附上一个授权码。

• （D）客户端收到授权码，附上早先的"重定向URI"，向认证服务器申请令牌。这一步是在客户端的后台的服务器上完成的，对用户不可见。

• （E）认证服务器核对了授权码和重定向URI，确认无误后，向客户端发送访问令牌（access token）和更新令牌（refresh token）。

核心参数(假设第三方网站的地址为:wx.com)：

https://wx.com/oauth/authorize?response_type=token&client_id=CLIENT_ID&redirect_uri=http://www.baidu.com&scope=read

字段	描述
client_id	授权服务器注册应用后的唯一标识
response_type	必须 固定值 在授权码中必须为 token
redirect_uri	必须 通过客户端注册的重定向URL
scope	必须 令牌可以访问资源权限
state	可选 存在原样返回客户端 用来防止 CSRF跨站攻击

申请令牌的请求示例(地址栏中的client表示client_id,secret表示密钥值)：

刷新令牌请求示例：

---

4.2 简化模式

简化模式(Implicit Grant)：简化模式不通过第三方应用程序的服务器，直接在浏览器中向认证服务器申请令牌，跳过了"授权码"这个步骤，因此得名。所有步骤在浏览器中完成，令牌对访问者是可见的，且客户端不需要认证。其具体的授权流程如图所示

具体步骤如下:

• （A）第三方应用将用户导向认证服务器。
• （B）用户决定是否给于客户端授权。
• （C）假设用户给予授权，认证服务器将用户导向客户端指定的"重定向URI"，并在URI的Hash部分包含了访问令牌。#token
• （D）浏览器向资源服务器发出请求，其中不包括上一步收到的Hash值。
• （E）资源服务器返回一个网页，其中包含的代码可以获取Hash值中的令牌。
• （F）浏览器执行上一步获得的脚本，提取出令牌。
• （G）浏览器将令牌发给客户端。

核心参数:

https://wx.com/oauth/authorize?response_type=token&client_id=CLIENT_ID&redirect_uri=http://www.baidu.com&scope=read

字段	描述
client_id	授权服务器注册应用后的唯一标识
response_type	必须 固定值 在授权码中必须为 token
redirect_uri	必须 通过客户端注册的重定向URL
scope	必须 令牌可以访问资源权限
state	可选 存在原样返回客户端 用来防止 CSRF跨站攻击

---

4.3 密码模式

**密码模式（Resource Owner Password Credentials Grant）**中，用户向客户端提供自己的用户名和密码。客户端使用这些信息，向"服务商提供商"索要授权。在这种模式中，用户必须把自己的密码给客户端，但是客户端不得储存密码。这通常用在用户对客户端高度信任的情况下，比如客户端是操作系统的一部分，或者由一个相同公司出品。而认证服务器只有在其他授权模式无法执行的情况下，才能考虑使用这种模式。

授权流程图如下所示：

具体步骤如下:

• （A）用户向客户端提供用户名和密码。

• （B）客户端将用户名和密码发给认证服务器，向后者请求令牌。

• （C）认证服务器确认无误后，向客户端提供访问令牌。

核心参数:

https://wx.com/token?grant_type=password&username=USERNAME&password=PASSWORD&client_id=CLIENT_ID

申请令牌的请求示例(地址栏中的client表示client_id,secret表示密钥值)：

刷新令牌的请求示例：

---

4.4 客户端模式

**客户端模式（Client Credentials Grant）**指客户端以自己的名义，而不是以用户的名义，向"服务提供商"进行认证。严格地说，客户端模式并不属于OAuth框架所要解决的问题。在这种模式中，用户直接向客户端注册，客户端以自己的名义要求"服务提供商"提供服务，其实不存在授权问题。

具体步骤如下:

• （A）客户端向认证服务器进行身份认证，并要求一个访问令牌。

• （B）认证服务器确认无误后，向客户端提供访问令牌。

https://wx.com/token?grant_type=client_credentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET

申请令牌的请求示例(地址栏中的client表示client_id,secret表示密钥值)：

---

5. GitHub授权登录

GitHub 授权登录流程：

（1）打开 GitHub 网站，在头部导航栏点击头像，再点击 Settings。

（2）找到 Developer settings

(3)先点击左侧 OAuth Apps ，再点击 New OAuth App

（4）输入信息，点击 Register application

(5)注册成功，点击生成密钥

(6)保存好密钥，之后不会完整显示了

（7）创建一个springboot项目

依赖如下：

<dependencies>
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-securityartifactId>
    dependency>
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-oauth2-clientartifactId>
    dependency>
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-webartifactId>
    dependency>

yml配置文件如下所示：

spring:
  security:
    oauth2:
      client:
        registration:
          github:
            client-id: 填自己的
            client-secret: 填自己的
            redirect-uri: http://localhost:8080/login/oauth2/code/github

创建一个配置类(这是新版本SpringSecurity的配置写法，废弃了WebSecurityConfigurerAdapter)：

@Configuration
@EnableWebSecurity
public class SecurityConfig {
    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http.authorizeRequests()
                .anyRequest().authenticated()
                .and()
                .oauth2Login();//使用 oauth2 认证
        // ...
        return http.build();
    }

}

再创建一个控制器类：

@RestController
public class HelloController {

    @GetMapping("/hello")
    public DefaultOAuth2User hello(){
        System.out.println("hello ");
        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
        return (DefaultOAuth2User) authentication.getPrincipal();
    }
}

启动项目，在浏览器中访问“http://localhost:8080”，跳转到github授权端点。

点击授权点击之后会跳转到 “localhost:8080”，这时已经授权成功。

我们访问 “http://localhost:8080/hello” 接口，发现出现了github的个人信息，授权成功。