(建議收藏)|Spring Boot集成JSON Web Token(JWT)

2021-01-13 Java實用技術

本號主要用於分享企業中常用的技術,更加側重於實用,歡迎關注,便於瀏覽其它更多實用的歷史文章。

一:認證

在了解JWT之前先來回顧一下傳統session認證和基於token認證。

## 1.1 傳統session認證

http協議是一種無狀態協議,即瀏覽器發送請求到伺服器,伺服器是不知道這個請求是哪個用戶發來的。為了讓伺服器知道請求是哪個用戶發來的,需要讓用戶提供用戶名和密碼來進行認證。當瀏覽器第一次訪問伺服器(假設是登錄接口),伺服器驗證用戶名和密碼之後,伺服器會生成一個sessionid(只有第一次會生成,其它會使用同一個sessionid),並將該session和用戶信息關聯起來,然後將sessionid返回給瀏覽器,瀏覽器收到sessionid保存到Cookie中,當用戶第二次訪問伺服器是就會攜帶Cookie值,伺服器獲取到Cookie值,進而獲取到sessionid,根據sessionid獲取關聯的用戶信息。

public User login(HttpServletRequest request, HttpServletResponse response) throws AuthenticationException {

String username = request.getParameter("username");

String password = request.getParameter("password");

User user = userService.login(username, password);

if (user == null) {

throw new AuthenticationException("用戶名或密碼錯誤");

}

// 返回這次請求關聯的當前會話,如果沒有會話則創建一個新的

// 需要在伺服器端記錄該session

HttpSession session = request.getSession();

session.setAttribute("user", user);

// 讓瀏覽器保存sessionid到cookie中

// Cookie cookie = new Cookie("sessionid", session.getId());

// cookie.setPath("/");

// response.addCookie(cookie);

return user;

}

public Object getUserInfo(HttpServletRequest request){

// 從request中獲取Cookie

// 從Cookie中獲取sessionid

// 根據sessionid獲取對應的Session對象

// 從session中獲取關聯的用戶信息

HttpSession session = request.getSession();

Object user = session.getAttribute("user");

return user;

}

session的缺點:

Session: 每個用戶經過我們的應用認證之後,我們的應用都要在服務端做一次記錄,以方便用戶下次請求的鑑別,通常而言session都是保存在內存中,而隨著認證用戶的增多,服務端的開銷會明顯增大。擴展性: 用戶認證之後,服務端做認證記錄,如果認證的記錄被保存在內存中的話,這意味著用戶下次請求還必須要請求在這臺伺服器上,這樣才能拿到授權的資源,這樣在分布式的應用上,相應的限制了負載均衡器的能力。這也意味著限制了應用的擴展能力。即不能滿足單點登陸CSRF: 因為是基於cookie來進行用戶識別的, cookie如果被截獲,用戶就會很容易受到跨站請求偽造的攻擊。## 1.2 基於token認證

token原理:

使用用戶名和密碼請求登錄接口登錄接口驗證用戶名和密碼登錄接口生成一個uuid作為token,將用戶信息作為值,然後保存到redis緩存中jedis.set(token, user);登錄接口返回用戶信息和token瀏覽器將token保存到本地當請求其它接口時就攜帶token值接口根據token去緩存中查,如果找到了就調用接口,如果找不到報token錯誤(一般通過攔截器來實現檢查)public String auth(String username, String password) throws AuthenticationException {

User user = userService.login(username, password);

if (user == null) {

throw new AuthenticationException("用戶名或密碼錯誤");

}

String token = UUID.randomUUID().toString();

redisClient.set(token, user);

return token;

}

public Object getUserInfo(@RequestHeader("token") String token) throws AuthenticationException {

User user = redisClient.get(token);

if (user == null) {

throw new AuthenticationException("token不可用");

}

return user;

}

session和token的區別:

此種方式原理上和session方式差不多,都是客戶端調用接口時攜帶一個值,伺服器通過該值來獲取用戶的信息。

不同的是session是將信息保存到本機內存中,對負載均衡有限制(只能負載到同一臺機器),token是保存到緩存伺服器(redis)中,對負載均衡沒有限制,如果使用同一個redis伺服器還可以保證單點登錄。session一般用在PC上,token即可用在PC上也可以用在APP上。

## 1.3 JWT

1.3.1 簡介

JSON Web Token(JWT)是為了在網絡應用環境間傳遞聲明而執行的一種基於JSON的開放標準((RFC 7519),它定義了一種緊湊(Compact)且自包含(Self-contained)的方式,用於在各方之間以JSON對象安全傳輸信息。 這些信息可以通過數字籤名進行驗證和信任。 可以使用秘密(使用HMAC算法)或使用RSA的公鑰/私鑰對對JWT進行籤名。JWT的聲明一般被用來在身份提供者和服務提供者間傳遞被認證的用戶身份信息,以便於從資源伺服器獲取資源,也可以增加一些額外的其它業務邏輯所必須的聲明信息,該token也可直接被用於認證,也可被加密。是目前最流行的跨域認證解決方案。

Compact(緊湊): 由於它們尺寸較小,JWT可以通過URL,POST參數或HTTP標頭內發送。 另外,尺寸越小意味著傳輸速度越快。Self-contained(自包含): 有效載荷(Playload)包含有關用戶的所有必需信息,避免了多次查詢資料庫。1.3.2 應用場景

Authentication(鑑權): 這是使用JWT最常見的情況。 一旦用戶登錄,每個後續請求都將包含JWT,允許用戶訪問該令牌允許的路由,服務和資源。 單點登錄是當今廣泛使用JWT的一項功能,因為它的開銷很小,並且能夠輕鬆地跨不同域使用。分布式站點的單點登錄(SSO)Information Exchange(信息交換): JSON Web Tokens是在各方之間安全傳輸信息的好方式。 因為JWT可以籤名:例如使用公鑰/私鑰對,所以可以確定發件人是他們自稱的人。 此外,由於使用標頭和有效載荷計算籤名,因此您還可以驗證內容是否未被篡改。1.3.3 語法

jwt有3個組成部分,每部分通過點號來分割 header.payload.signature

頭部(header) 是一個 JSON 對象,描述 JWT 的元數據,通常是下面的樣子載荷(payload) 是一個 JSON 對象,用來存放實際需要傳遞的數據籤證(signature) 對header和payload使用密鑰進行籤名,防止數據篡改。① 頭部header

Jwt的頭部是一個JSON,然後使用Base64URL編碼,承載兩部分信息:

聲明類型typ,表示這個令牌(token)的類型(type),JWT令牌統一寫為JWT聲明加密的算法alg,通常直接使用HMACSHA256,就是HS256了,也可以使用RSA,支持很多算法(HS256、HS384、HS512、RS256、RS384、RS512、ES256、ES384、ES512、PS256、PS384)var header = Base64URL({ "alg": "HS256", "typ": "JWT"})

Base64URL:Header 和 Payload 串型化的算法是 Base64URL。這個算法跟 Base64 算法基本類似,但有一些小的不同。JWT 作為一個令牌(token),有些場合可能會放到 URL(比如 api.example.com/?token=xxx)。Base64 有三個字符+、/和=,在 URL 裡面有特殊含義,所以要被替換掉:=被省略、+替換成-,/替換成_ 。這就是 Base64URL 算法。

② 載荷payload

payload也是一個JSON字符串,是承載消息具體內容的地方,也需要使用Base64URL編碼,payload中可以包含預定義的7個可用,它們不是強制性的,但推薦使用,也可以添加任意自定義的key

iss(issuer): jwt籤發者sub(subject): jwt所面向的用戶aud(audience): 接收jwt的一方, 受眾exp(expiration time): jwt的過期時間,這個過期時間必須要大於籤發時間nbf(Not Before): 生效時間,定義在什麼時間之前.iat(Issued At): jwt的籤發時間jti(JWT ID): jwt的唯一身份標識,主要用來作為一次性token,從而迴避重放攻擊。// 該token籤發給1234567890,姓名為John Doe(自定義的欄位),籤發時間為1516239022

var payload = Base64URL( {"sub": "1234567890", "name": "John Doe", "iat": 1516239022})

注意,JWT中payload是不加密的,只是Base64URL編碼一下,任何人拿到都可以進行解碼,所以不要把敏感信息放到裡面。

③ signature

Signature 部分是對前兩部分的籤名,防止數據篡改。

var header = Base64URL({ "alg": "HS256", "typ": "JWT"});

var payload = Base64URL( {"sub": "1234567890", "name": "John Doe", "iat": 1516239022});

var secret = "私鑰";

var signature = HMACSHA256(header + "." + payload, secret);

var jwt = header + "." + payload + "." + signature;

我們可以使用jwt.io調試器來解碼,驗證和生成JWT:

注意:secret是保存在伺服器端的,jwt的籤發生成也是在伺服器端的,secret就是用來進行jwt的籤發和jwt的驗證,所以,它就是你服務端的私鑰,在任何場景都不應該流露出去。一旦客戶端得知這個secret, 那就意味著客戶端是可以自我籤發jwt了。

1.3.4 jwt的特點

因為json的通用性,所以JWT是可以進行跨語言支持的,像JAVA,JavaScript,NodeJS,PHP等很多語言都可以使用。因為有了payload部分,所以JWT可以在自身存儲一些其他業務邏輯所必要的非敏感信息。它不需要在服務端保存會話信息, 所以它易於應用的擴展JWT 的幾個特點

(1)JWT 默認是不加密,但也是可以加密的。生成原始 Token 以後,可以用密鑰再加密一次。

(2)JWT 不加密的情況下,不能將敏感數據(如密碼)寫入 JWT,除非對payload進行加密。保護好secret私鑰,該私鑰非常重要。

(3)JWT 不僅可以用於認證,也可以用於交換信息。有效使用 JWT,可以降低伺服器查詢資料庫的次數。

(4)JWT 的最大缺點是,由於伺服器不保存 session 狀態,因此無法在使用過程中廢止某個 token,或者更改 token 的權限。也就是說,一旦 JWT 籤發了,在到期之前就會始終有效,除非伺服器部署額外的邏輯。

(5)JWT 本身包含了認證信息,一旦洩露,任何人都可以獲得該令牌的所有權限。為了減少盜用,JWT 的有效期應該設置得比較短。對於一些比較重要的權限,使用時應該再次對用戶進行認證。

(6)為了減少盜用,JWT 不應該使用 HTTP 協議明碼傳輸,要使用 HTTPS 協議傳輸。

1.3.5 JWT的優點:

體積小,因而傳輸速度更快多樣化的傳輸方式,可以通過URL傳輸、POST傳輸、請求頭Header傳輸(常用)簡單方便,服務端拿到jwt後無需再次查詢資料庫校驗token可用性,也無需進行redis緩存校驗在分布式系統中,很好地解決了單點登錄問題很方便的解決了跨域授權問題,因為跨域無法共享cookie1.3.6 JWT的缺點:

因為JWT是無狀態的,因此服務端無法控制已經生成的Token失效,是不可控的,這一點對於是否使用jwt是需要重點考量的獲取到jwt也就擁有了登錄權限,因此jwt是不可洩露的,網站最好使用https,防止中間攻擊偷取jwt在退出登錄 / 修改密碼時怎樣實現JWT Token失效https://segmentfault.com/q/10100000100438711.3.7 對於JWT安全性:

JWT被確實存在被竊取的問題,但是如果能得到別人的token,其實也就相當於能竊取別人的密碼,這其實已經不是JWT安全性的問題。網絡是存在多種不安全性的,對於傳統的session登錄的方式,如果別人能竊取登錄後的sessionID,也就能模擬登錄狀態,這和JWT是類似的。為了安全,https加密非常有必要,對於JWT有效時間最好設置短一點。

1.3.8 常見問題

① JWT 安全嗎?

Base64編碼方式是可逆的,也就是透過編碼後發放的Token內容是可以被解析的。一般而言,我們都不建議在有效載荷內放敏感訊息,比如使用者的密碼。

② JWT Payload 內容可以被偽造嗎?

JWT其中的一個組成內容為Signature,可以防止通過Base64可逆方法回推有效載荷內容並將其修改。因為Signature是經由Header跟Payload一起Base64組成的。

③ 如果我的 Cookie 被竊取了,那不就表示第三方可以做 CSRF 攻擊?

是的,Cookie丟失,就表示身份就可以被偽造。故官方建議的使用方式是存放在LocalStorage中,並放在請求頭中發送。

④ 空間及長度問題?

JWT Token通常長度不會太小,特別是Stateless JWT Token,把所有的數據都編在Token裡,很快的就會超過Cookie的大小(4K)或者是URL長度限制。

⑤ Token失效問題?

無狀態JWT令牌(Stateless JWT Token)發放出去之後,不能通過伺服器端讓令牌失效,必須等到過期時間過才會失去效用。

假設在這之間Token被攔截,或者有權限管理身份的差異造成授權Scope修改,都不能阻止發出去的Token失效並要求使用者重新請求新的Token。

1.3.9 JWT使用建議

Payload中的exp時效不要設定太長。開啟Only Http預防XSS攻擊。如果擔心重播攻擊(replay attacks )可以增加jti(JWT ID),exp(有效時間) Claim。在你的應用程式應用層中增加黑名單機制,必要的時候可以進行Block做阻擋(這是針對掉令牌被第三方使用竊取的手動防禦)。二:io.jsonwebtoken.jjwt

jwt使用流程

一般是在請求頭裡加入Authorization,並加上Bearer標註:

// Authorization: Bearer <token>

getToken('api/user/1', {

headers: {

'Authorization': 'Bearer ' + token

}

})

io.jsonwebtoken是最常用的工具包。

<dependency>

<groupId>io.jsonwebtoken</groupId>

<artifactId>jjwt</artifactId>

<version>0.9.1</version>

</dependency>

application.properties

jwt.secret=JO6HN3NGIU25G2FIG8V7VD6CK9B6T2Z5

jwt.expire=60000

JwtToken

@Configuration

public class JwtToken {

private static Logger logger = LoggerFactory.getLogger(JwtToken.class);

/** 秘鑰 */

@Value("${jwt.secret}")

private String secret;

/** 過期時間(秒) */

@Value("${jwt.expire}")

private long expire;

/**

* 生成jwt token

*/

public String generateToken(Long userId) {

Date nowDate = new Date();

Date expireDate = new Date(nowDate.getTime() + expire * 1000);

return Jwts.builder()

.setHeaderParam("typ", "JWT")

.setSubject(userId + "")

.setIssuedAt(nowDate)

.setExpiration(expireDate)

.signWith(SignatureAlgorithm.HS512, secret)

.compact();

}

public Claims getClaimByToken(String token) {

if (StringUtils.isEmpty(token)) {

return null;

}

String[] header = token.split("Bearer");

token = header[1];

try {

return Jwts.parser()

.setSigningKey(secret)

.parseClaimsJws(token)

.getBody();

}catch (Exception e){

logger.debug("validate is token error ", e);

return null;

}

}

/**

* token是否過期

* @return true:過期

*/

public static boolean isTokenExpired(Date expiration) {

return expiration.before(new Date());

}

// Getter && Setter

}

JwtController

@RestController

public class JwtController {

@Autowired

private JwtToken jwtToken;

@PostMapping("/login")

public String login(User user) {

// 1. 驗證用戶名和密碼

// 2. 驗證成功生成token

Long userId = 666L;

String token = jwtToken.generateToken(userId);

return token;

}

@GetMapping("/getUserInfo")

public String getUserInfo(@RequestHeader("Authorization") String authHeader) throws AuthenticationException {

// 黑名單token

List<String> blacklistToken = Arrays.asList("禁止訪問的token");

Claims claims = jwtToken.getClaimByToken(authHeader);

if (claims == null || JwtToken.isTokenExpired(claims.getExpiration()) || blacklistToken.contains(authHeader)) {

throw new AuthenticationException("token 不可用");

}

String userId = claims.getSubject();

// 根據用戶id獲取接口數據返回接口

return userId;

}

}

本號主要用於分享企業中常用的技術,更加側重於實用,歡迎關注,便於瀏覽其它更多實用的歷史文章。

相關焦點

  • SpringSecurity代碼實現JWT接口權限授予與校驗
    一、環境準備工作建立Spring Boot項目併集成了Spring Security,項目可以正常啟動通過controller寫一個HTTP的GET方法服務接口,比如:「/hello」實現最基本的動態數據驗證及權限分配,即實現UserDetailsService接口和UserDetails接口。
  • Spring Boot Admin快速打造監控平臺
    但比較遺憾的是沒有可視化界面,只能通過乾燥的json數據來查看相應的指標,如下圖: 今天我們介紹一個可視化的監控指標平臺Spring Boot Admin,它利用spring-boot-starter-actuator
  • SpringSecurity + JWT前後端分離架構實現
    --Token生成與解析--><dependency><groupId>io.jsonwebtoken</groupId><artifactId>jjwt</artifactId><version>0.9.0</version></dependency
  • Spring Security OAuth2.0認證授權五:用戶信息擴展到jwt
    令牌的時候就只存放了這麼多信息,我們到jwt.io網站上貼出jwt令牌查看下payload中內容就就知道有什麼內容了:本篇文章的目的就是為了解決該問題,把用戶信息(用戶名、頭像、手機號、郵箱等)放到jwt token中,經過網關解析之後攜帶用戶信息訪問目標服務,目標服務將用戶信息保存到上下文並保證線程安全性的情況下封裝成工具類提供給各種環境下使用。
  • Json Web Token(JWT)的使用
    什麼場景使用JSON Web TokensAuthorization:這個是最常用的場景,當用戶登錄後,服務端返回一個token,客戶端攜帶這個token就可以訪問token許可資源。Information Exchange:使用JWT可以在多個系統進行系統交換,因為JWT可以被加密。JWT的結構JWT的結構有以下三部分組成,用句號(.)分割。
  • 入門|egg.js 入門之egg-jwt
    ) => { const { controller, router, jwt } = app; //正常路由 router.post('/admin/login', controller.admin.login); /* * 這裡的第二個對象不再是控制器,而是 jwt 驗證對象,第三個地方才是控制器 * 只有在需要驗證 token 的路由才需要第二個 是 jwt 否則第二個對象為控制器
  • 侵入JSON Web Token(JWT)
    然而,若JWT出現異常,攻擊者可以通過多種方式繞過其安全機制來偽造token。更改算法類型攻擊者偽造token的方法之一是篡改頭部的alg欄位。如果應用程式不限制JWT使用的算法類型,攻擊者可能會通過指定算法破壞token的安全性。1. 不使用加密算法JWT支持將算法設定為「None」。
  • Spring Boot 2.4 第一個示例程序書寫代碼
    在默認情況下,Maven 會編譯 src/main/java 目錄中的原始碼(這個是與 Maven 使用的約定有關的,這個目錄結構可以修改,但是不建議修改,因為絕大部分人都會遵守這個約定)。根據 Maven 的原始碼約定,你需要按照下面的目錄路徑和文件名創建一個 Example.java 文件,完整的路徑如下: src/main/java/Example.java 。
  • 利用jwt 可以獲取用戶的額外信息?
    編寫自定義 token 增強器package com.javadaily.auth.security;import org.springframework.security.oauth2.common.DefaultOAuth2AccessToken;import org.springframework.security.oauth2.common.OAuth2AccessToken;
  • 使用Spring Boot,Angular 6和Maven構建Web應用程式
    項目結構如下:父POM的結構如下:現在,為tutorial-server配置POM,如下所示:請注意,我們已經為web模塊tutorial-web和Sprint Boot依賴項添加了依賴項。稍後我們將回到後端POM配置。讓我們看一下tutorial-web模塊POM 的配置。稍後我們會回到這個配置。
  • SpringBoot+GitLab+Docker+Jenkins實現持續集成下
    --web功能的起步依賴--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId
  • Spring Boot自動裝配原理源碼分析
    我們繼續點進getCandidateConfigurations,獲取候選的配置打開spring-boot-autoconfigure-2.2.4.RELEASE.jar/META-INF/spring.factories,文件部分類容如下,你可以點進去看看第22~145行,確實是124個全類名
  • JWT 使用 nimbus-jose-jwt 進行解碼
    常用的可以使用 OAuth0 提供的解碼包,你也可能會使用 nimbus-jose-jwt 包。Maven 配置參數為:<dependency><groupId>com.nimbusds</groupId><artifactId>nimbus-jose-jwt</artifactId><version>9.0.1</version>
  • Spring Boot 2.2.0 發布,性能提升、支持 Java 13
    Spring Boot 2.2.0 正式發布了,可從 repo.spring.io 或是 Maven Central 獲取。
  • Rocket-API 2.3.2 發布,基於 spring boot 的 API 敏捷開發框架
    功能新增或修改: 遠程部署重複判斷 添加mongo對象操作函數 mapping路徑匹配修改,解決restful下路徑可能會匹配執行邏輯錯誤問題 增加配置項 駝峰轉換配置 spring.rocket-api.map-underscore-to-camel-case
  • Spring 的 Controller 是單例還是多例?怎麼保證並發的安全
    我們下面來簡單的驗證下:package com.riemann.springbootdemo.controller;import org.springframework.context.annotation.Scope;import org.springframework.stereotype.Controller
  • 基於Spring Boot + MVC 之控制器Controller實現
    在src-main-java下面,找到com.zzfeng.springbootdemo這個包,在這個包上面右擊,再分別點擊New-Package,進入創建包的面板。在New Package面板上輸入包名controller,完成包的創建。創建成功後,會在com.zzfeng.springbootdemo下面出現一個名叫controller的包。
  • Springmvc框架對json的支持 Java程式設計師必看
    路徑當做請求處理了,於是我們必須不讓他處理這個請求,讓它對靜態資源放行需要進行如下配置在web.xml中我們添加幾條通過名為default的servlet處理的url-pattern,分別對應js和css文件。
  • Spring Boot 2.4 MacPorts 安裝 CLI
    你可以通過使用下面的命令來安裝 Spring Boot CLI:$ sudo port install spring-boot-cliMacPorts 和 Homebrew 其實是類似的一個包管理工具。Mac 算是BSD的一個變種。所以,BSD 的包管理軟體 port 被移植到 Mac 上就顯的理所當然了。