image.png

1. 什么是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.

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

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

2. JWT能做什么

  1. # 1、授权
  2. 这是JWT最常见的使用方案。一旦用户登录,每个后续请求将包括JWT,从而允许用户访问该令牌允许的路由、服务和资源。单点登录是当今广泛
  3. 使用JWT的一项功能,因为它的开销很小并且可以在不同的域种轻松使用。
  4. # 2、信息交换
  5. JSON Web Token是在各方之间安全地传输信息的好方法。因为可以对JWT进行签名(例如使用公钥/私钥对),所以您可以确保发件人是他们所说
  6. 的人。此外,由于签名时使用标头和有效负载计算的,因此您还可以验证内容是否遭到篡改。

3. 为什么是JWT

基于传统的Session认证

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

JWT - 图3

  1. # 3、暴露问题
  2. 1.每个用户经过我们的应用认证之后,我们的应用都要在服务端做一次记录,以方便用户下次请求的鉴别,通常而言session都是保存在内存中,而
  3. 随着认证用户的增多,服务端的开销会明显增大
  4. 2.用户认证之后没服务端做认证记录,如果认证的记录被保存在内存中的话,这意味着用户下次请求还必须要请求在这台服务器上,这样才能拿到授
  5. 权的资源,这样在分布式的应用上,相应的限制了负载均衡的能力。这也意味着限制了应用的扩展能力。
  6. 3、因为是基于cookie来识进行用户识别的,cookie如果被截获,用户就会很容易受到跨站请求伪造的攻击
  7. 4、在前后端分离的系统就更痛苦了:
  8. 也就是说前后端分离在应用解耦后,增加了部署的复杂性。通常用户一次请求就要转发多次。如果用session每次写到的sessionid到服务器,服务
  9. 器还要查询用户信息。同时如果用户很多。这些信息存储在服务器内存中,给服务器增加负担,还有就是CSRF(跨站伪造请求攻击)攻击,session
  10. 是基于cookie进行用户识别的,cookie如果被截获,用户就会很容易受到跨站请求伪造的攻击。还有就是sessionid是一个特征值,表达的信息不够
  11. 丰富。不容易扩展,而且如果你后端应用是多节点部署,那么就需要实现session共享机制,不方便集群应用。

JWT - 图4

基于JWT认证

image.png

  1. # 1.认证流程
  2. 首先,前端通过Web表单将自己的用户名和密码发送到后端的接口。这一过程一般是一个HTTP POST请求。
  3. 建议的方式是通过SSL加密的传输(https协议),从而避免敏感信息被嗅探。
  4. 后端核对用户名和密码成功后,将用户的id等其他信息作为JWT Payload(负载),
  5. 将其与头部分别进行Base64编码拼接后签名,形成一个JWTToken)。形成的JWT就是一个形同lll.zzz.xxx的字符串。
  6. 后端将JWT字符串作为登录成功的返回结果返回给前端。前端可以将返回的结果保存在localStoragesessionStorage上,
  7. 退出登录时前端删除保存的JWT即可。
  8. 前端在每次请求时将JWT放入HTTP Header中的Authorization位。(解决XSSXSRF问题)。
  9. 后端检查是否存在,如存在验证JWT的有效性。例如:检查签名是否正确;检查Token是否过期;检查Token的接收方是否是自己(可选)。
  10. 验证通过后后端使用JWT中包含的用户信息进行其他逻辑操作,返回相应结果。
  11. # 2.jwt优势
  12. - 简洁(Compact): 可以通过URLPOST参数或者在HTTP header发送,因为数据量小,传输速度也很快。
  13. - 自包含(Self-contained):负载中包含了所有用户所需要的信息,避免了多次查询数据库。
  14. - 因为Token是以JSON加密的形式保存在客户端的,所以JWT是跨语言的,原则上任何违背形式都支持。
  15. - 不需要在服务端保存会话信息,特别适用于分布式微服务。

4. JWT的结构是什么?

  1. # 1、令牌组成
  2. - 1,标头(Header
  3. - 2,有效载荷(Payload
  4. - 3,签名(Signature
  5. - 因此,JWT通常如下所示:xxxxx.yyyyy.zzzzz Header.Payload.Signature
  6. # 2、Header
  7. - 标头通常由两部分组成:令牌的类型(即JWT)和所使用的签名算法,例如:HMAC SHA256RSA。它会使用Base64编码组成JWT结构的第一部分。
  8. - 注意:Base64是一种编码,也就是说,它是可以被翻译回原来的样子来的。它并不是一种加密过程。
  9. {
  10. "alg":“HS256”,
  11. typ”:“JWT
  12. }
  13. # 3、Payload
  14. - 令牌的第二部分是有效负载,其中包含声明。声明是有关实体(通常是用户)和其他数据的声明。同样的,它会使用Base64编码组成JWT结构的第二部分
  15. {
  16. "sub":“1234567890”,
  17. name”:“John Doe”,
  18. admin”:true
  19. }
  20. # 4、Signature
  21. - 前面两部分都是使用Base64进行编码的,即前端可以解开知道里面的信息。Signature需要使用编码后的headerpayload以及我们提供的一个密钥,然后使用header中指定的签名算法(HS256)进行签名。签名的作用是保证JWT没有被篡改过
  22. - 如:
  23. HMACSHA256base64UrlEncodeheader)+"."+base64UrlEncode(payload),secret);
  1. # 签名目的
  2. 最后一步签名的过程,实际上是对头部以及负载内容进行签名,防止内容被篡改。如果有人对头部以及负载的内容解码之后进行修改,再进行编码,
  3. 最后加上之前的签名组合形成新的JWT的话,那么服务器端会判断出新的头部和负载形式的签名和JWT附带上的签名是不一样的。如果要对新的头部
  4. 和负载进行签名,在不知道服务器加密时用的密钥的话,得出来的签名也是不一样的。
  5. # 信息安全问题
  6. 在这里大家一定会问一个问题:Base64是一种编码,是可逆的,那么我的信息不就被暴露了吗?
  7. 是的。所以,在JWT中,不应该在负载里面加入任何敏感的数据。在上面的例子中,我们传输的是用户的User ID
  8. 这个值实际上不是什么敏感内容,一般情况下被知道也是安全的。但是像密码这样的内容就不能被放在JWT中了。
  9. 如果将用户的密码放在JWT中,那么怀有恶意的第三方通过Base64解码就能很快地知道你的密码了。
  10. 因此JWT适合用于向Web应用传递一些非敏感信息。JWT还经常用于设计用户认证和授权系统,甚至实现Web应用的单点登录。

image.png

  1. # 5、放在一起
  2. 输出是三个由点分隔的Base64-URL字符串,可以在HTMLHTTP环境中轻松传递这些字符串,与基于XML的标准(例如SAML)相比,它更紧凑。
  3. 简洁(Compact
  4. 可以通过URLPOST参数或者在HTTP header发送,因为数据量小,传输速度快
  5. 自包含(Self-contained
  6. 负载中包含了所有用户所需要的信息,避免了多次查询数据库

image.png

5. 使用JWT

创建项目,导入依赖

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

生成token

  1. @Test
  2. public void contextLoads() {
  3. Map<String, Object> map = new HashMap<String, Object>();
  4. Calendar instance = Calendar.getInstance();
  5. instance.add(Calendar.SECOND, 20);
  6. String token = JWT.create()
  7. .withHeader(map) //head 这里header可以不写 不写默认也是它
  8. .withClaim("userId", 21) //payload
  9. .withExpiresAt(instance.getTime()) //指定令牌的过期时间
  10. .withClaim("username", "zhangsan")
  11. .sign(Algorithm.HMAC256("!Q2W#E$RW"));//签名
  12. /**
  13. * eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.
  14. * eyJleHAiOjE2MzI2NjgwMzMsInVzZXJJZCI6MjEsInVzZXJuYW1lIjoiemhhbmdzYW4ifQ.
  15. * eeS4z6JxnLfH337te59gKM7kC4Qw92E0Xp5vQL6aTcA
  16. */
  17. System.out.println(token);
  18. }

根据令牌解析数据

  1. @Test
  2. public void test() {
  3. JWTVerifier jwtVerifier = JWT.require(Algorithm.HMAC256("!Q2W#E$RW")).build();
  4. DecodedJWT verify = jwtVerifier.verify("eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2MzI2NjgwMzMsInVzZXJJZCI6MjEsInVzZXJuYW1lIjoiemhhbmdzYW4ifQ.eeS4z6JxnLfH337te59gKM7kC4Qw92E0Xp5vQL6aTcA");
  5. System.out.println(verify.getClaim("userId").asInt());
  6. System.out.println(verify.getClaim("username").asString());
  7. System.out.println(verify.getExpiresAt());
  8. }

常见异常信息

  • SignatureVerificationException:签名不一致异常
  • TokenExpiredException:令牌过期异常
  • AlgorithmMissmatchException:算法不匹配异常
  • InvalidClaimException:失效的payload异常

6. 封装工具类

  1. package com.ftj.util;
  2. import com.auth0.jwt.JWT;
  3. import com.auth0.jwt.JWTCreator;
  4. import com.auth0.jwt.JWTVerifier;
  5. import com.auth0.jwt.algorithms.Algorithm;
  6. import com.auth0.jwt.interfaces.DecodedJWT;
  7. import java.util.Calendar;
  8. import java.util.Map;
  9. /**
  10. * Created by fengtj on 2021/9/27 8:09
  11. */
  12. public class JWTUtil {
  13. private static final String SIGN = "!Q@W#E$R";
  14. /**
  15. * 生成token header.payload.sign
  16. *
  17. * @param map
  18. * @return
  19. */
  20. public static String getToken(Map<String, String> map) {
  21. Calendar calendar = Calendar.getInstance();
  22. calendar.add(Calendar.DATE, 7); //默认七天过期
  23. //创建jwt bulider
  24. JWTCreator.Builder builder = JWT.create();
  25. //payload
  26. map.forEach((k, v) -> {
  27. builder.withClaim(k, v);
  28. });
  29. String token = builder.withExpiresAt(calendar.getTime())
  30. .sign(Algorithm.HMAC256(SIGN));
  31. return token;
  32. }
  33. /**
  34. * 验证token合法性,且获取token信息
  35. *
  36. * @param token
  37. */
  38. public static DecodedJWT verify(String token) {
  39. return JWT.require(Algorithm.HMAC256(SIGN)).build().verify(token);
  40. }
  41. /**
  42. * 获取token信息方法
  43. *
  44. * @param token
  45. * @return
  46. */
  47. // public static DecodedJWT getTokenInfos(String token) {
  48. // DecodedJWT verify = JWT.require(Algorithm.HMAC256(SIGN)).build().verify(token);
  49. // return verify;
  50. // }
  51. }

7. 整合springboot

  1. # 0、搭建springboot+mybatis+jwt环境
  2. - 引入依赖
  3. - 编写配置
  4. - 编写业务层
  5. - 编写测试接口

引入依赖

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-web</artifactId>
  4. </dependency>
  5. <dependency>
  6. <groupId>org.springframework.boot</groupId>
  7. <artifactId>spring-boot-starter-test</artifactId>
  8. <scope>test</scope>
  9. </dependency>
  10. <dependency>
  11. <groupId>com.auth0</groupId>
  12. <artifactId>java-jwt</artifactId>
  13. <version>3.4.0</version>
  14. </dependency>
  15. <dependency>
  16. <groupId>org.mybatis.spring.boot</groupId>
  17. <artifactId>mybatis-spring-boot-starter</artifactId>
  18. <version>2.1.3</version>
  19. </dependency>
  20. <dependency>
  21. <groupId>org.projectlombok</groupId>
  22. <artifactId>lombok</artifactId>
  23. <version>1.18.12</version>
  24. </dependency>
  25. <dependency>
  26. <groupId>com.alibaba</groupId>
  27. <artifactId>druid</artifactId>
  28. <version>1.1.19</version>
  29. </dependency>
  30. <dependency>
  31. <groupId>mysql</groupId>
  32. <artifactId>mysql-connector-java</artifactId>
  33. <version>8.0.26</version>
  34. </dependency>

编写配置

  1. spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
  2. spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  3. spring.datasource.url=jdbc:mysql:///ftj?characterEncoding=UTF-8
  4. spring.datasource.username=root
  5. spring.datasource.password=password
  6. mybatis.type-aliases-package=com.ftj.entity
  7. mybatis.mapper-locations=classpath:mapper/*.xml
  8. logging.level.com.ftj.dao=debug

编写业务层

  1. //pojo 数据库同理,建这三个column就行
  2. @Data
  3. public class User {
  4. private Long id;
  5. private String username;
  6. private String password;
  7. }
  8. //dao
  9. @Mapper
  10. public interface UserDao {
  11. User login(User user);
  12. }
  13. //mapper.xml
  14. <?xml version="1.0" encoding="UTF-8"?>
  15. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
  16. <mapper namespace="com.ftj.dao.UserDao">
  17. <select id="login" parameterType="User" resultType="User">
  18. select * from user where username=#{username,jdbcType=VARCHAR} and password=#{password,jdbcType=VARCHAR}
  19. </select>
  20. </mapper>
  21. //service
  22. public interface UserService {
  23. User login(User user);
  24. }
  25. //serviceImpl
  26. @Service
  27. @Transactional
  28. public class UserServiceImpl implements UserService {
  29. @Resource
  30. private UserDao userDao;
  31. @Override
  32. @Transactional(propagation = Propagation.SUPPORTS)
  33. public User login(User user) {
  34. User userDB = userDao.login(user);
  35. if (userDB != null) return userDB;
  36. throw new RuntimeException("登录失败~~~~");
  37. }
  38. }

编写测试接口

  1. @RestController
  2. @Slf4j
  3. public class UserController {
  4. @Autowired
  5. private UserService userService;
  6. @GetMapping("/user/login")
  7. public Map<String, Object> login(User user) {
  8. log.info("用户名:[{}] 密码:[{}]", user.getUsername(), user.getPassword());
  9. Map<String, Object> map = new HashMap<>();
  10. try {
  11. User loginDB = userService.login(user);
  12. Map<String, String> payload = new HashMap<>();
  13. map.put("id", loginDB.getId());
  14. map.put("username", loginDB.getUsername());
  15. //生成jwt令牌
  16. String token = JWTUtil.getToken(payload);
  17. map.put("state", true);
  18. map.put("msg", "认证成功");
  19. map.put("token", token);
  20. } catch (Exception e) {
  21. map.put("state", false);
  22. map.put("msg", "认证失败");
  23. }
  24. return map;
  25. }
  26. @PostMapping("/user/test")
  27. public Map<String, Object> test(String token) {
  28. Map<String, Object> map = new HashMap<>();
  29. log.info("当前token:【{}】", token);
  30. try {
  31. DecodedJWT verify = JWTUtil.verify(token);
  32. map.put("state", true);
  33. map.put("msg", "请求成功!");
  34. return map;
  35. } catch (SignatureVerificationException e) {
  36. e.printStackTrace();
  37. map.put("msg", "无效签名!");
  38. } catch (TokenExpiredException e) {
  39. e.printStackTrace();
  40. map.put("msg", "token已过期!");
  41. } catch (AlgorithmMismatchException e) {
  42. map.put("msg", "算法不一致!");
  43. e.printStackTrace();
  44. } catch (Exception e) {
  45. map.put("msg", "token无效!");
  46. e.printStackTrace();
  47. }
  48. map.put("state", false);
  49. return map;
  50. }
  51. }

8. 优化,把jwt验证写到拦截器统一处理

  1. @Component
  2. public class JWTInterceptor implements HandlerInterceptor {
  3. @Override
  4. public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  5. Map<String, Object> map = new HashMap<>();
  6. //获取请求头中的令牌
  7. String token = request.getHeader("token");
  8. try {
  9. JWTUtil.verify(token);
  10. return true;
  11. } catch (SignatureVerificationException e) {
  12. e.printStackTrace();
  13. map.put("msg", "无效签名!");
  14. } catch (TokenExpiredException e) {
  15. e.printStackTrace();
  16. map.put("msg", "token已过期!");
  17. } catch (AlgorithmMismatchException e) {
  18. map.put("msg", "算法不一致!");
  19. e.printStackTrace();
  20. } catch (Exception e) {
  21. map.put("msg", "token无效!");
  22. e.printStackTrace();
  23. }
  24. map.put("state", false);
  25. //响应到前台
  26. String json = new ObjectMapper().writeValueAsString(map);
  27. response.setContentType("application/json;charset=UTF-8");
  28. response.getWriter().println(json);
  29. return false;
  30. }
  31. }
  1. @Configuration
  2. public class InterceptorConfig implements WebMvcConfigurer {
  3. @Resource
  4. private JWTInterceptor jwtInterceptor;
  5. @Override
  6. public void addInterceptors(InterceptorRegistry registry) {
  7. registry.addInterceptor(jwtInterceptor)
  8. .addPathPatterns("/user/test")
  9. .excludePathPatterns("/user/login"); //得放行生成jwt验证码的接口,一般我们会把验证码放请求头里边
  10. }
  11. }

优化接口业务逻辑

  1. @PostMapping("/user/test")
  2. public Map<String, Object> test(String token) {
  3. Map<String, Object> map = new HashMap<>();
  4. //代码改造,处理业务逻辑,改造前代码,看上一个commit
  5. map.put("state", true);
  6. map.put("msg", "请求成功!");
  7. return map;
  8. }