我的个人主页:https://wk-blog.vip
第一章、什么是 JWT
JSON Web Token (JWT) is an open standard (RFC 7519) that defines a compact and self-contained way for securely transmitting information between parties as a JSON object. This information can be verified and trusted because it is digitally signed. JWTs can be signed using a secret (with the HMAC algorithm) or a public/private key pair using RSA or ECDSA.
1. 翻译
- 官网地址:https://jwt.io/
- 翻译: json web token (JwT)是一个开放标准(rfc7519),它定义了一种紧凑的、自包含的方式,用于在各方之间以JSON对象安全地传输信息。此信息可以验证和信任,因为它是数字签名的。jwt可以使用秘密(使用HMAC算法)或使用 RSA 或 ECDSA 的 公钥/私钥对 进行签名
2.通俗解释
- JWT简称:JSON Web Token ,也就是通过JSON形式作为Web应用中的令牌,用于在各方之间安全地将信息作为JSON对象传输。在数据传榆过程中还可以完成数据加密、签名等相关处理。
第二章、JWT 能做什么
1.授权
- 这是使用 JWT 的最常见方案,一旦用户登录,每个后续请求将包括 JWT,从而允许用户访问该令牌允许的路由,服务和资源。单点登录是当今广泛使用 JWT 的一项功能,因为它的开销很小并且可以在不同的域中轻松使用
2.信息交换
- JSON Web Token是在各方之间安全地传输信息的好方法。因为可以对JWT进行签名《例如,使用公钥/私钥对),所以您可以确保发件人是他们所说的人。此外,由于签名是使用标头和有效负载计算的,因此您还可以验证内容是否遭到篡改。
第三章、为什么是 JWT
1、基于传统的 Session 认证
1.认证方式
- 我们知道,http协议本身是一种无状态的协议,而这就意味着如果用户向我们的应用提供了用户名和密码来进行用户认证,那么下一次请求时,用户还要再一次进行用户认证才行,因为根据http协议,我们并不能知道是哪个用户发出的请求,所以为了让我们的应用能识别是哪个用户发出的请求,我们只能在服务器存储一份用户登录的信息,这份登录信息会在响应时传递给浏览器,告诉其保存为cookie,以便下次请求时发送给我们的应用,这样我们的应用就能识别请求来自哪个用户了,这就是传统的基于session认证。
2.认证流程
3.暴露问题
每个用户经过我们的应用认证之后,我们的应用都要在服务端做一次记录,以方便用户下次请求的鉴别,通常而言session都是保存在内存中,而随着认证用户的增多,服务端的开销会明显增大
用户认证之后,服务端做认证记录,如果认证的记录被保存在内存中的话,这意味着用户下次请求还必须要请求在这台服务器上,这样才能拿到授权的资源,这样在分布式的应用上,相应的限制了负载均衡器的能力。这也意味着限制了应用的扩展能力。
因为是基于cookie来进行用户识别的, cookie如果被截获,用户就会很容易受到跨站请求伪造的攻击。
在前后端分离系统中就更加痛苦:如下图所示:
也就是说前后端分离在应用解耦后增加了部署的复杂性。通常用户一次请求就要转发多次。如果用session每次携带sessionid到服务器,服务器还要查询用户信息。同时如果用户很多。这些信息存储在服务器内存中,给服务器增加负担。还有就是CSRF(跨站伪造请求攻击)攻击,session是基于cookie进行用户识别的,cookie如果被截获,用户就会很容易受到跨站请求伪造的攻击。还有就是sessionid就是一个特征值,表达的信息不够丰富。不容易扩展。而且如果你后端应用是多节点部署。那么就需要实现session共享机制。不方便集群应用。
2、基于 JWT 认证
1.认证流程
- 首先,前端通过Web表单将自己的用户名和密码发送到后端的接口。这一过程一般是一个HTTP POST请求。建议的方式是通过SSL加密的传输(https协议),从而避免敏感信息被嗅探。
- 后端核对用户名和密码成功后,将用户的id等其他信息作为JWT Payload(负载),将其与头部分别进行Base64编码拼接后签名,形成一个JWT(Token)。形成的JWT就是一个形同lll.zzz.xxx的字符串。 token格式:head.payload.singurater
- 后端将JWT字符串作为登录成功的返回结果返回给前端。前端可以将返回的结果保存在localStorage或sessionStorage上,退出登录时前端删除保存的JWT即可。
- 前端在每次请求时将JWT放入HTTP Header中 Authorization位。(解决XSS和XSRF问题)
- 后端检查是否存在,如存在验证JWT的有效性。例如,检查签名是否正确;检查Token是否过期;检查Token的接收方是否是自己(可选)。
- 验证通过后后端使用JWT中包含的用户信息进行其他逻辑操作,返回相应结果。
2.JWT优势
- 简洁(Compact):可以通过URL,POST参数或者在HTTP hgader发送,因为数据量小,传输速度也很快
- 自包含(Self-contained)∶负载中包含了所有用户所需要的信息,避免了多次查询数据库
- 因为Token是以JSON加密的形式保存在客户端的,所以JWT是跨语言的,原则上任何web形式都支持。
- 不需要在服务端保存会话信息,特别适用于分布式微服务。
第四章、JWT的结构是什么?
token string ====> header.payload.signature token
# 1.令牌组成
- 1.标头(header)
- 2.有效载荷(Payload)
- 3.签名(Signature)
- 因此,JWT 通常如下下所示:xxxxx.yyyyy.zzzzz Header.Payload.Signature
# 2.Header
- 标头通常由两部分组成︰令牌的类型(即JWT)和所使用的签名算法,例如HMAC SHA256或RSA。它会使用Base64编码组成JWT结构的第一部分。
- 注意: Base64是一种编码,也就是说,它是可以被翻译回原来的样子,它并不是一种加密过程。
{
'alg': 'HS256',
'typ': 'JWT'
}
# 3.Payload
- 令牌的第二部分是有效负载,其中包含声明,声明是有关实体(通常是用户)和其他数据的声明,同样的,它会使用 Base64 编码组成 JWT 结构的第二部分
- 注意不要在有效负载中存放实体的敏感信息,比如密码、身份证号等
{
'sub': '123456',
'name': '小明',
'admin': true
}
# 4.Signature
- 前面两部分都是使用Base64进行编码的,即前端可以解开知道里面的信息。Signature需要使用编码后的 heayler 和 payload以及我们提供的一个密钥(随机盐),然后使用header 中指定的签名算法(HS256)进行签名。签名的作用是保证JWT 没有被篡改过
- 如:
HMACSHA256(base64UrlEncode(header) + "." + base64UrlEncode(payload).secrect)
# 签名的目的
- 最后一步签名的过程,实际上是对头部以及负载内容进行签名,防止内容被窜改。如果有人对头部以及负载的内容解码之后进行修改,再进行编码,最后加上之前的签名组合形成新的JWT的话,那么服务器端会判断出新的头部和负载形成的签名和JWT附带上的签名是不一样的。如果要对新的头部和负载进行签名,在不知道服务器加密时用的密钥的话,得出来的签名也是不一样的。
# 信息安全问题
- 在这里大家一定会问一个问题:Base64是一种编码,是可逆的,那么我的信息不就被暴露了吗?
- 是的。所以,在JWT中,不应该在负载里面加入任何敏感的数据。在上面的例子中,我们传输的是用户的User ID。这个值实际上不是什么敏感内容,一般情况下被知道也是安全的。但是像密码这样的内容就不能被放在JWT中了。如果将用户的密码放在了JWT中,那么怀有恶意的第﹐三方通过Base64解码就能很快地知道你的密码了。因此JWT适合用于向Web应用传递一些非敏感信息。JWT还经常用于设计用户认证和授权系统,甚至实现Web应用的单点登录。
# 5.放在一起
- 输出是三个由点分隔的Base64-URL字符串,可以在HTML和HTTP环境中轻松传递这些字符串,与基于XMNL的标准(例如SAML)相比,它更紧凑。
- 简洁(Compact)
可以通过 URL,POST 参数或者在 HTTP header 发送,因为数据量小,传输速度快
- 自包含(Self-contained)
负载中包含了所有用户所需要的信息,避免了多次查询数据库
- 返回给前端的 JWT 如下图:
第五章、使用JWT
5.1、引入依赖
<!--引入 JWT-->
<dependency>
<groupId>com.auth0</groupId>
<artifactId>java-jwt</artifactId>
<version>3.4.0</version>
</dependency>
5.2、生成token
@DisplayName("生成token测试")
@Test
void contextLoads() {
HashMap<String, Object> map = new HashMap<>();
Calendar instance = Calendar.getInstance();
// 设置 token 300 秒后过期
instance.add(Calendar.SECOND,300);
String token = JWT.create()
.withHeader(map)
.withClaim("userId", 21)
.withClaim("username", "小明")
.withExpiresAt(instance.getTime()) // 指定令牌的过期时间
.sign(Algorithm.HMAC256("!QWA@@!!##"));// 签名
System.out.println(token);
}
生成结果:
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2NTUwOTI4OTAsInVzZXJJZCI6MjEsInVzZXJuYW1lIjoi5bCP5piOIn0.qrpbwxPlBfYaf5o8oL_yKNtbUzAWfWyShtNLm9d4psM
5.3、根据令牌和签名解析数据
@Test
public void test(){
// 创建验证对象
JWTVerifier build = JWT.require(Algorithm.HMAC256("!QWA@@!!##")).build();
DecodedJWT verify = build.verify("eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2NTUwOTI4OTAsInVzZXJJZCI6MjEsInVzZXJuYW1lIjoi5bCP5piOIn0.qrpbwxPlBfYaf5o8oL_yKNtbUzAWfWyShtNLm9d4psM");
System.out.println(verify.getClaim("userId").asInt());
System.out.println(verify.getClaim("username").asString());
System.out.println("token过期时间:" + verify.getExpiresAt());
}
输出结果:
21
小明
token过期时间:Mon Jun 13 12:01:30 GMT+08:00 2022
5.4、常见异常信息
- SignatureVerificationException : 签名不一致异常
TokenExpiredException:
令牌过期异常
AlgorithmMismatchException:
算法不匹配异常
InvalidClaimException:
失效的payload异常
第六章、封装工具类
public class JWTUtils {
// 密钥
private static final String SIGNATURE = "ddfsfdsfd";
/**
* @author wk
* @Description 生成 token header.payload.signature
* @Date 14:10 2022/6/13
* @Param
* @Return
*/
public static String getToken(Map<String,String> map){
Calendar instance = Calendar.getInstance();
instance.add(Calendar.DATE,7); // 默认7天过期
// 创建 builder (没有设置 header ,则使用默认的 header)
JWTCreator.Builder builder = JWT.create();
// 设置payload
map.forEach((key,value) -> {
builder.withClaim(key,value);
});
// 指定令牌过期时间
String token = builder.withExpiresAt(instance.getTime())
.sign(Algorithm.HMAC256(SIGNATURE));
return token;
}
/**
* @author wk
* @Description JWT 验证 token 合法性,并返回 token 信息
* @Date 14:34 2022/6/13
* @Param
* @Return
*/
public static DecodedJWT checkToken(String token){
return JWT.require(Algorithm.HMAC256(SIGNATURE)).build().verify(token);
}
}
第七章、整合 SpringBoot
6.1、搭建 springboot + mybatisplus + jwt 环境
<!--引入 JWT-->
<dependency>
<groupId>com.auth0</groupId>
<artifactId>java-jwt</artifactId>
<version>3.4.0</version>
</dependency>
<!-- MyBatis-Plus启动器 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.1</version>
</dependency>
<!-- 引入 数据库驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<!-- 引入 数据库连接池-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.10</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
#启动访问端口
server:
port: 8080
# 应用名称
spring:
application:
name: jwt
datasource:
type: com.alibaba.druid.pool.DruidDataSource
username: root
password: 130@qq.com
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/jwt?serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
# MyBatisPlus
mybatis-plus:
global-config:
db-config:
id-type: auto
table-prefix: t_
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
type-aliases-package: com.atguigu.jwt.bean
6.2、新建t_user表
create database if not EXISTS jwt CHARACTER set 'utf8';
use jwt;
create table if not exists t_user(
id int(11) AUTO_INCREMENT,
name VARCHAR(25),
password varchar(45),
primary key (id)
) character set 'utf8';
6.3、新建 User 类
@Accessors(chain = true)
@AutoConfigureOrder
@NoArgsConstructor
@Data
public class User {
private Integer id;
private String username;
private String password;
}
6.4、新建 UserMapper 接口
@Repository
public interface UserMapper extends BaseMapper<User> {
}
6.5、新建 UserService 接口
public interface UserService extends IService<User> {
/**
* @author wk
* @Description 登录
* @Date 15:59 2022/6/13
* @Param
* @Return
*/
User login(User user);
}
6.7、新建 UserService 接口的实现类
@Service
@Transactional
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
@Autowired
private UserMapper userMapper;
/**
* @author wk
* @Description 登录
* @Date 15:42 2022/6/13
* @Param
* @Return
*/
public User login(User user){
LambdaQueryWrapper<User> userMapperLambdaQueryWrapper = new LambdaQueryWrapper<>();
userMapperLambdaQueryWrapper
.eq(User::getUsername,user.getUsername())
.eq(User::getPassword,user.getPassword());
User user1 = userMapper.selectOne(userMapperLambdaQueryWrapper);
return user1;
}
}
6.8、新建 Controller
/**
* @author wk
* @Description 登录
* @Date 15:57 2022/6/13
* @Param
* @Return
*/
@GetMapping("/login")
public Map<String,Object> login(User user){
log.info("用户名:{}" + user.getUsername());
log.info("用户密码:{}" + user.getPassword());
HashMap<String, Object> map = new HashMap<>();
User login = null;
try {
login = userService.login(user);
HashMap<String, String> payload = new HashMap<>(); // 用来存放 payload
payload.put("id",Integer.toString(login.getId()));
payload.put("username",user.getUsername());
// 生成 token 令牌
String token = JWTUtils.getToken(payload);
map.put("token",token);
map.put("state",200);
map.put("message","认证成功");
} catch (Exception exception) {
exception.printStackTrace();
map.put("state",300);
map.put("message","认证失败");
}
return map;
}
6.9、通过postman模拟认证失败
6.10、通过postman模拟认证成功
6.11、编写测试接口
@PostMapping("/test")
public Map<String,Object> test(String token){
Map<String,Object> map = new HashMap<>();
log.info("当前 token 为:[{}]",token);
try {
DecodedJWT verify = JWTUtils.checkToken(token);
map.put("state",true);
map.put("message","请求成功");
map.put("token",token);
return map;
}catch (SignatureVerificationException e){
e.printStackTrace();
map.put("message","签名无效");
}catch (TokenExpiredException e){
e.printStackTrace();
map.put("message","token已过期");
}catch (AlgorithmMismatchException e){
e.printStackTrace();
map.put("message","token算法不一致");
} catch (Exception exception) {
exception.printStackTrace();
map.put("message","token无效");
}
map.put("state",300);
return map;
}
}
6.12、通过 postman 请求接口
- 携带正确的token
- 不携带token
6.13、问题?
使用上述方式每次都要传递token数据,每个方法都需要验证token,这样就会使代码冗余,不够灵活?
如何优化?
- 使用拦截器进行优化
// 拦截器
public class JWTInterceptor implements HandlerInterceptor{
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
// 1. 获取请求头中的令牌
String token = request.getHeader("token");
Map<String,Object> map = new HashMap<>();
try {
// 验证令牌
JWTUtils.checkToken(token);
// 放行请求
return true;
}catch (SignatureVerificationException e){
e.printStackTrace();
map.put("message","签名无效");
}catch (TokenExpiredException e){
e.printStackTrace();
map.put("message","token已过期");
}catch (AlgorithmMismatchException e){
e.printStackTrace();
map.put("message","token算法不一致");
} catch (Exception exception) {
exception.printStackTrace();
map.put("message","token无效");
}
map.put("state",false);// 设置状态
// 将 map 转为 json
String json = new ObjectMapper().writeValueAsString(map);
response.setContentType("application/json;charset=UTF-8");
response.getWriter().println(json);
return false;
}
}
// 定制化 MVC
@Configuration
public class InterceptorConfig implements WebMvcConfigurer {
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(new JWTInterceptor())
.addPathPatterns("/user/test") // 需要token验证的接口
.excludePathPatterns("/user/login");// 放行用户登录接口
}
}
- 在请求头携带token发送请求
- 请求头中不携带token或token过期