如何使用JJWT及JWT講解和工具類

更新時間：2021年09月04日 14:48:04 作者：枯木何日可逢春

關(guān)于JWT的文章網(wǎng)上已經(jīng)多如牛毛了，但是相信很多同學學的還是云里霧里，所以在我學習JWT之后盡量用最簡潔的描述寫下這篇文章用于日后復習，與此同時也希望可以幫助同學們共同進步

1. 什么是JWT

JSON Web Token（JWT）是一個輕量級的認證規(guī)范，這個規(guī)范允許我們使用JWT在用戶和服務器之間傳遞安全可靠的信息。其本質(zhì)是一個token，是一種緊湊的URL安全方法，用于在網(wǎng)絡(luò)通信的雙方之間傳遞。

2. JWT的構(gòu)成

一個JWT實際上就是一個字符串，它由三部分組成：頭部、載荷與簽名

2.1 頭部（Header）

頭部用于描述關(guān)于該JWT的最基本的信息，例如其類型以及簽名所用的算法等

頭部可以被表示成一個JSON對象

{"typ":"JWT","alg":"HS256"}

在頭部指明了簽名算法是HS256算法。我們進行BASE64編碼，編碼后的字符串如下：

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9

Base64是一種基于64個可打印字符來表示二進制數(shù)據(jù)的表示方法。

由于2的6次方等于64，所以每6個比特為一個單元，對應某個可打印字符。

三個字節(jié)有24個比特，對應于4個Base64單元，即3個字節(jié)需要用4個可打印字符來表示。

JDK 中提供了非常方便的 BASE64Encoder 和 BASE64Decoder，用它們可以非常方便的完成基于 BASE64 的編碼和解碼

2.2 載荷（playload）

載荷是存放有效信息的地方，這些有效信息包含三個部分：

2.2.1 標準中注冊的聲明（建議但不強制使用）

iss: jwt簽發(fā)者
sub: jwt所面向的用戶
aud: 接收jwt的一方
exp: jwt的過期時間，這個過期時間必須要大于簽發(fā)時間
nbf: 定義在什么時間之前，該jwt都是不可用的.
iat: jwt的簽發(fā)時間
jti: jwt的唯一身份標識，主要用來作為一次性token,從而回避重放攻擊。

2.2.2 公共的聲明

公共的聲明可以添加任何的信息，一般添加用戶的相關(guān)信息或其他業(yè)務需要的必要信息。但不建議添加敏感信息，因為該部分在客戶端可解密

2.2.3 私有的聲明

私有聲明是提供者和消費者所共同定義的聲明，一般不建議存放敏感信息，因為base64是對稱解密的，意味著該部分信息可以歸類為明文信息

比如下面舉例中的admin和name都屬于自定的claim。這些claim跟JWT標準規(guī)定的claim區(qū)別在于：JWT規(guī)定的claim，JWT的接收方在拿到JWT之后，都知道怎么對這些標準的claim進行驗證；而private claims不會驗證，除非明確告訴接收方要對這些claim進行驗證以及驗證的規(guī)則

定義一個payload：

{"sub":"1234567890","name":"John Doe","admin":true}

然后將其進行base64加密，得到Jwt的第二部分：

eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9

2.3 簽證（signature）

JWT的第三部分是一個簽證信息，這個簽證信息由三部分組成：

header (base64后的)

payload (base64后的)

secret

這個部分需要base64加密后的header和base64加密后的payload使用.連接組成的字符串，然后通過header中聲明的加密方式進行加鹽secret組合加密，然后就構(gòu)成了jwt的第三部分：

TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ

將這三部分用.連接成一個完整的字符串,構(gòu)成了最終的jwt：

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ

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

3. JJWT的介紹

JJWT是一個提供端到端的JWT創(chuàng)建和驗證的Java庫

官方文檔：https://github.com/jwtk/jjwt

4. JJWT的使用

<!--鑒權(quán)-->
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt</artifactId>
    <version>0.9.0</version>
</dependency>

import com.sun.scenario.effect.impl.sw.sse.SSEBlend_SRC_OUTPeer;
import io.jsonwebtoken.Claims;
import io.jsonwebtoken.JwtBuilder;
import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.SignatureAlgorithm;
import java.util.Date;
import java.util.HashMap;
public class TestJWT {
    public static void main(String[] args) {
        testCreateJWT();
        testParseJWT();
    }
    public static void testCreateJWT() {
        JwtBuilder builder = Jwts.builder()
                .setId("404")                   // 設(shè)置唯一編號
                .setSubject("邢立豹")            // 設(shè)置主題 可以是JSON數(shù)據(jù)
                .setIssuedAt(new Date())        // 設(shè)置簽發(fā)日期
                // .setExpiration(new Date())      // 設(shè)置過期時間
                // 設(shè)置簽名 使用HS256算法 并設(shè)置SecretKey(字符串)
                .signWith(SignatureAlgorithm.HS256, "LICHUN");
        HashMap<String, Object> userInfo = new HashMap<>();
        userInfo.put("name","枯木何日可逢春");
        userInfo.put("age", "21");
        builder.addClaims(userInfo);
        System.out.println(builder.compact());
    }
    public static void testParseJWT() {
        String str = "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI0MDQiLCJzdWIiOiLpgqLnq4vosbkiLCJpYXQiOjE2MzA2ODAzNTMsImV4cCI6MTYzMDY4MDM1MywibmFtZSI6Iuaer-acqOS9leaXpeWPr-mAouaYpSIsImFnZSI6IjIxIn0.59i5xfLz9A-wTOJI9KxkF7zqp4zsLEWRC5DYlcy_Akc";
        Claims claims = Jwts.parser()
                .setSigningKey("LICHUN")
                .parseClaimsJws(str)
                .getBody();
        System.out.println(claims);
    }
}

5. JWT工具類

package com.lichun.utils;
import io.jsonwebtoken.Claims;
import io.jsonwebtoken.JwtBuilder;
import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.SignatureAlgorithm;
import javax.crypto.SecretKey;
import javax.crypto.spec.SecretKeySpec;
import java.util.Base64;
import java.util.Date;
public class JWTUtil {
    // 有效期
    public static final Long JWT_TTL = 3600000L;
    // JWT令牌信息
    public static final String JWT_KEY = "LICHUN";
    public static String createJWT(String id, String subject, Long ttlMillis) {
        SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256;
        long nowMillis = System.currentTimeMillis();
        Date now = new Date(nowMillis);
        if (ttlMillis == null) {
            ttlMillis = JWT_TTL;
        }
        long expMillis = nowMillis + ttlMillis;
        Date expDate = new Date(expMillis);
        SecretKey secretKey = generalKey();
        JwtBuilder builder = Jwts.builder()
                .setId(id)                      // 設(shè)置唯一編號
                .setSubject(subject)            // 設(shè)置主題 可以是JSON數(shù)據(jù)
                .setIssuer("admin")
                .setIssuedAt(now)               // 設(shè)置簽發(fā)日期
                .setExpiration(expDate)         // 設(shè)置過期時間
                // 設(shè)置簽名 使用HS256算法 并設(shè)置SecretKey(字符串)
                .signWith(SignatureAlgorithm.HS256, secretKey);
        return builder.compact();
    }
    /**
     * 生成加密secretKey
     * @return
     */
    public static SecretKey generalKey() {
        byte[] encodedKey = Base64.getEncoder().encode(JWT_KEY.getBytes());
        SecretKey key = new SecretKeySpec(encodedKey, 0, encodedKey.length, "AES");
        return key;
    }
    /**
     * 解析令牌數(shù)據(jù)
     */
    public static Claims parseJWT(String jwt) throws Exception {
        SecretKey secretKey = generalKey();
        return Jwts.parser()
                .setSigningKey(secretKey)
                .parseClaimsJws(jwt)
                .getBody();
    }
}

以上就是如何使用JJWT及JWT講解和工具類的詳細內(nèi)容，更多關(guān)于JWT講解與JJWT使用的資料請關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: