如何基于JWT實(shí)現(xiàn)接口的授權(quán)訪問詳解
什么是JWT
JWT(JSON Web Token)是一個(gè)開放標(biāo)準(zhǔn)(RFC 7519),它定義了一種緊湊且獨(dú)立的方式,可以在各個(gè)系統(tǒng)之間用JSON作為對象安全地傳輸信息,并且可以保證所傳輸?shù)男畔⒉粫?huì)被篡改。
JWT通常有兩種應(yīng)用場景:
- 授權(quán)。這是最常見的JWT使用場景。一旦用戶登錄,每個(gè)后續(xù)請求將包含一個(gè)JWT,作為該用戶訪問資源的令牌。
- 信息交換??梢岳肑WT在各個(gè)系統(tǒng)之間安全地傳輸信息,JWT的特性使得接收方可以驗(yàn)證收到的內(nèi)容是否被篡改。
本文討論第一點(diǎn),如何利用JWT來實(shí)現(xiàn)對API的授權(quán)訪問。這樣就只有經(jīng)過授權(quán)的用戶才可以調(diào)用API。
JWT的結(jié)構(gòu)

JWT由三部分組成,用.分割開。
Header
第一部分為Header,通常由兩部分組成:令牌的類型,即JWT,以及所使用的加密算法。
{
"alg": "HS256",
"typ": "JWT"
}Base64加密后,就變成了:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
Payload
第二部分為Payload,里面可以放置自定義的信息,以及過期時(shí)間、發(fā)行人等。
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}Base64加密后,就變成了:
eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ
Signature
第三部分為Signature,計(jì)算此簽名需要四部分信息:
- Header里的算法信息
- Header
- Payload
- 一個(gè)自定義的秘鑰
接受到JWT后,利用相同的信息再計(jì)算一次簽名,然年與JWT中的簽名對比,如果不相同則說明JWT中的內(nèi)容被篡改。
解碼后的JWT

?將上面三部分都編碼后再合在一起就得到了JWT。
需要注意的是,JWT的內(nèi)容并不是加密的,只是簡單的Base64編碼。 也就是說,JWT一旦泄露,里面的信息可以被輕松獲取,因此不應(yīng)該用JWT保存任何敏感信息。
JWT是怎樣工作的

- 應(yīng)用程序或客戶端向授權(quán)服務(wù)器請求授權(quán)。這里的授權(quán)服務(wù)器可以是單獨(dú)的一個(gè)應(yīng)用,也可以和API集成在同一個(gè)應(yīng)用里。
- 授權(quán)服務(wù)器向應(yīng)用程序返回一個(gè)JWT。
- 應(yīng)用程序?qū)WT放入到請求里(通常放在HTTP的Authorization頭里)
- 服務(wù)端接收到請求后,驗(yàn)證JWT并執(zhí)行對應(yīng)邏輯。
在JAVA里使用JWT
引入依賴
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt</artifactId>
</dependency>這里使用了一個(gè)叫JJWT(Java JWT)的庫。
JWT Service
生成JWT
public String generateToken(String payload) {
return Jwts.builder()
.setSubject(payload)
.setExpiration(new Date(System.currentTimeMillis() + 10000))
.signWith(SignatureAlgorithm.HS256, SECRET_KEY)
.compact();
}- 這里設(shè)置過期時(shí)間為10秒,因此生成的JWT只在10秒內(nèi)能通過驗(yàn)證。
- 需要提供一個(gè)自定義的秘鑰。
解碼JWT
public String parseToken(String jwt) {
return Jwts.parser()
.setSigningKey(SECRET_KEY)
.parseClaimsJws(jwt)
.getBody()
.getSubject();
}解碼時(shí)會(huì)檢查JWT的簽名,因此需要提供秘鑰。
驗(yàn)證JWT
public boolean isTokenValid(String jwt) {
try {
parseToken(jwt);
} catch (Throwable e) {
return false;
}
return true;
}JWT并沒有提供判斷JWT是否合法的方法,但是在解碼非法JWT時(shí)會(huì)拋出異常,因此可以通過捕獲異常的方式來判斷是否合法。
注冊/登錄
@GetMapping("/registration")
public String register(@RequestParam String username, HttpServletResponse response) {
String jwt = jwtService.generateToken(username);
response.setHeader(JWT_HEADER_NAME, jwt);
return String.format("JWT for %s :\n%s", username, jwt);
}- 需要為還沒有獲取到JWT的用戶提供一個(gè)這樣的注冊或者登錄入口,來獲取JWT。
- 獲取到響應(yīng)里的JWT后,要在后續(xù)的請求里包含JWT,這里放在請求的Authorization頭里。
驗(yàn)證JWT
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
HttpServletRequest httpServletRequest = (HttpServletRequest) request;
HttpServletResponse httpServletResponse = (HttpServletResponse) response;
String jwt = httpServletRequest.getHeader(JWT_HEADER_NAME);
if (WHITE_LIST.contains(httpServletRequest.getRequestURI())) {
chain.doFilter(request, response);
} else if (isTokenValid(jwt)) {
updateToken(httpServletResponse, jwt);
chain.doFilter(request, response);
} else {
httpServletResponse.sendError(HttpServletResponse.SC_UNAUTHORIZED);
}
}
private void updateToken(HttpServletResponse httpServletResponse, String jwt) {
String payload = jwtService.parseToken(jwt);
String newToken = jwtService.generateToken(payload);
httpServletResponse.setHeader(JWT_HEADER_NAME, newToken);
}- 將驗(yàn)證操作放在Filter里,這樣除了登錄入口,其它的業(yè)務(wù)代碼將感覺不到JWT的存在。
- 將登錄入口放在WHITE_LIST里,跳過對這些入口的驗(yàn)證。
- 需要刷新JWT。如果JWT是合法的,那么應(yīng)該用同樣的Payload來生成一個(gè)新的JWT,這樣新的JWT就會(huì)有新的過期時(shí)間,用此操作來刷新JWT,以防過期。
- 如果使用Filter,那么刷新的操作要在調(diào)用doFilter()之前,因?yàn)檎{(diào)用之后就無法再修改response了。
API
private final static String JWT_HEADER_NAME = "Authorization";
@GetMapping("/api")
public String testApi(HttpServletRequest request, HttpServletResponse response) {
String oldJwt = request.getHeader(JWT_HEADER_NAME);
String newJwt = response.getHeader(JWT_HEADER_NAME);
return String.format("Your old JWT is:\n%s \nYour new JWT is:\n%s\n", oldJwt, newJwt);
}這時(shí)候API就處于JWT的保護(hù)下了。API可以完全不用感知到JWT的存在,同時(shí)也可以主動(dòng)獲取JWT并解碼,以得到JWT里的信息。如上所示。
參考資料:jwt.io/
總結(jié)
到此這篇關(guān)于如何基于JWT實(shí)現(xiàn)接口的授權(quán)訪問的文章就介紹到這了,更多相關(guān)JWT接口的授權(quán)訪問內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Redis中4種延時(shí)隊(duì)列實(shí)現(xiàn)方式小結(jié)
Redis作為高性能的內(nèi)存數(shù)據(jù)庫,具備原子操作、數(shù)據(jù)結(jié)構(gòu)豐富和簡單易用的特性,本文將介紹基于Redis實(shí)現(xiàn)分布式延時(shí)隊(duì)列的四種方式,大家可以根據(jù)需要進(jìn)行選擇2025-04-04
Spring中@Autowired和@Qualifier注解的3個(gè)知識點(diǎn)小結(jié)
這篇文章主要介紹了Spring中@Autowired和@Qualifier注解的3個(gè)知識點(diǎn)小結(jié),具有很好的參考價(jià)值,希望對大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-09-09
mybatis中數(shù)據(jù)加密與解密的實(shí)現(xiàn)
數(shù)據(jù)加解密的實(shí)現(xiàn)方式多種多樣,在mybatis環(huán)境中數(shù)據(jù)加解密變得非常簡單易用,本文主要介紹了mybatis中數(shù)據(jù)加密與解密的實(shí)現(xiàn),文中通過示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-03-03
Java中構(gòu)造函數(shù),set/get方法和toString方法使用及注意說明
這篇文章主要介紹了Java中構(gòu)造函數(shù),set/get方法和toString方法的使用及注意說明,具有很好的參考價(jià)值,希望對大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-01-01
Java開發(fā)實(shí)現(xiàn)人機(jī)猜拳游戲
這篇文章主要為大家詳細(xì)介紹了Java開發(fā)實(shí)現(xiàn)人機(jī)猜拳游戲,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2020-08-08
maven-surefire-plugin總結(jié)示例詳解
這篇文章主要介紹了maven-surefire-plugin總結(jié),本文通過實(shí)例代碼給大家介紹的非常詳細(xì),對大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2023-07-07
Java微信公眾平臺開發(fā)(2) 微信服務(wù)器post消息體的接收
這篇文章主要為大家詳細(xì)介紹了Java微信公眾平臺開發(fā)第二步,微信服務(wù)器post消息體的接收,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-04-04

