Maven坐标
<dependency> <groupId>io.jsonwebtoken</groupId> <artifactId>jjwt</artifactId> <version>${jjwt}</version>
</dependency>
生成jwt
-
指定签名的时候使用的签名算法
-
SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256;
-
构建 JWT:使用 Jwts.builder() 创建一个 JWT 构建器对象,并进行三项核心设置:
-
设置自定义声明:
.setClaims(claims)将用户提供的自定义信息添加到令牌中 -
设置签名信息:
.signWith(signatureAlgorithm, secretKey.getBytes(StandardCharsets.UTF_8))使用指定算法和密钥生成签名
编码处理:密钥在使用前通过
getBytes(StandardCharsets.UTF_8)转换为 UTF-8 编码的字节数组,确保跨平台一致性。- 设置过期时间:
.setExpiration(exp)设置令牌的有效期
-
-
生成最终令牌:通过
builder.compact()方法将构建的 JWT 对象序列化为最终的字符串形式。
/*** 生成jwt* 使用Hs256算法, 私匙使用固定秘钥** @param secretKey jwt秘钥* @param ttlMillis jwt过期时间(毫秒)* @param claims 设置的信息* @return*/
public static String createJWT(String secretKey, long ttlMillis, Map<String, Object> claims) {// 指定签名的时候使用的签名算法,也就是header那部分SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256;// 生成JWT的时间long expMillis = System.currentTimeMillis() + ttlMillis;Date exp = new Date(expMillis);// 设置jwt的bodyJwtBuilder builder = Jwts.builder()// 如果有私有声明,一定要先设置这个自己创建的私有的声明,这个是给builder的claim赋值,一旦写在标准的声明赋值之后,就是覆盖了那些标准的声明的.setClaims(claims)// 设置签名使用的签名算法和签名使用的秘钥.signWith(signatureAlgorithm, secretKey.getBytes(StandardCharsets.UTF_8))// 设置过期时间.setExpiration(exp);return builder.compact();
}
解析jwt
-
创建解析器: 通过
Jwts.parser()创建一个 JWT 解析器实例 -
设置验证密钥: 使用
setSigningKey()方法设置用于验证签名的密钥,这里同样将密钥转换为 UTF-8 编码的字节数组 -
解析并验证令牌: 调用
parseClaimsJws(token)方法解析令牌,这个方法会自动验证:-
令牌的签名是否有效(使用提供的密钥)
-
令牌是否已过期
-
令牌的格式是否正确
-
-
获取声明信息: 通过
getBody()方法获取令牌中包含的所有声明信息
/*** Token解密** @param secretKey jwt秘钥 此秘钥一定要保留好在服务端, 不能暴露出去, 否则sign就可以被伪造, 如果对接多个客户端建议改造成多个* @param token 加密后的token* @return*/
public static Claims parseJWT(String secretKey, String token) {// 得到DefaultJwtParserClaims claims = Jwts.parser()// 设置签名的秘钥.setSigningKey(secretKey.getBytes(StandardCharsets.UTF_8))// 设置需要解析的jwt.parseClaimsJws(token).getBody();return claims;
}
映射配置
sky:jwt:# 设置jwt签名加密时使用的秘钥admin-secret-key: itcast# 设置jwt过期时间admin-ttl: 7200000# 设置前端传递过来的令牌名称admin-token-name: token# 登录用户jwt的配置信息user-secret-key: itcastuser-ttl: 7200000# 设置前端传递过来的令牌名称user-token-name: authentication
创建一个JwtProperties类进行配置映射
@Component
@ConfigurationProperties(prefix = "sky.jwt")
@Data
public class JwtProperties {/*** 管理端员工生成jwt令牌相关配置*/private String adminSecretKey;private long adminTtl;private String adminTokenName;/*** 用户端微信用户生成jwt令牌相关配置*/private String userSecretKey;private long userTtl;private String userTokenName;}
