源碼解析gtoken替換jwt實(shí)現(xiàn)sso登錄
jwt的問題
首先說明一個(gè)jwt存在的問題,也就是要替換jwt的原因:
- jwt無法在服務(wù)端主動(dòng)退出的問題
- jwt無法作廢已頒布的令牌,只能等到令牌過期問題
- jwt攜帶大量用戶擴(kuò)展信息導(dǎo)致降低傳輸效率問題
jwt的請(qǐng)求流程圖

gtoken的優(yōu)勢
gtoken的請(qǐng)求流程和jwt的基本一致。
gtoken的優(yōu)勢就是能幫助我們解決jwt的問題,另外還提供好用的特性,比如:
- gtoken支撐單點(diǎn)應(yīng)用測試使用內(nèi)存存儲(chǔ),支持個(gè)人項(xiàng)目文件存儲(chǔ),也支持企業(yè)集群使用redis存儲(chǔ);完全適用于企業(yè)生產(chǎn)級(jí)使用;
- 有效的避免了jwt服務(wù)端無法退出問題;
- 解決jwt無法作廢已頒布的令牌,只能等到令牌過期問題;
- 通過用戶擴(kuò)展信息存儲(chǔ)在服務(wù)端,有效規(guī)避了jwt攜帶大量用戶擴(kuò)展信息導(dǎo)致降低傳輸效率問題;
- 有效避免jwt需要客戶端實(shí)現(xiàn)續(xù)簽功能,增加客戶端復(fù)雜度;支持服務(wù)端自動(dòng)續(xù)期,客戶端不需要關(guān)心續(xù)簽邏輯;
注意問題
- 支持服務(wù)端緩存自動(dòng)續(xù)期功能,不需要通過refresh_token刷新token,簡化了客戶端的操作
- 版本問題千萬注意:在
gtoken v1.5.0全面適配GoFrame v2.0.0 ; GoFrame v1.X.X 請(qǐng)使用GfToken v1.4.X相關(guān)版本
TIPS:下面我的演示demo和源碼閱讀都是基于v1.4.x版本的。
演示demo
下面的演示demo可以復(fù)制到本地main.go文件中執(zhí)行,更新依賴的時(shí)候千萬注意版本。
重點(diǎn)說一下踩的坑:
Login方法會(huì)要求我們返回兩個(gè)值:
第一個(gè)值對(duì)應(yīng)userKey,后續(xù)我們可以根據(jù)userKey獲得token 第二個(gè)值對(duì)應(yīng)data,是interface{}類型,我們可以在這里定義例如userid、username等數(shù)據(jù)。
先有這個(gè)概念即可,后面會(huì)帶大家讀源碼。
package main
import (
"github.com/goflyfox/gtoken/gtoken"
"github.com/gogf/gf/frame/g"
"github.com/gogf/gf/net/ghttp"
"github.com/gogf/gf/os/glog"
)
var TestServerName string
//var TestServerName string = "gtoken"
func main() {
glog.Info("########service start...")
g.Cfg().SetPath("example/sample")
s := g.Server(TestServerName)
initRouter(s)
glog.Info("########service finish.")
s.Run()
}
var gfToken *gtoken.GfToken
/*
統(tǒng)一路由注冊(cè)
*/
func initRouter(s *ghttp.Server) {
// 不認(rèn)證接口
s.Group("/", func(group *ghttp.RouterGroup) {
group.Middleware(CORS)
// 調(diào)試路由
group.ALL("/hello", func(r *ghttp.Request) {
r.Response.WriteJson(gtoken.Succ("hello"))
})
})
// 認(rèn)證接口
loginFunc := Login
// 啟動(dòng)gtoken
gfToken := &gtoken.GfToken{
ServerName: TestServerName,
LoginPath: "/login",
LoginBeforeFunc: loginFunc,
LogoutPath: "/user/logout",
AuthExcludePaths: g.SliceStr{"/user/info", "/system/user/info"}, // 不攔截路徑 /user/info,/system/user/info,/system/user,
MultiLogin: g.Config().GetBool("gToken.MultiLogin"),
}
s.Group("/", func(group *ghttp.RouterGroup) {
group.Middleware(CORS)
gfToken.Middleware(group)
group.ALL("/system/user", func(r *ghttp.Request) {
r.Response.WriteJson(gtoken.Succ("system user"))
})
group.ALL("/user/data", func(r *ghttp.Request) {
r.Response.WriteJson(gfToken.GetTokenData(r))
})
group.ALL("/user/info", func(r *ghttp.Request) {
r.Response.WriteJson(gtoken.Succ("user info"))
})
group.ALL("/system/user/info", func(r *ghttp.Request) {
r.Response.WriteJson(gtoken.Succ("system user info"))
})
})
// 啟動(dòng)gtoken
gfAdminToken := &gtoken.GfToken{
ServerName: TestServerName,
//Timeout: 10 * 1000,
LoginPath: "/login",
LoginBeforeFunc: loginFunc,
LogoutPath: "/user/logout",
AuthExcludePaths: g.SliceStr{"/admin/user/info", "/admin/system/user/info"}, // 不攔截路徑 /user/info,/system/user/info,/system/user,
MultiLogin: g.Config().GetBool("gToken.MultiLogin"),
}
s.Group("/admin", func(group *ghttp.RouterGroup) {
group.Middleware(CORS)
gfAdminToken.Middleware(group)
group.ALL("/system/user", func(r *ghttp.Request) {
r.Response.WriteJson(gtoken.Succ("system user"))
})
group.ALL("/user/info", func(r *ghttp.Request) {
r.Response.WriteJson(gtoken.Succ("user info"))
})
group.ALL("/system/user/info", func(r *ghttp.Request) {
r.Response.WriteJson(gtoken.Succ("system user info"))
})
})
}
func Login(r *ghttp.Request) (string, interface{}) {
username := r.GetString("username")
passwd := r.GetString("passwd")
if username == "" || passwd == "" {
r.Response.WriteJson(gtoken.Fail("賬號(hào)或密碼錯(cuò)誤."))
r.ExitAll()
}
return username, "1"
/**
返回的第一個(gè)參數(shù)對(duì)應(yīng):userKey
返回的第二個(gè)參數(shù)對(duì)應(yīng):data
{
"code": 0,
"msg": "success",
"data": {
"createTime": 1652838582190,
"data": "1",
"refreshTime": 1653270582190,
"userKey": "王中陽",
"uuid": "ac75676efeb906f9959cf35f779a1d38"
}
}
*/
}
// 跨域
func CORS(r *ghttp.Request) {
r.Response.CORSDefault()
r.Middleware.Next()
}
啟動(dòng)項(xiàng)目:

訪問不認(rèn)證接口:返回成功

未登錄時(shí)訪問認(rèn)證接口:返回錯(cuò)誤

請(qǐng)求登錄接口:返回token

攜帶token再次訪問認(rèn)證接口:返回成功

以上就跑通了主體流程,就是這么簡單。
分析源碼
tips:下面帶大家看的是 v1.4.1
下面帶大家分析一下源碼,學(xué)習(xí)一下作者是如何設(shè)計(jì)的。
刷新token
首先我認(rèn)為gtoken很好的設(shè)計(jì)思想是不使用refresh_token來刷新token,而是服務(wù)端主動(dòng)刷新。
在源碼的getToken方法中做了更新refreshTime和createTime的處理。
更新createTime為當(dāng)前時(shí)間,refreshTime為當(dāng)前時(shí)間+自定義的刷新時(shí)間。

如下圖所示,getToken方法在每次執(zhí)行validToken校驗(yàn)token的時(shí)候都會(huì)調(diào)用,即每次校驗(yàn)token有效性時(shí),如果符合刷新token有效期的條件,就會(huì)進(jìn)行刷新操作(刷新token的過期時(shí)間,token值不變)

這樣就實(shí)現(xiàn)了無感刷新token。
GfToken結(jié)構(gòu)體
我們?cè)賮砜匆幌翯fToken的結(jié)構(gòu)體,更好的理解一下作者的設(shè)計(jì)思路:
- 因?yàn)镃acheMode支持gredis,也就意味著支持集群模式。
- 我們?cè)趩?dòng)gtoken的時(shí)候,只需要設(shè)置登錄和登出路徑,另外登錄和登出都提供了
BeforeFunc和AfterFunc,讓我們能清晰的界定使用場景。
// GfToken gtoken結(jié)構(gòu)體
type GfToken struct {
// GoFrame server name
ServerName string
// 緩存模式 1 gcache 2 gredis 默認(rèn)1
CacheMode int8
// 緩存key
CacheKey string
// 超時(shí)時(shí)間 默認(rèn)10天(毫秒)
Timeout int
// 緩存刷新時(shí)間 默認(rèn)為超時(shí)時(shí)間的一半(毫秒)
MaxRefresh int
// Token分隔符
TokenDelimiter string
// Token加密key
EncryptKey []byte
// 認(rèn)證失敗中文提示
AuthFailMsg string
// 是否支持多端登錄,默認(rèn)false
MultiLogin bool
// 是否是全局認(rèn)證,兼容歷史版本,已廢棄
GlobalMiddleware bool
// 中間件類型 1 GroupMiddleware 2 BindMiddleware 3 GlobalMiddleware
MiddlewareType uint
// 登錄路徑
LoginPath string
// 登錄驗(yàn)證方法 return userKey 用戶標(biāo)識(shí) 如果userKey為空,結(jié)束執(zhí)行
LoginBeforeFunc func(r *ghttp.Request) (string, interface{})
// 登錄返回方法
LoginAfterFunc func(r *ghttp.Request, respData Resp)
// 登出地址
LogoutPath string
// 登出驗(yàn)證方法 return true 繼續(xù)執(zhí)行,否則結(jié)束執(zhí)行
LogoutBeforeFunc func(r *ghttp.Request) bool
// 登出返回方法
LogoutAfterFunc func(r *ghttp.Request, respData Resp)
// 攔截地址
AuthPaths g.SliceStr
// 攔截排除地址
AuthExcludePaths g.SliceStr
// 認(rèn)證驗(yàn)證方法 return true 繼續(xù)執(zhí)行,否則結(jié)束執(zhí)行
AuthBeforeFunc func(r *ghttp.Request) bool
// 認(rèn)證返回方法
AuthAfterFunc func(r *ghttp.Request, respData Resp)
}
思考題
我有N個(gè)子系統(tǒng)如何用gtoken實(shí)現(xiàn)sso登錄呢?即實(shí)現(xiàn)一個(gè)子系統(tǒng)登錄,其他各個(gè)子系統(tǒng)都自動(dòng)登錄,而無需二次登錄呢?
想一想
我想到的解決方案是配合cookie實(shí)現(xiàn):各個(gè)子系統(tǒng)二級(jí)域名不一致,但是主域名一致。
我在登錄之后把token寫入主域名的cookie中進(jìn)行共享,前端網(wǎng)站通過cookie獲得token請(qǐng)求服務(wù)接口。
同時(shí)在刷新token之后,也要刷新cookie的有效期,避免cookie失效導(dǎo)致獲取不到token。
在經(jīng)過又一次仔細(xì)閱讀源碼之后找到了刷新cookie有效期的合適場景:AuthAfterFunc,我們可以重寫這個(gè)方法來實(shí)現(xiàn)驗(yàn)證后的操作:
如果token驗(yàn)證有效則刷新cookie有效期;如果驗(yàn)證無效則自定義返回信息。(往往我們自己項(xiàng)目中的code碼和gtoken預(yù)制的不一致,但是gtoken支持非常方便的重寫返回值)

總結(jié)
我們項(xiàng)目之前是使用jwt實(shí)現(xiàn)sso登錄,在剛剛拿到需求要重寫時(shí),自己可以說是一頭霧水。
在沒有認(rèn)真閱讀gtoken源碼之前,我已經(jīng)設(shè)計(jì)了refresh_token刷新的策略。
在仔細(xì)閱讀源碼之后,發(fā)現(xiàn)真香。
這次經(jīng)歷最大的收獲是:帶著需求去閱讀源碼是非常高效的學(xué)習(xí)方式。
試問自己一下:
如果讓我設(shè)計(jì)的話我會(huì)怎么設(shè)計(jì)?
為什么作者這么要設(shè)計(jì)?為什么作者能用560行代碼就設(shè)計(jì)出了gtoken?
最后向作者Jflyfox致敬,這是官方文檔
以上就是源碼解析gtoken替換jwt實(shí)現(xiàn)sso登錄的詳細(xì)內(nèi)容,更多關(guān)于gtoken替換jwt登錄sso的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
go語言阻塞函數(shù)和非阻塞函數(shù)實(shí)現(xiàn)
本文主要介紹了go語言阻塞函數(shù)和非阻塞函數(shù)實(shí)現(xiàn),文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-03-03
Go?channel實(shí)現(xiàn)批量讀取數(shù)據(jù)
Go中的?channel?其實(shí)并沒有提供批量讀取數(shù)據(jù)的方法,需要我們自己實(shí)現(xiàn)一個(gè),使用本文就來為大家大家介紹一下如何通過Go?channel實(shí)現(xiàn)批量讀取數(shù)據(jù)吧2023-12-12
go語言規(guī)范RESTful?API業(yè)務(wù)錯(cuò)誤處理
這篇文章主要為大家介紹了go語言規(guī)范RESTful?API業(yè)務(wù)錯(cuò)誤處理方法詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-03-03
golang 實(shí)現(xiàn)一個(gè)restful微服務(wù)的操作
這篇文章主要介紹了golang 實(shí)現(xiàn)一個(gè)restful微服務(wù)的操作,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2021-04-04
Go語言標(biāo)準(zhǔn)錯(cuò)誤error全面解析
Go語言中的錯(cuò)誤處理是通過內(nèi)置的error接口來實(shí)現(xiàn)的,其中errorString和wrapError是兩種常見的錯(cuò)誤類型實(shí)現(xiàn)方式,errorString通過errors.New()方法實(shí)現(xiàn),而wrapError則通過fmt.Errorf()方法實(shí)現(xiàn),支持錯(cuò)誤的嵌套和解析2024-10-10
Go語言編程實(shí)現(xiàn)支持六種級(jí)別的日志庫?
這篇文章主要為大家介紹了使用Golang編寫一個(gè)支持六種級(jí)別的日志庫示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-05-05

