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

2021-01-12 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;

}

}

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

相關焦點

  • 在實戰中學習Springboot+Security+redis+jwt的登錄流程
    </groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!
  • 前後端分離必備, Golang Gin中如何使用JWT(JsonWebToken)中間件?
    本文介紹如何在Golang Gin Web框架中使用JWT認證中間件以及模擬測試, 以供參考, 關於JWT詳細原理可以參考: JWT RFC: https://tools.ietf.org/html/rfc7519 JWT IETF: http://self-issued.info/docs/draft-ietf-oauth-json-web-token.html
  • Spring Boot與Shiro整合實現用戶認證
    編寫Shiro配置類(*)package com.itheima.shiro;import org.apache.shiro.spring.web.ShiroFilterFactoryBean;import org.apache.shiro.web.mgt.DefaultWebSecurityManager
  • SpringSecurity代碼實現JWT接口權限授予與校驗
    一、環境準備工作建立Spring Boot項目併集成了Spring Security,項目可以正常啟動通過controller寫一個HTTP的GET方法服務接口,比如:「/hello」實現最基本的動態數據驗證及權限分配,即實現UserDetailsService接口和UserDetails接口。
  • Json Web Token(JWT)的使用
    什麼場景使用JSON Web TokensAuthorization:這個是最常用的場景,當用戶登錄後,服務端返回一個token,客戶端攜帶這個token就可以訪問token許可資源。Information Exchange:使用JWT可以在多個系統進行系統交換,因為JWT可以被加密。JWT的結構JWT的結構有以下三部分組成,用句號(.)分割。
  • SpringSecurity + JWT前後端分離架構實現
    --Token生成與解析--><dependency><groupId>io.jsonwebtoken</groupId><artifactId>jjwt</artifactId>
  • 侵入JSON Web Token(JWT)
    然而,若JWT出現異常,攻擊者可以通過多種方式繞過其安全機制來偽造token。更改算法類型攻擊者偽造token的方法之一是篡改頭部的alg欄位。如果應用程式不限制JWT使用的算法類型,攻擊者可能會通過指定算法破壞token的安全性。1. 不使用加密算法JWT支持將算法設定為「None」。
  • 基礎篇:Spring Boot入門體驗(圖文教程)
    在 【main/java/com.xpwi.springboot】包下新建一個【HelloController】:packagecom.xpwi.springboot;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.bind.annotation.RestController
  • Spring Boot 快速入門教程(附詳細圖文)
    用大佬的話來理解,就是 spring boot 其實不是什麼新的框架,它默認配置了很多框架的使用方式,就像 maven 整合了所有的 jar 包,spring boot 整合了所有的框架,總結一下及幾點:(1)為所有 Spring 開發提供一個更快更廣泛的入門體驗。(2)零配置。無冗餘代碼生成和XML 強制配置,遵循「約定大於配置」 。
  • 入門|egg.js 入門之egg-jwt
    ) => { const { controller, router, jwt } = app; //正常路由 router.post('/admin/login', controller.admin.login); /* * 這裡的第二個對象不再是控制器,而是 jwt 驗證對象,第三個地方才是控制器 * 只有在需要驗證 token 的路由才需要第二個 是 jwt 否則第二個對象為控制器
  • springboot+springsecurity實現前後端分離簡單實現!
    1.2、技術支持jdk 1.8、springboot 2.3.4、mybatis-plus 3.4.1、mysql 5.5、springsecurity 5.3.4、springmvc、lombok簡化entity代碼,不用你去寫get、set方法,全部自動生成、gson 2.8.2 將json對象轉化成json字符串
  • SpringBoot:搭建第一個Web程序
    本文簡單介紹一下spingBoot搭建web程序的流程,希望對入門學習spingBoot的朋友有所幫助。本文採用的開發工具是IDEA。1、打開IDEA,創建項目。5、點擊下一步,咱們只需要創建一個基礎的web項目只需要按照下圖勾選相應的依賴就可以了。6、選擇好依賴後,然後點擊下一步,進入如下頁面:7、然後點擊Finish,一個spingboot的基本工程就創建完成了。
  • Spring Boot面試題(2020最新版)
    當然這只是一個建議的組合,單純從技術上來說,無論怎麼組合,都是沒有問題的。我們使用cookie存放用戶登錄的信息,在spring攔截器進行權限控制,當權限不符合時,直接返回給用戶固定的json結果。當用戶登錄以後,正常使用;當用戶退出登錄狀態時或者token過期時,由於攔截器和跨域的順序有問題,出現了跨域的現象。
  • 利用jwt 可以獲取用戶的額外信息?
    .common.DefaultOAuth2AccessToken;import org.springframework.security.oauth2.common.OAuth2AccessToken;import org.springframework.security.oauth2.provider.OAuth2Authentication;import org.springframework.security.oauth2
  • 理解JWT的使用場景和優劣
    如果覺得比較抽象,不妨用傳統的 session+cookie 單點登錄方案來做類比,通常我們可以選擇 spring security(身份認證和權限管理的安全框架)和 spring session(session 共享)來構建,而選擇用 jwt 設計單點登錄系統需要解決很多傳統方案中同樣存在和本不存在的問題,以下一一詳細羅列。jwt token洩露了怎麼辦?
  • springboot2.1.5集成fineReport報表工具
    集成jar首先將fineReport提供集成的jar包,加入本地倉庫中代碼如下:call mvn install:install-file -Dfile=F:\FineReport_9.0\WebReport\WEB-INF\lib\fr-core-9.0.jar -DgroupId
  • SpringBoot+GitLab+Docker+Jenkins實現持續集成下
    --web功能的起步依賴--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId
  • Spring Boot實現定時任務新解,你是否能get到?
    在日常的開發過程中經常使用到定時任務,在springMVC的開發中,經常和quartz框架進行集成使用,但在springboot中沒有這麼做,而是使用了java的線程池來實現定時任務。一、概述在springboot中使用定時任務非常簡單,只需要簡單的幾步即可完成。