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

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

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

1. 什么是JWT

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

2. JWT的構(gòu)成

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

2.1 頭部（Header）

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

頭部可以被表示成一個(gè)JSON對象

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

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

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9

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

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

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

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

2.2 載荷（playload）

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

2.2.1 標(biāo)準(zhǔn)中注冊的聲明（建議但不強(qiáng)制使用）

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

2.2.2 公共的聲明

公共的聲明可以添加任何的信息，一般添加用戶的相關(guān)信息或其他業(yè)務(wù)需要的必要信息。但不建議添加敏感信息，因?yàn)樵摬糠衷诳蛻舳丝山饷?/p>

2.2.3 私有的聲明

私有聲明是提供者和消費(fèi)者所共同定義的聲明，一般不建議存放敏感信息，因?yàn)閎ase64是對稱解密的，意味著該部分信息可以歸類為明文信息

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

定義一個(gè)payload：

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

然后將其進(jìn)行base64加密，得到Jwt的第二部分：

eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9

2.3 簽證（signature）

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

header (base64后的)

payload (base64后的)

secret

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

TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ

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

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ

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

3. JJWT的介紹

JJWT是一個(gè)提供端到端的JWT創(chuàng)建和驗(yàn)證的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í)間
                // 設(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í)間
                // 設(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講解和工具類的詳細(xì)內(nèi)容，更多關(guān)于JWT講解與JJWT使用的資料請關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: