JWT(json web token)

jwt

jwt的原理和session有點相像，其目的是為了解決rest api中無狀態性

因為rest介面，需要權限校驗，但是又不能每個請求都把用戶名密碼傳入，因此產生了這個token的方法

流程：

https://blog.wangjunfeng.com/post/golang-jwt/#3-%E7%AD%BE%E5%90%8D-signature

1. 用戶訪問auth介面，獲取token

   服務器校驗用戶傳入的用戶名密碼等資訊，確認無誤后，產生一個token，這個token其實是類似于map的資料結構（jwt資料結構）中的key，

   準確的應該是：token中其實就保存了用戶的資訊，只是被加密過了，怪不得服務器重啟了token還能使用，就是這個原因，因為資料就是保存在token這條長長的字串中的，

2. 用戶訪問需要權限驗證的介面，并傳入token，

   服務器驗證token：根據自己的token密鑰判斷token是否正確（是否被別人篡改），正確后才從token中決議出token中的資訊，可能會把決議出的資訊保存在context中

使用步驟

1. 下載依賴包

   go get -u github.com/dgrijalva/jwt-go

2. 撰寫jwt工具包，用戶創建和檢查token

   分為幾個部分：

   1. 指定加密密鑰
   2. 指定被保存在token中的物體物件，Claims 結構體，需要內嵌jwt.StandardClaims，這個結構體是用來保存資訊的，
   3. 根據資料產生token：根據傳入的資訊，組裝成一個Claims結構體物件，再從物件中獲取token
   4. 根據token決議資料：決議出token所對應的interface{}，再使用斷言決議出Claims物件，取資料

   / 指定加密密鑰
   var jwtSecret=[]byte(setting.JwtSecret)
   
   //Claim是一些物體（通常指的用戶）的狀態和額外的元資料
   type Claims struct{
   	Username string `json:"username"`
   	Password string `json:"password"`
   	jwt.StandardClaims
   }
   
   // 根據用戶的用戶名和密碼產生token
   func GenerateToken(username ,password string)(string,error){
   	//設定token有效時間
   	nowTime:=time.Now()
   	expireTime:=nowTime.Add(3*time.Hour)
   
   	claims:=Claims{
   		Username:       username,
   		Password:       password,
   		StandardClaims: jwt.StandardClaims{
               // 過期時間
   			ExpiresAt:expireTime.Unix(),
   			// 指定token發行人
   			Issuer:"gin-blog",
   		},
   	}
   
   	tokenClaims:=jwt.NewWithClaims(jwt.SigningMethodHS256,claims)
   	//該方法內部生成簽名字串，再用于獲取完整、已簽名的token
   	token,err:=tokenClaims.SignedString(jwtSecret)
   	return token,err
   }
   
   // 根據傳入的token值獲取到Claims物件資訊，（進而獲取其中的用戶名和密碼）
   func ParseToken(token string)(*Claims,error){
   
   	//用于決議鑒權的宣告，方法內部主要是具體的解碼和校驗的程序，最侄訓傳*Token
   	tokenClaims, err := jwt.ParseWithClaims(token, &Claims{}, func(token *jwt.Token) (interface{}, error) {
   		return jwtSecret, nil
   	})
   
   	if tokenClaims!=nil{
   		// 從tokenClaims中獲取到Claims物件，并使用斷言，將該物件轉換為我們自己定義的Claims
   		// 要傳入指標，專案中結構體都是用指標傳遞，節省空間，
   		if claims,ok:=tokenClaims.Claims.(*Claims);ok&&tokenClaims.Valid{
   			return claims,nil
   		}
   	}
   	return nil,err
   
   }
   

3. 撰寫路由，回傳token

   （需要做用戶引數校驗與錯誤處理）

   1. 用戶引數校驗

   type auth struct{
   	Username string `valid:"Required;MaxSize(50)"`
   	Password string `valid:"Required;MaxSize(50)"`
   }
   
   func GetAuth(c *gin.Context){
   	username:=c.Query("username")
   	password:=c.Query("password")
   
   	valid:=validation.Validation{}
   	a:=auth{
   		Username: username,
   		Password: password,
   	}
   
   
   	// 與之前的對每一個資料分開驗證不同，此處在auth物件中通過定義標簽valid
   	// 一次性校驗物件中的所有欄位資訊
   	ok,_:=valid.Valid(&a)
   
   
   	//創建回傳資訊
   	data:=make(map[string]interface{})
   	code:=e.INVALID_PARAMS
   	/*
   	根據用戶名密碼獲取token 判斷流程：
   	1. 先判斷用戶名密碼是否存在
   	*/
   	if ok{
   		isExist:=models.CheckAuth(username,password)
   		if isExist{
   			token,err:=util.GenerateToken(username,password)
   			if err!=nil{
   				code=e.ERROR_AUTH_TOKEN
   			}else{
   				data["token"]=token
   				code=e.SUCCESS
   			}
   		}else{
   			code=e.ERROR_AUTH
   		}
   	}else{
   		//如果資料驗證失敗，則列印結果
   		for _,err:=range valid.Errors{
   			log.Println(err.Key,err.Message)
   		}
   	}
   
   	c.JSON(http.StatusOK,util.ReturnData(code,e.GetMsg(code),data))
   }
   

4. 撰寫中間件，校驗token字串

   func JWY()gin.HandlerFunc{
   	return func(c *gin.Context){
   		var  code int
   		var data interface{}
   
   		code=e.SUCCESS
   		token:=c.Query("token")
   		if token==""{
   			code=e.ERROR_AUTH_NO_TOKRN
   		}else{
   			claims,err:=util.ParseToken(token)
   			if err!=nil{
   				code=e.ERROR_AUTH_CHECK_TOKEN_FAIL
   			}else if time.Now().Unix()>claims.ExpiresAt{
   				code=e.ERROR_AUTH_CHECK_TOKEN_TIMEOUT
   			}
   		}
   
   		//如果token驗證不通過，直接終止程式，c.Abort()
   		if code!=e.SUCCESS{
   			// 回傳錯誤資訊
   			c.JSON(http.StatusUnauthorized,util.ReturnData(code,e.GetMsg(code),data))
   			//終止程式
   			c.Abort()
   			return
   		}
   		c.Next()
   	}
   }
   

?

標籤：Go

上一篇：Golang訊息佇列：NSQ簡單介紹與使用

下一篇：defer原理、性能、優化