README.md · chinaOs/oauth2-authorize

# OAuth 2.0 认证授权协议，实现

oauth2-common :  通用工具类，如：异常，枚举类型，OAuth2Token，SecurityUtils，验证码

oauth2-server :   OAuth 2.0授权服务端，实现了：客户端模式，密码模式，手机短信验证码模式

oauth2-client :  OAuth 2.0授权客户端，在其他应用中集成，即可轻松接入铭灏授权平台

oauth2-client-test :  测试OAuth 2.0授权客户端

## 1.导入数据库，最好是 MySQL 8.0

## 2.修改 [ oauth2-server ]  application-dev.yml 中的  数据库连接地址，和 redis 连接地址

## 3.在IntelliJ IDEA中，可以 使用 REST Client 调用，测试接口

![](./images/3.png)

### 可用客户端列表

| clientId           | secret             | name                  | grant_types                               |
| ------------------ | ------------------ | --------------------- | ----------------------------------------- |
| 7KutwpFgFXv0hcvkBO | 7KutwpFgFXv0hcvkBO | 商户管理后台          | ["we_chat","password","tencent_qq","sms"] |
| nssbTtp5FO6NjZpUwP | nssbTtp5FO6NjZpUwP | vue.js 总部管理后台   | ["*"]                                     |
| VIUvXZmVXmOFh1gYWK | VIUvXZmVXmOFh1gYWK | 华为IOT园区项目组,API | ["client_credentials"]                    |

grant_types: 参数解释

" * " :  表示全部

we_chat： 微信授权登录

tencent_qq： 腾讯QQ授权登录

password： 密码模式授权登录

sms： 短信验证码授权登录

### 可用  用户列表

| username | password | mobile      | email              | nickname |
| -------- | -------- | ----------- | ------------------ | -------- |
| admin    | admin    | 15071525233 | 3548794@qq.com     | 管理员   |
| test     | test     | 15076549849 | 57487484@qq.com    | 测试     |
| doudou   | doudou   | 15076549869 | 15076549869@qq.com | 王逗逗   |

## 授权码模式

#### 1.在浏览器中打开如下地址

```
http://localhost:8098/code?responseType=code&clientId=nssbTtp5FO6NjZpUwP&redirectUri=http://www.xaaef.com/getCode&scope=base_user&state=K2KpBc6cF00JkRZPd
```

#### 2.输入用户名和密码， 默认都是： admin

![](./images/2.png)

#### 3.登录成功后，就可以看到浏览器地址栏中的 code 参数

![](./images/1.png)

#### 4.通过 code 换 access_token

```
POST http://localhost:8098/access_token
Content-Type: application/json

body：
{
    "grant_type":"authorization_code",
    "client_id":"nssbTtp5FO6NjZpUwP",
    "client_secret":"nssbTtp5FO6NjZpUwP",
    "code":"上一步，中获取的 code "
}

response: 
{
  "status": 200,
  "message": "ok",
  "data": {
    "access_token": "eyJhbGciOiJIUzUxMiJ9.eyJqdGkiOIeqPZhq-EH9RwV10hs9IHrLQ8ctEAhNbkICtEPLROP6pmyc_Q",
    "token_type": "Bearer ",
    "expires_in": 3600,
    "refresh_token": "eyJhbGciOiJIUzUxMiJ9.eyJqdGkiOiIxMThlY2NlkwMjUifQ.eNOiBa_gMNbkIChXY-Yn6IqMlzzw",
    "scope": "read,write"
  }
}
```

#### 5.通过上一步获取的 access_token 参数，获取用户信息

```
GET http://localhost:8098/loginInfo
Content-Type: application/json
Authorization: Bearer {{access_token}}

response: 
{
  "status": 200,
  "message": "ok",
  "data": {
    "tokenId": "ac44d5f3646f43cda94e72fcb1ddcfe5",
    "grantType": "authorization_code",
    "user": {
      "userId": 609429132107067392,
      "avatar": "https://images.xaaef.com/b9a7abacafd747bbb74cf7cb3de36c1e.png",
      "username": "admin",
      "mobile": "15071525233",
      "email": "3548794@qq.com",
      "nickname": "管理员",
      "gender": 1,
      "birthday": "1995-08-17",
      "status": 2,
      "adminFlag": 1
    },
    "client": {
      "clientId": "7KutwpFgFXv0hcvkBO",
      "name": "商户管理后台",
      "logo": "dwa",
      "description": "多商户管理后台",
      "clientType": 1,
      "grantTypes": [
        "*"
      ],
      "domainName": "www.xaaef.com",
      "scope": "read,write"
    }
  }
}
```

## 密码模式

```
POST http://localhost:8098/password
Content-Type: application/json

body：
{
  "username": "admin",
  "password": "admin",
  "grant_type": "password",
  "client_id": "7KutwpFgFXv0hcvkBO",
  "client_secret": "7KutwpFgFXv0hcvkBO"
}

response: 
{
  "status": 200,
  "message": "ok",
  "data": {
    "access_token": "eyJhbGciOiJIUdGkiOMNWklfskZwzUxMiJ9.eyJqdGkiOMNWklfskZw-Z6lEzJqHVOpr5-g",
    "token_type": "Bearer ",
    "expires_in": 3600,
    "refresh_token": "eyJhbGciOiJIiOiJIUzUzUxMiJ9.eyJqdGkiOiIiOiJIUz2YjYwZDM5ZGzAKZflB2z_79n-Q",
    "scope": "read,write"
  }
}
```

## 客户端模式

```
POST http://localhost:8098/client
Content-Type: application/json

body：
{
  "scope": "read",
  "grant_type": "client_credentials",
  "client_id": "VIUvXZmVXmOFh1gYWK",
  "client_secret": "VIUvXZmVXmOFh1gYWK"
}

## 短信验证码模式

```
### 发送短信 验证码
POST http://localhost:8098/sms/send
Content-Type: application/json

body：
{
  "client_id": "nssbTtp5FO6NjZpUwP",
  "mobile": "15071525233"
}

response: 
{
  "status": 200,
  "message": "ok"
}

### 短信验证码 模式登录
POST http://localhost:8098/sms
Content-Type: application/json

body：
{
  "mobile": "15071525233",
  "code": "1168",
  "grant_type": "sms",
  "client_id": "nssbTtp5FO6NjZpUwP",
  "client_secret": "nssbTtp5FO6NjZpUwP"
}

## 获取登录用户信息

```
### 获取登录的用户信息
GET http://localhost:8098/loginInfo
Content-Type: application/json
Authorization: Bearer {{tokenValue}}

response: 
{
  "status": 200,
  "message": "ok",
  "data": {
    "tokenId": "ac44d5f3646f43cda94e72fcb1ddcfe5",
    "grantType": "password",
    "user": {
      "userId": 609429132107067392,
      "avatar": "https://images.xaaef.com/b9a7abacafd747bbb74cf7cb3de36c1e.png",
      "username": "admin",
      "mobile": "15071525233",
      "email": "3548794@qq.com",
      "nickname": "管理员",
      "gender": 1,
      "birthday": "1995-08-17",
      "status": 2,
      "adminFlag": 1
    },
    "client": {
      "clientId": "7KutwpFgFXv0hcvkBO",
      "name": "商户管理后台",
      "logo": "dwa",
      "description": "多商户管理后台",
      "clientType": 1,
      "grantTypes": [
        "we_chat",
        "password",
        "tencent_qq",
        "sms"
      ],
      "domainName": "www.mhtled.com",
      "scope": "read,write"
    }
  }
}
```

## 刷新 token

```
### 刷新 token
POST http://localhost:8098/refresh
Content-Type: application/json
refresh_token: Bearer {{refreshToken}}

## 退出登录

```
### 退出登录
POST http://localhost:8098/logout
Content-Type: application/json
Authorization: Bearer {{tokenValue}}

response: 
{
  "status": 200,
  "message": "ok"
}
```

chinaOs/oauth2-authorize

简介

发行版

贡献者

近期动态

chinaOs/oauth2-authorize .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

chinaOs/oauth2-authorize