3行代碼快速實現(xiàn)Spring Boot Oauth2服務功能
這里的3行代碼并不是指真的只需要寫3行代碼,而是基于我已經寫好的一個Spring Boot Oauth2服務。僅僅需要修改3行數(shù)據(jù)庫配置信息,即可得到一個Spring Boot Oauth2服務。
項目地址https://github.com/jeesun/oauthserver
oauthserver
簡介
oauthserver是一個基于Spring Boot Oauth2的完整的獨立的Oauth服務器。僅僅需要創(chuàng)建相關數(shù)據(jù)表,修改數(shù)據(jù)庫的連接信息,你就可以得到一個Oauth服務器。
支持的關系型數(shù)據(jù)庫:
- PostgreSQL
- MySQL
已實現(xiàn)的功能:
- 集成Spring Boot Oauth2,實現(xiàn)Oauth服務;
- token保存到關系型數(shù)據(jù)庫;
- 日志記錄保存到文件,并按日歸檔;
- 數(shù)據(jù)庫連接信息加密;
- 集成Druid數(shù)據(jù)庫連接池。
使用流程
1. 建表
PostgreSQL
請執(zhí)行src/main/resources/schema-pg.sql,完成數(shù)據(jù)表的創(chuàng)建和測試數(shù)據(jù)的導入。
MySQL
請執(zhí)行src/main/resources/schema-mysql.sql,完成數(shù)據(jù)表的創(chuàng)建和測試數(shù)據(jù)的導入。
2. 修改數(shù)據(jù)庫連接信息
在application.yml中,配置著數(shù)據(jù)庫的連接信息。其中,配置項username和password是要經過jasypt加密的,不能直接填明文。加密密鑰由jasypt.encryptor.password配置。你需要使用test目錄下的UtilTests工具得到加密字符串。
PostgreSQL # PostgreSQL連接信息 driver-class-name: org.postgresql.Driver url: jdbc:postgresql://127.0.0.1:5432/thymelte?useUnicode=true&characterEncoding=UTF-8 username: ENC(hTpbG9fq+7P3SntmXuNtDxbtWDqRuPV+) password: ENC(abdq6LyOspryFQHCqzEMTxRozyJVjIA4) MySQL # MySQL連接信息 driver-class-name: com.mysql.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=utf-8&useSSL=false username: ENC(YiYjVwTulDGN//YaB3KbuA==) password: ENC(9oaIJkFgGSDFaHH3OXY63RHWQ+amDmiJ)
3. 運行
現(xiàn)在,一切已準備就緒。運行項目,當程序成功啟動時,即表明你已配置成功。
4. 測試
在建表時,我已經向表添加了測試數(shù)據(jù)。以下請求參數(shù)的值,均是測試數(shù)據(jù),在數(shù)據(jù)表中可以找得到。請根據(jù)需求到數(shù)據(jù)表中修改對應的值。
在表oauth_client_details表中,已有一條測試數(shù)據(jù)。列client_id和client_secret的值,分別對應Basic Oauth的請求參數(shù)username和password的值。而列access_token_validity和列refresh_token_validity,分別代表access_token和refresh_token的有效期時間,以秒為單位。測試數(shù)據(jù)7200和5184000,分別代表2個小時和2個月(60天)。這是一個比較合理的有效期時間的設置,可以參考。
token相關的接口,都需要進行Basic Oauth認證。
1、根據(jù)用戶名和密碼獲取access_token
POST http://localhost:8182/oauth/token?grant_type=password&username=jeesun&password=1234567890c
成功示例:
{ "access_token": "ca582cd1-be6c-4a5a-82ec-10af7a8e06eb", "token_type": "bearer", "refresh_token": "c24a6143-97c8-4642-88b9-d5c5b902b487", "expires_in": 3824, "scope": "read write trust" }
失敗示例(用戶名或者密碼錯誤)
{ "error": "invalid_grant", "error_description": "Bad credentials" }
2、檢查access_token
GET http://localhost:8182/oauth/check_token?token=ca582cd1-be6c-4a5a-82ec-10af7a8e06eb
成功示例
{ "aud": [ "oauth2-resource" ], "exp": 1524507296, "user_name": "jeesun", "authorities": [ "ROLE_ADMIN", "ROLE_USER" ], "client_id": "clientIdPassword", "scope": [ "read", "write", "trust" ] }
失敗示例(access_token已過期)
{ "error": "invalid_token", "error_description": "Token was not recognised" }
3、根據(jù)refresh_token獲取新的access_token
成功示例
{ "access_token": "690ecd7d-f2b7-4faa-ac45-5b7a319478e8", "token_type": "bearer", "refresh_token": "c24a6143-97c8-4642-88b9-d5c5b902b487", "expires_in": 7199, "scope": "read write trust" }
app實踐指南
app獲取到token信息后,需要保存token信息和請求時間。在傳access_token之前,需要檢查access_token是否過期。為了減少后臺壓力,檢查access_token是否過期應該是在app本地完成。通過token的keyexpires_in(剩余有效期)的值,以及本地記錄的請求時間,和當前時間做對比,可以很方便地判斷出access_token是否過期。如果過期了,需要通過refresh_token獲取新的access_token。因為access_token的有效期只有2個小時,這個驗證是必須的。refresh_token同理。
總結
以上所述是小編給大家介紹的3行代碼快速實現(xiàn)Spring Boot Oauth2服務,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持!
相關文章
JAVA實現(xiàn)監(jiān)測tomcat是否宕機及控制重啟的方法
這篇文章主要介紹了JAVA實現(xiàn)監(jiān)測tomcat是否宕機及控制重啟的方法,可實現(xiàn)有效的檢測及控制tomcat服務器運行,具有一定參考借鑒價值,需要的朋友可以參考下2015-08-08Component和Configuration注解區(qū)別實例詳解
這篇文章主要為大家介紹了Component和Configuration注解區(qū)別實例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2022-11-11Java abstract class 與 interface對比
這篇文章主要介紹了 Java abstract class 與 interface對比的相關資料,需要的朋友可以參考下2016-12-12springboot中配置好登錄攔截后,swagger訪問不了問題
這篇文章主要介紹了springboot中配置好登錄攔截后,swagger訪問不了問題及解決,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-12-12