JWT

1、什么是JWT

jsonwebtoken (JWT)是一个开放标准(rfc7519),它定义了一种紧凑的、自包含的方式,用于在各方之间以JSON对象安全地传输信息。此信息可以验证和信任,因为它是数字签名的。jwt可以使用秘密(使用HNAC算法)或使用RSA或ECDSA的公钥/私钥对进行签名

JWT简称JSON Web Token,也就是通过JSON形式作为Web应用中的令牌,用于在各方之间安全地将信息作为JSON对象传输。在数据传输过程中还可以完成数据加密、签名等相关处理。

2、JWT能做什么

1、授权

这是使用JWT的最常见方案。一旦用户登录,每个后续请求将包括JWT,从而允许用户访问该令牌允许的路由,服务和资源。单点登录是兰今广泛使用JWT的一项功能,因为它的开销很小并且可以在不同的域中轻松使用。

2、信息交换

JSON Web Token是在各方之间安全地传输信息的好方法。因为可以对JWT进行签名《例如,使用公钥/私钥对)),所以您可以确保发件人是他们所说的人。此外,由于签名是使用标头和有效负载计算的,因此您还可以验证内容是否遭到篡改。

3、为什么要使用JWT

基于传统的Session的认证

我们知道,http协议本身是一种无状态的协议,而这就意味着如果用户向我们的应用提供了用户名和密码来进行用户认证,那么下一次请求时,用户还要再一次进行用户认证才行,因为根据http协议,我们并不能知道是哪个用户发出的请求,所以为了让我们的应用能识别是哪个用户发出的请求,我们只能在服务器存储一份用户登录的信息,这份登录信息会在响应时传递给浏览器,告诉其保存为cookie,以便下次请求时发送给我们的应用,这样我们的应用就能识别请求来自哪个用户了,这就是传统的基于session认证。

认证流程

image-20230503000416702

暴露问题

1.每个用户经过我们的应用认证之后,我们的应用都要在服务端做一次记录,以方便用户下次请求的鉴别,通常而言session都是保存在内存中,而随着认证用户的增多,服务端的开销会明显增大
⒉.用户认证之后,服务端做认证记录,如果认证的记录被保存在内存中的话,这意味着用户下次请求还必须要请求在这台服务器上,这样才能拿到授权的资源,这样在分布式的应用上,相应的限制了负载均衡器的能力。这也意味着限制了应用的扩展能力。
3.因为是基于cookie来进行用户识别的,cookie如果被截获,用户就会很容易受到跨站请求伪造的攻击。
4.在前后端分离系统中就更加痛苦:如下图所示、

也就是说前后端分离在应用解耦后增加了部署的复杂性。通常用户一次请求就要转发多次。如果用session 每次携带sessionid到服务器,服务器还要查询用户信息。同时如果用户很多。这些信息存储在服务器内存中,给服务器增加负担。还有就是CSRF(跨站伪造请求攻击)攻击,session是基于cookie进行用户识别的,cookie如果被截获,用户就会很容易受到跨站请求伪造的攻击。还有就是sessionid就是一个特征值,表达的信息不够丰富。不容易扩展。而且如果你后端应用是多节点部署。那么就需要实现session共享机制。不方便集群应用.

image-20230503000650722

基于JWT的认证

image-20230503001056817

认证流程

  • 首先,前端通过Web表单将自己的用户名和密码发送到后端的接口。这一过程一般是一个HTTP POST请求。建议的方式是通过SSL加密的传输(https协议),从而避免敏感信息被嗅探。
  • 后端核对用户名和密码成功后,将用户的id等其他信息作为JWT Payload(负载),将其与头部分别进行Base64编码拼接后签名形成一个JWT。形成的JWT就是一个形同111.ZZz.xxx的字符串。
  • 后端将JWT字符串作为登录成功的返回结果返回给前端。前端可以将返回的结果保存在localStorage或sessionStorage上,退出登录时前端删除保存的JWT即可。
  • 前端在每次请求时将JWT放入HTTP Header中的Authorization位。(解决XSS和XSRF问题)
  • 后端检查是否存在,如存在验证JWT的有效性。例如,检查签名是否正确;检查Token是否过期;检查Token的接收方是否是自己(可选)。
  • 验证通过后后端使用JWT中包含的用户信息进行其他逻辑操作,返回相应结果。

JWT优势

  • 简洁(Compact):可以通过URL,POST参数或者在HTTP header发送,因为数据量小,传输速度也很快

  • 自包含(Self-contained)︰负载中包含了所有用户所需要的信息,避免了多次查询数据库

  • 因为Token是以JSON加密的形式保存在客户端的,所以JWT是跨语言的,原则上任何web形式都支持。

  • 不需要在服务端保存会话信息,特别适用于分布式微服务。

4、JWT结构

令牌组成

  • 标头(Header)

  • 效载荷( Payload)

  • 签名(Signature)

因此,JWT通常如下所示:XXXX.yyyyy.ZZZZZ Header.Payload.Signature

标头通常由两部分组成∶令牌的类型(即JWT)和所使用的签名算法,例如HMAC SHA256或RSA。它会使用Base64 编码组成JWT结构的第一部分。

注意:Base64是一种编码,也就是说,它是可以被翻译回原来的样子来的。它并不是一种加密过程。

1
2
3
4
{
"alg" : "HS256",
"typ" : "JWT"
}

PayLoad

令牌的第二部分是有效负载,其中包含声明。声明是有关实体(通常是用户)和其他数据的声明。同样的,它会使用Base64编码组成JWT结构的第二部分

1
2
3
4
5
{
"sub" : "1234567890"",
"name" : "Jonn voe ,
"admin" : true
}

Signature

前面两部分都是使用Base64进行编码的,即前端可以解开知道里面的信息。Signature 需要使用编码后的 header和 payload以及我们提供的一个密钥,然后使用header 中指定的签名算法(HS256)进行签名。签名的作用是保证JWT没有被篡改过
如∶
HMACSHA256(base64UrlEncode(header) + “.” + base64Ur1Encode(payload) ,secret) ;

目的

最后一步签名的过程,实际上是对头部以及负载内容进行签名,防止内容被窜改。如果有人对头部以及负载的内容解码之后进行修改,再进行编码,最后加上之前的签名组合形成新的JWT的话,那么服务器端会判断出新的头部和负载形成的签名和JWT附带上的签名是不一样的。如果要对新的头部和负载进行签名,在不知道服务器加密时用的密钥的话,得出来的签名也是不一样的。

信息安全问题

在这里大家一定会问一个问题:Base64是一种编码,是可逆的,那么我的信息不就被暴露了吗?
是的。所以,在JWT中,不应该在负载里面加入任何敏感的数据。在上面的例子中,我们传输的是用户的User ID。这个值实际上不是什么敏感内容,一般情况下被知道也是安全的。但是像密码这样的内容就不能被放在JWT中了。如果将用户的密码放在了JWT中,那么怀有恶意的第三方通过Base64解码就能很快地知道你的密码了。因此JWT适合用于向Web应用传递一些非敏感信息。JWT还经常用于设计用户认证和授权系统,甚至实现Web应用的单点登录。

未编码

image-20230503004929099

编码后

image-20230503004959206

5、JWT使用

导入依赖

1
2
3
4
5
<dependency>
<groupId>com.auth0</groupId>
<artifactId>java-jwt</artifactId>
<version>3.4.0</version>
</dependency>

获取token

1
2
3
4
5
6
7
8
9
HashMap<String, Object> map = new HashMap<String, Object>();//定义JWT header信息
Calendar calendar=Calendar.getInstance(); //创建日期实例
calendar.add(Calendar.SECOND,20); //定义过期时间

String token = JWT.create().withHeader(map) //header
.withClaim("userid", "123") //payload
.withClaim("username", "xiaohei")
.withExpiresAt(calendar.getTime()) //令牌过期时间
.sign(Algorithm.HMAC256("@12#$3ASD#%!@"));//签名

打印结果为

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.

eyJleHAiOjE2ODMwODU5NjMsInVzZXJpZCI6IjEyMyIsInVzZXJuYW1lIjoieGlhb2hlaSJ9

.tLEZvQMB1Cp1aKNLe302Paor3_oc_Q_LvpSR6KnDbhw

header和payload用base64解码后得

image-20230503115836413image-20230503115904030

如何获取Token中的信息呢?

1
2
3
4
5
6
7
//创建验证对象
JWTVerifier jwtVerifier = JWT.require(Algorithm.HMAC256("@12#$3ASD#%!@")).build();
//获取Token解密对象
DecodedJWT verify = jwtVerifier.verify("eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2ODMxNjQ3MTgsInVzZXJpZCI6IjEyMyIsInVzZXJuYW1lIjoieGlhb2hlaSJ9.TGhqhVjm4eyjeuAgtx3s5FYA-Balg6lEuSztBp-bhkQ");
System.out.println(verify.getClaim("username").asString()); //根据存储对象的key值获取value,以存入的数值类型来接收
System.out.println(verify.getClaim("userid").asString());
System.out.println(verify.getExpiresAt()); //查询过期时间

image-20230503141509608

封装JWT工具类

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/**
* @author : 15754
* @version 1.0.0
* @since : 2023/5/3 14:22
**/
public class JWTUtils {

/**
* 生成token,header,payload,signature
* */
private static final String SIGN="@12#$3ASD#%!@";

public static String getToken(HashMap<String, String> map){
//设置默认时间
Calendar calendar=Calendar.getInstance();
calendar.add(Calendar.DATE,7);
//创建JWT实例
JWTCreator.Builder builder = JWT.create();
//将Payload传入JWT实例中
map.forEach((k,v)->{
builder.withClaim(k,v);
});
//设置过期时间
String token = builder.withExpiresAt(calendar.getTime()).sign(Algorithm.HMAC256(SIGN));

return token;
}
/**
* 验证token
* */
public static void verify(String token){
DecodedJWT decodedJWT = JWT.require(Algorithm.HMAC256(SIGN)).build().verify(token);
}

/**
* 获取token中的信息
* */
public static DecodedJWT getToken(String token){
DecodedJWT decodedJWT = JWT.require(Algorithm.HMAC256(SIGN)).build().verify(token);
return decodedJWT;
}
}

6、整合SpringBoot

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
    <dependencies>
<!--SpringBoot整合Mybatis-->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.3</version>
</dependency>

<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.12</version>
</dependency>
<!--添加druid数据源-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.19</version>
</dependency>
<!--整合mysql-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.32</version>
</dependency>

<!--导入SPringBoot web依赖-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--导入JWT-->
<dependency>
<groupId>com.auth0</groupId>
<artifactId>java-jwt</artifactId>
<version>3.4.0</version>
</dependency>


<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>


<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring-boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>

在业务中,首次登录成功时需要生成token,以便于其他请求的认证

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
@PostMapping("/login")
public Map<String,Object> Login(@RequestBody User user, HttpServletRequest request){
log.info(user.getUsername());
log.info(user.getPassword());
Map<String,Object> map=new HashMap<>();

try {
User userDB = userService.Login(user);
HashMap<String, String> payload = new HashMap<>();
payload.put("id",String.valueOf(user.getId()));
payload.put("username",user.getUsername());
String token = JWTUtils.getToken(payload);
map.put("token",token);
map.put("state",true);
map.put("msg","登录成功");
}
catch (Exception e){
map.put("state",false);
map.put("msg",e.getCause());
}
return map;
}

在每次请求时总不能一直要写一个验证token的方法,所以我们配置拦截器

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
public class JWTInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
HashMap<String, Object> map = new HashMap<>();
String token = request.getHeader("token"); //从请求头中获取token
try {
JWTUtils.verify(token); 验证token
return true;
}
catch (Exception e){
e.printStackTrace();
map.put("msg","出错了TOKEN");
}
map.put("state",false);
String json = new ObjectMapper().writeValueAsString(map); //将 map转为json
response.setContentType("application/json;charset=UTF-8"); //设置json格式
response.getWriter().println(json);
return false;
}
}

将拦截器添加到配置中

1
2
3
4
5
6
7
8
public class InterceptorConfig implements WebMvcConfigurer {
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(new JWTInterceptor())
.addPathPatterns("/**") //拦截所有请求
.excludePathPatterns("/login"); //放行登录请求
}
}

需要权限校验的请求

1
2
3
4
5
6
7
@PostMapping("/user/test")
public Map<String,Object> testDemo(){
HashMap<String, Object> map = new HashMap<>();
map.put("state",true);
map.put("msg","请求成功");
return map;
}

测试:

首次登录

image-20230504004955472

未将token放入请求头中

image-20230504005104455

将token放入请求头后

image-20230504005132001