GoLang jwt无感刷新与SSO单点登录限制解除方法详解
目录
- 前言
- 为什么使用JWT
- Cookie和Session
- token (header.payload.signature)
- token 安全性
- 基于token安全性的处理
- 客户端与服务端基于无感刷新流程图
- golang实现atoken和rtoken
- 颁发token
- 校验token
- 无感刷新token
- 完整实现代码
- SSO(Single Sign On)单用户登录以及无感刷新token
- 实现思路
- 实战代码
- 小结
前言
为什么使用JWT
Jwt提供了生成token以及token验证的方法,而token是一种不用存储在服务端,只需要由用户携带即可实现认证的一种方式。在介绍JWT之前,我们也应该先了解cookie
和session
。
Cookie和Session
为每一位用户设定一个SessionID
,每次都需要对该SessionID
进行比对。这个SessionID
可能会保存在Cookie
中,安全性不高,并且容易过期(一般session的过期时间都为30分钟)。由于cookie
和session
需要保存在服务端,当用户量非常大的时候,服务端的负载就会越来越大。甚至有因此崩溃的可能。所以采用token
认证的方式。
token (header.payload.signature)
每个用户在进行登录的时候如果登录信息正确就会收到服务端颁发的令牌token
。当用户每次进行请求时都会携带一个token
。该token
会在服务端进行校验处理,复杂一点还需要经过一系列中间件的处理,确认token
格式和参数是否正确。如果一切正常就需要对该用户的本次操作进行放行。
token 安全性
如果token
被非用户人员获取到,由于token
已经颁发,在此token
生效期间服务端无法对其进行解除,因为它并不在服务端内部进行保存。也就是说服务端的token
一旦颁发就无法取消。
基于token安全性的处理
access token 和 refresh token
以下access token
简称 atoken
,refresh token
简称 rtoken
。无感刷新方式。
在用户登录的时候颁发两个token,atoken
和 rtoken
。atoken
的有效期很短,根据业务实际需求可以自定义。一般设置为10分钟足够。rtoken
有效期较长,一般可以设置为一星期或者一个月,根据实际业务需求可以自行定义。(根据查询资料得知 rtoken
需要进行client-sercet
才能有效)。当atoken
过期之后可以通过rtoken
进行刷新,但是rtoken
过期之后,只能重新登录来获取。
当atoken
丢失之后没关系,因为它有效期很短。当rtoken
丢失之后也没关系,因为他需要配合client-sercet
才能使用。
客户端与服务端基于无感刷新流程图
golang实现atoken和rtoken
引入jwt库 go get -u github.com/golang-jwt/jwt/v4
颁发token
// GenToken 颁发token access token 和 refresh token func GenToken(UserID int64, Username string) (atoken, rtoken string, err error) { rc := jwt.RegisteredClaims{ ExpiresAt: getJWTTime(ATokenExpiredDuration), Issuer: TokenIssuer, } at := MyClaim{ UserID, Username, rc, } atoken, err = jwt.NewWithClaims(jwt.SigningMethodHS256, at).SignedString(mySecret) // refresh token 不需要保存任何用户信息 rt := rc rt.ExpiresAt = getJWTTime(RTokenExpiredDuration) rtoken, err = jwt.NewWithClaims(jwt.SigningMethodHS256, rt).SignedString(mySecret) return }
在验证用户登录之后,根据传入的UID和Uname,生成atoken
和rtoken
。在颁发token中可以规定token的过期时间
func (t *Token) SignedString(key interface{}) (string, error) SignedString creates and returns a complete, signed JWT. The token is signed using the SigningMethod specified in the token.
SignedString
该方法主要用于token的数字签名
校验token
// VerifyToken 验证Token func VerifyToken(tokenID string) (*MyClaim, error) { var myc = new(MyClaim) token, err := jwt.ParseWithClaims(tokenID, myc, keyFunc) if err != nil { return nil, err } if !token.Valid { return nil, ErrorInvalidToken } return myc, nil }
根据传入的token值来判断是否有错误,如果错误为无效,说明token格式不正确。然后校验token是否过期。
无感刷新token
// RefreshToken 通过 refresh token 刷新 atoken func RefreshToken(atoken, rtoken string) (newAtoken, newRtoken string, err error) { // rtoken 无效直接返回 if _, err = jwt.Parse(rtoken, keyFunc); err != nil { return } // 从旧access token 中解析出claims数据 var claim MyClaim _, err = jwt.ParseWithClaims(atoken, &claim, keyFunc) // 判断错误是不是因为access token 正常过期导致的 v, _ := err.(*jwt.ValidationError) if v.Errors == jwt.ValidationErrorExpired { return GenToken(claim.UserID, claim.Username) } return }
注释已经写得很明白了,会根据旧的atoken和rtoken来返回新token。
完整实现代码
package main import ( "errors" "time" "github.com/golang-jwt/jwt/v4" ) const ( ATokenExpiredDuration = 2 * time.Hour RTokenExpiredDuration = 30 * 24 * time.Hour TokenIssuer = "" ) var ( mySecret = []byte("xxxx") ErrorInvalidToken = errors.New("verify Token Failed") ) type MyClaim struct { UserID int64 `json:"user_id"` Username string `json:"username"` jwt.RegisteredClaims } func getJWTTime(t time.Duration) *jwt.NumericDate { return jwt.NewNumericDate(time.Now().Add(t)) } func keyFunc(token *jwt.Token) (interface{}, error) { return mySecret, nil } // GenToken 颁发token access token 和 refresh token func GenToken(UserID int64, Username string) (atoken, rtoken string, err error) { rc := jwt.RegisteredClaims{ ExpiresAt: getJWTTime(ATokenExpiredDuration), Issuer: TokenIssuer, } at := MyClaim{ UserID, Username, rc, } atoken, err = jwt.NewWithClaims(jwt.SigningMethodHS256, at).SignedString(mySecret) // refresh token 不需要保存任何用户信息 rt := rc rt.ExpiresAt = getJWTTime(RTokenExpiredDuration) rtoken, err = jwt.NewWithClaims(jwt.SigningMethodHS256, rt).SignedString(mySecret) return } // VerifyToken 验证Token func VerifyToken(tokenID string) (*MyClaim, error) { var myc = new(MyClaim) token, err := jwt.ParseWithClaims(tokenID, myc, keyFunc) if err != nil { return nil, err } if !token.Valid { err = ErrorInvalidToken return nil, err } return myc, nil } // RefreshToken 通过 refresh token 刷新 atoken func RefreshToken(atoken, rtoken string) (newAtoken, newRtoken string, err error) { // rtoken 无效直接返回 if _, err = jwt.Parse(rtoken, keyFunc); err != nil { return } // 从旧access token 中解析出claims数据 var claim MyClaim _, err = jwt.ParseWithClaims(atoken, &claim, keyFunc) // 判断错误是不是因为access token 正常过期导致的 v, _ := err.(*jwt.ValidationError) if v.Errors == jwt.ValidationErrorExpired { return GenToken(claim.UserID, claim.Username) } return }
SSO(Single Sign On)单用户登录以及无感刷新token
实现思路
因为token
是由服务端颁发并且每次用户的操作都要在服务端校验token
的有效性。因此两个用户在不同时间段登录同一个账号,那么他们的token
肯定会因为时间而有所差别。我们可以将token
存放在redis
中,与用户ID进行key-value
绑定。如果通过userID
查询到的token
不同,那么说明这个用户的token
已经被更换(该账号又被登录了)或者token
错误。就需要重新进行登录操作。
实战代码
// parts[1]是获取到的atoken,我们使用之前定义好的解析JWT的函数来解析它 mc, err := jwt.VerifyToken(parts[1]) if err != nil { // 如果解析失败,可能是因为token过期,可以进入refreshToken进行判断 if newAtoken, newRtoken, err := jwt.RefreshToken(parts[1],rtoken); err == nil { // 如果无错误,就更新redis中的token if err = redis.SetSingleUserToken(mc.Username, newAtoken); err == nil { // 这里根据需求返回给前端,由前端进行处理 c.Writer.Header().Set("newAtoken", newAtoken) c.Writer.Header().Set("newRtoken", newRtoken) // 如果无错误,请求继续 c.Next() } } // 这里使用的是gin框架, 如果有错误直接阻止并返回 c.Abort() return } // 如果解析成功,就在redis中进行判断,是否单用户登录 // 通过获取redis中的token来校验是否单用户登录 token, err := redis.GetSingleUserToken(mc.Username) if err != nil { serializer.ResponseError(c, e.CodeServerBusy) c.Abort() return }
判断过程
- 请求从前端传来,经过认证中间件进行校验token,如果没有问题就进行redis单用户校验。
- 如果有问题,可能是token过期。进行无感刷新,如果刷新成功将新token设置在header中,请求继续
- 如果无感刷新失败请求阻止。
小结
- token需要保存在客户端中,由前端代码进行管理。后端只需做校验和刷新处理。
- 如果使用双token就用无感刷新。
- 如果使用单token就用token校验。
- SSO单点登录限制可以通过redis实现。
到此这篇关于GoLang jwt无感刷新与SSO单点登录限制解除方法详解的文章就介绍到这了,更多相关Go jwt无感刷新内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!