参数传递机制之JWT
1. 什么是 JWT
JWT 其全稱為:JSON Web Token,簡單地說就是 JSON 在 Web 上的一種帶簽名的標記形式。官方的定義如下:
JSON Web Tokens are an open, industry standard RFC 7519 method for representing claims securely between two parties.
即:JSON Web Token (JWT)是一個開放標準(RFC 7519),它定義了一種緊湊的、自包含的方式,用于作為JSON對象在各方之間安全地傳輸信息。
2. 有什么作用
對信息進行簽名之后再進行傳輸有什么作用,JWT 就有什么作用。它能起的作用,決定了在項目的需求中是否有必要使用它,它自身的本質決定了它適合的場景。
本質上,JWT 跟自己對信息加個簽名沒有區別。
那使用它的理由是什么呢?
(1)它建立了一個標準并為多數人認識和接受,這樣一來就可以形成標準庫,使用者可以共享。
(2)它形成了一些最佳實踐,這種實踐過程包括了參數安全傳遞的諸多常見方面,如 exp 到期時間屬性的定義來規定簽名有效期等。按照最佳實踐中對一些 JSON 屬性的明確定義,再加上標準庫對它的貫徹實現,會帶來很多便利。
(3)將其作為 Token 放在請求的 header 中,作為無狀態的鑒權方式很適合目前多站點應用的場景。
但最佳實踐和其特性不能混為一談,具體到應用場景,仍然可以利用其特性作適合該場景的其它發揮。
3. 參數訪問控制演化
(1)直接傳參
http://*/api?p1=*&p2=*
這種方式,不進行訪問的權限的判斷,公開可直接訪問。
(2)帶KEY傳參
http://*/api?p1=*&p2=*&key=
這種方式需要知道正確的 KEY 才能訪問,但 KEY 明文附在后面易泄露。
(3)帶簽名傳參
這種方式,將 KEY 作為簽名算法的加密條件,不明文顯示,不知道 KEY 則無法生成相應的簽名,感覺不錯。不足在于,簽名一次之后訪問鏈接一直為有效會帶有風險。
http://*/api?p1=*&p2=*&sign=
其中簽名部分,如采用 md5 方式,key 作為運算的一部分。
sign=md5(p1+p2+key)
(4)帶時間戳簽名
參數中帶上簽名時的時間戳,時間戳會參與簽名算法,服務端不僅檢測簽名的有效性,還會比較時間是否在合理范圍內,如 5 分鐘以內,如此一來,鏈接在一段時間之后就會失效。
http://*/api?p1=*&p2=*×tamp=*&sign=
其中簽名部分,如采用 md5 方式,time,key 均作為運算的一部分。
sign=md5(p1+p2+time+key)
(5)獨立鑒權參數簽名
將鑒權部分獨立出來簽名,這樣的好處就是鑒權部分獨立的判斷過程,其它形參不再需要參與這個簽名與判斷過程。
參數可使用 JSON 形式,于是可以讓其變成以下形式:
鑒權傳輸部分形式如:{p1:abcd,p2:abcd}.sign
其中,簽名部分,如采用 md5 方式,將 JSON 字符串與 key 拼接運算,并且使用連接符.點,如下。
sign=md5({p1:abcd,p2:abcd}.key)
(6)帶頭部的獨立鑒權部分
為了更加靈活的,將鑒權部分加個頭部。頭部用來干什么呢,可以指定簽名算法,或以后可能要更多擴展參數用,如以下形式。
{alg:MD5}.{p1:abcd,p2:abcd}.sign
簽名部分,為前兩部分再連接上 key 一起運算。
sign=md5({alg:MD5}.{p1:,p2:}.key)
(7)最終標準化為 JWT 形式
頭部稱之為 header,數據部分稱之為 payload,簽名部分為 signature。
(7.1) header 不使用明文,采用其 base64 形式
(7.2) payload 不使用明文,采用其 base64 形式
(7.3) signature 為前兩者(都是 base64 形式)通過 . 點連接,再采用 header 中指定的簽名算法簽名的結果。
(7.4) 最終形式為?base64(header).base64(payload).signature
(7.5) base64 考慮到URL編碼,將=去掉,+號變成-,/變成_ 處理。
(7.6) 最終字符串通過作為請求 header 進行傳輸。
4. 最簡實現
給定一個簽名用的 sercretKey 和 payload,生成成符合要求的 JWT 字符串。多數時候,需求可能就是這樣簡單,至于簽名算法,這里就使用一般默認的HS256。則需要的功能函數大致是:
func getJwt (payload){? ? var content = base64({"alg":"HS256","typ":"JWT"}) + . + base64(payload)? ? var signature = base46( sign(content, sercretKey)? )? ? return content + . + sign}C# 的實例代碼,這里給出一個 C# 的 JWT 輔助類,其中 JObject 引用了 Newtonsoft.Json 包。
public class JWTHelper { #region 工具函數準備 public static string Base64URL(string str) { return Convert.ToBase64String(Encoding.UTF8.GetBytes(str)).Replace("=", "").Replace("+", "-").Replace("/", "_"); } public static string Base64URL(byte[] bs) { return Convert.ToBase64String(bs).Replace("=", "").Replace("+", "-").Replace("/", "_"); } public static string HS256(string str, string key) { var encoding = new System.Text.UTF8Encoding(); byte[] keyByte = encoding.GetBytes(key); byte[] messageBytes = encoding.GetBytes(str); using (var hmacsha256 = new HMACSHA256(keyByte)) { byte[] hashmessage = hmacsha256.ComputeHash(messageBytes); return Base64URL(hashmessage); } } #endregion public static string Sign(JObject payload, String key) { JObject header = new JObject(); header["alg"] = "HS256"; header["typ"] = "JWT"; string h = Base64URL(header.ToString(Formatting.None)); string p = Base64URL(payload.ToString(Formatting.None)); string s = HS256(h + "." + p, key); return String.Format("{0}.{1}.{2}", h, p, s); } }使用以下代碼測試一下:
JObject payload = new JObject();payload["username"] = "xxx";Console.Write(JWTHelper.Sign(payload, "123fd"));得到結果
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6Inh4eCJ9.1C28A5CqMa70FLtUQh4pwSZWPlZhbQ-ZeYs38K_sqks在?https://jwt.io/?上,可以驗證一下,得到了同樣的結果。
5. 具體使用
顯然,它也會存在一些問題,如通過 base64 解碼看到明文,或者是在有效期內取得整個 token 進行訪問等。所以使用是根據需要來的。而且,也可以在 JWT 上進一步加入自定義的新機制來應對更多的場景。
以下這篇文章列出了一些問題與趨勢,可供參考。
https://baijiahao.baidu.com/s?id=1608021814182894637
更多細節可參考:https://www.cnblogs.com/cjsblog/p/9277677.html
總結
以上是生活随笔為你收集整理的参数传递机制之JWT的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: SiteServer CMS 新版本 V
- 下一篇: 初探System.Threading.C