JWT介绍和安全防范以及SpringBoot集成JWT实现接口权限认证
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 .
—[摘自官网]
1 2 3 4 5 6 # 1.翻译 - 官网地址: https://jwt.io/introduction/- 翻译: jsonwebtoken(JWT)是一个开放标准(rfc7519),它定义了一种紧凑的、自包含的方式,用于在各方之间以JSON对象安全地传输信息。此信息可以验证和信任,因为它是数字签名的。jwt可以使用秘密(使用HMAC算法)或使用RSA或ECDSA的公钥/私钥对进行签名# 2.通俗解释 - JWT简称JSON Web Token,也就是通过JSON形式作为Web应用中的令牌,用于在各方之间安全地将信息作为JSON对象传输。在数据传输过程中还可以完成数据加密、签名等相关处理。
2.JWT能做什么 1 2 3 4 5 # 1.授权 - 这是使用JWT的最常见方案。一旦用户登录,每个后续请求将包括JWT,从而允许用户访问该令牌允许的路由,服务和资源。单点登录是当今广泛使用JWT的一项功能,因为它的开销很小并且可以在不同的域中轻松使用。# 2.信息交换 - JSON Web Token是在各方之间安全地传输信息的好方法。因为可以对JWT进行签名(例如,使用公钥/私钥对),所以您可以确保发件人是他们所说的人。此外,由于签名是使用标头和有效负载计算的,因此您还可以验证内容是否遭到篡改。
3.为什么是JWT 基于传统的Session认证 1 2 3 4 # 1.认证方式 - 我们知道,http协议本身是一种无状态的协议,而这就意味着如果用户向我们的应用提供了用户名和密码来进行用户认证,那么下一次请求时,用户还要再一次进行用户认证才行,因为根据http协议,我们并不能知道是哪个用户发出的请求,所以为了让我们的应用能识别是哪个用户发出的请求,我们只能在服务器存储一份用户登录的信息,这份登录信息会在响应时传递给浏览器,告诉其保存为cookie,以便下次请求时发送给我们的应用,这样我们的应用就能识别请求来自哪个用户了,这就是传统的基于session认证。t # 2.认证流程
1 2 3 4 5 6 7 8 9 # 3.暴露问题 - 1.每个用户经过我们的应用认证之后,我们的应用都要在服务端做一次记录,以方便用户下次请求的鉴别,通常而言session都是保存在内存中,而随着认证用户的增多,服务端的开销会明显增大- 2.用户认证之后,服务端做认证记录,如果认证的记录被保存在内存中的话,这意味着用户下次请求还必须要请求在这台服务器上,这样才能拿到授权的资源,这样在分布式的应用上,相应的限制了负载均衡器的能力。这也意味着限制了应用的扩展能力。- 3.因为是基于cookie来进行用户识别的, cookie如果被截获,用户就会很容易受到跨站请求伪造的攻击。- 4.在前后端分离系统中就更加痛苦:如下图所示 也就是说前后端分离在应用解耦后增加了部署的复杂性。通常用户一次请求就要转发多次。如果用session 每次携带sessionid 到服务 器,服务器还要查询用户信息。同时如果用户很多。这些信息存储在服务器内存中,给服务器增加负担。还有就是CSRF(跨站伪造请求攻 击)攻击,session是基于cookie进行用户识别的, cookie如果被截获,用户就会很容易受到跨站请求伪造的攻击。还有就是 sessionid就是一个特征值,表达的信息不够丰富。不容易扩展。而且如果你后端应用是多节点部署。那么就需要实现session共享机制。 不方便集群应用。
基于JWT认证
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 # 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问题) HEADER- 后端检查是否存在,如存在验证JWT的有效性。例如,检查签名是否正确;检查Token是否过期;检查Token的接收方是否是自己(可选)。- 验证通过后后端使用JWT中包含的用户信息进行其他逻辑操作,返回相应结果。# 2.jwt优势 - 简洁(Compact): 可以通过URL,POST参数或者在HTTP header发送,因为数据量小,传输速度也很快- 自包含(Self-contained):负载中包含了所有用户所需要的信息,避免了多次查询数据库- 因为Token是以JSON加密的形式保存在客户端的,所以JWT是跨语言的,原则上任何web形式都支持。- 不需要在服务端保存会话信息,特别适用于分布式微服务。
4.JWT的结构是什么? 1 2 3 4 5 6 7 token string ====> header.payload.singnature token # 1.令牌组成 - 1.标头(Header)- 2.有效载荷(Payload)- 3.签名(Signature)- 因此,JWT通常如下所示:xxxxx.yyyyy.zzzzz Header.Payload.Signature
1 2 3 4 # 2.Header - 标头通常由两部分组成:令牌的类型(即JWT)和所使用的签名算法,例如HMAC SHA256或RSA。它会使用 Base64 编码组成 JWT 结构的第一部分。- 注意:Base64是一种编码,也就是说,它是可以被翻译回原来的样子来的。它并不是一种加密过程。
1 2 3 4 { "alg" : "HS256" , "typ" : "JWT" }
1 2 # 3.Payload - 令牌的第二部分是有效负载,其中包含声明。声明是有关实体(通常是用户)和其他数据的声明。同样的,它会使用 Base64 编码组成 JWT 结构的第二部分
1 2 3 4 5 { "sub" : "1234567890" , "name" : "John Doe" , "admin" : true }
1 2 3 4 5 6 7 8 9 10 11 12 # 4.Signature - 前面两部分都是使用 Base64 进行编码的,即前端可以解开知道里面的信息。Signature 需要使用编码后的 header 和 payload 以及我们提供的一个密钥,然后使用 header 中指定的签名算法(HS256)进行签名。签名的作用是保证 JWT 没有被篡改过- 如: HMACSHA256(base64UrlEncode(header) + "." + base64UrlEncode(payload),secret); # 签名目的 - 最后一步签名的过程,实际上是对头部以及负载内容进行签名,防止内容被窜改。如果有人对头部以及负载的内容解码之后进行修改,再进行编码,最后加上之前的签名组合形成新的JWT的话,那么服务器端会判断出新的头部和负载形成的签名和JWT附带上的签名是不一样的。如果要对新的头部和负载进行签名,在不知道服务器加密时用的密钥的话,得出来的签名也是不一样的。 # 信息安全问题 - 在这里大家一定会问一个问题:Base64是一种编码,是可逆的,那么我的信息不就被暴露了吗? - 是的。所以,在JWT中,不应该在负载里面加入任何敏感的数据。在上面的例子中,我们传输的是用户的User ID。这个值实际上不是什么敏 感内容,一般情况下被知道也是安全的。但是像密码这样的内容就不能被放在JWT中了。如果将用户的密码放在了JWT中,那么怀有恶意的第 三方通过Base64解码就能很快地知道你的密码了。因此JWT适合用于向Web应用传递一些非敏感信息。JWT还经常用于设计用户认证和授权系 统,甚至实现Web应用的单点登录。
1 2 3 4 5 6 # 5.放在一起 - 输出是三个由点分隔的Base64-URL字符串,可以在HTML和HTTP环境中轻松传递这些字符串,与基于XML的标准(例如SAML)相比,它更紧凑。- 简洁(Compact) 可以通过URL, POST 参数或者在 HTTP header 发送,因为数据量小,传输速度快 - 自包含(Self-contained) 负载中包含了所有用户所需要的信息,避免了多次查询数据库
5.攻击面 5.1敏感信息泄露 JWT中的header 和 payload 虽然看起来不可读,但实际上都只经过简单编码, 开发者可能误将敏感信息存储在里面。使用上述工具可以方便地解码JWT中前两部分的信息。
5.2指定算法为none 上面提到算法 none 是JWT规范中强制要求实现的,但有些实现JWT的库直接将使用none 算法的token视为已经过校验。 这样攻击者就可以设置alg 为none ,使signature 部分为空,然后构造包含任意payload 的JWT来欺骗服务端。
5.3将签名算法从非对称类型改为对称类型 使用非对称加密算法(主要基于RSA、ECDSA,如S256)分发JWT的过程是使用私钥(private)加密生成JWT,使用公钥(public)解密验证。
使用对称加密算法(主要基于HMAC,如HS256)分发JWT的过程是使用同一个密钥(secret)生成和验证JWT。
如果服务端期待收到的算法类型为RS256,然后以RS256和public去验证JWT,而实际上收到的算法类型是HS256, 那么服务端就可能尝试把public当作secret,然后用HS256算法解密验证JWT。
由于RS256的public人人都可获得,攻击者可以预先以public为密钥,用HS256算法伪造包含任意payload 的JWT,从而成功通过服务端的验证。
5.4爆破密钥 WT的安全性依赖于密钥的保密性,任何拥有密钥的人都可以构造任何内容的合法token。
当一个JSON Web Token 被分发出去,如果密钥不够强壮就存在被爆破的风险,而且整个爆破过程可以离线进行。
已经有人写了一些工具,推荐如下:
5.5伪造密钥 时JWT采用header 中的kid 字段关联校验算法的密钥,这个密钥可能是对称加密的密钥,也可能是非对称加密的公钥。 如果能够猜测kid 和 密钥的关联性,攻击者就可能修改kid 来欺骗服务端,使其校验时使用攻击者可控的密钥, 于是攻击者就可以伪造任意内容的可通过校验的JWT。
6.安全建议 验证函数应忽略JWT中的algo 字段,预先就明确JWT使用的算法,如果需要使用多种算法,可以在header 中使用表示”key ID” 的kid 字段,查询每个kid 对应的算法。 JWT/JWS 标准应该移除 header 中的algo 字段。JWT的许多安全缺陷都来自于开发者依赖这一客户端可控的字段。 开发者应升级相应库到最新版本,因为旧版本可能存在致命缺陷。
不应该在jwt的payload部分存放敏感信息,因为该部分是客户端可解密的部分。
保护好secret私钥,该私钥非常重要。
请使用https的安全通道进行传输
验证函数应忽略JWT中的algo 字段,预先就明确JWT使用的算法,如果需要使用多种算法, 可以在header中使用表示”key ID”的kid字段,查询每个kid对应的算法。
JWT/JWS 标准应该移除 header 中的algo 字段。JWT的许多安全缺陷都来自于开发者依赖这一客户端可控的字段。
开发者应升级相应库到最新版本,因为旧版本可能存在致命缺陷。
7.使用JWT
1 2 3 4 5 6 <dependency > <groupId > com.auth0</groupId > <artifactId > java-jwt</artifactId > <version > 3.4.0</version > </dependency >
1 2 3 4 5 6 7 8 9 Calendar instance = Calendar.getInstance(); instance.add(Calendar.SECOND, 90 ); String token = JWT.create() .withClaim("username" , "张三" ) .withExpiresAt(instance.getTime()) .sign(Algorithm.HMAC256("token!Q2W#E$RW" )); System.out.println(token);
1 2 - 生成结果eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOlsicGhvbmUiLCIxNDMyMzIzNDEzNCJdLCJleHAiOjE1OTU3Mzk0NDIsInVzZXJuYW1lIjoi5byg5LiJIn0.aHmE3RNqvAjFr_dvyn_ sD2VJ46P7EGiS5OBMO_TI5jg
1 2 3 4 JWTVerifier jwtVerifier = JWT.require(Algorithm.HMAC256("token!Q2W#E$RW" )).build(); DecodedJWT decodedJWT = jwtVerifier.verify(token); System.out.println("用户名: " + decodedJWT.getClaim("username" ).asString()); System.out.println("过期时间: " +decodedJWT.getExpiresAt());
1 2 3 4 5 # 4.常见异常信息 - SignatureVerificationException: 签名不一致异常- TokenExpiredException: 令牌过期异常- AlgorithmMismatchException: 算法不匹配异常- InvalidClaimException: 失效的payload异常
8. 封装工具类 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 public class JWTUtils { private static String TOKEN = "token!Q@W3e4r" ; public static String getToken (Map<String,String> map) { JWTCreator.Builder builder = JWT.create(); map.forEach((k,v)->{ builder.withClaim(k,v); }); Calendar instance = Calendar.getInstance(); instance.add(Calendar.SECOND,7 ); builder.withExpiresAt(instance.getTime()); return builder.sign(Algorithm.HMAC256(TOKEN)).toString(); } public static void verify (String token) { JWT.require(Algorithm.HMAC256(TOKEN)).build().verify(token); } public static DecodedJWT getToken (String token) { return JWT.require(Algorithm.HMAC256(TOKEN)).build().verify(token); } }
9.整合springboot 1 2 3 # 0.搭建springboot+mybatis+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 <dependency > <groupId > com.auth0</groupId > <artifactId > java-jwt</artifactId > <version > 3.4.0</version > </dependency > <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 > <dependency > <groupId > com.alibaba</groupId > <artifactId > druid</artifactId > <version > 1.1.19</version > </dependency > <dependency > <groupId > mysql</groupId > <artifactId > mysql-connector-java</artifactId > <version > 5.1.38</version > </dependency >
1 2 3 4 5 6 7 8 9 10 11 12 13 server.port =8989 spring.application.name =jwt spring.datasource.type =com.alibaba.druid.pool.DruidDataSource spring.datasource.driver-class-name =com.mysql.jdbc.Driver spring.datasource.url =jdbc:mysql://localhost:3306/jwt?characterEncoding=UTF-8 spring.datasource.username =root spring.datasource.password =root mybatis.type-aliases-package =com.baizhi.entity mybatis.mapper-locations =classpath:com/baizhi/mapper/*.xml logging.level.com.baizhi.dao =debug
1 2 # 1.开发数据库 - 这里采用最简单的表结构验证JWT使用
1 2 3 4 5 6 7 DROP TABLE IF EXISTS `user` ;CREATE TABLE `user` ( `id` int (11 ) NOT NULL AUTO_INCREMENT COMMENT '主键' , `name` varchar (80 ) DEFAULT NULL COMMENT '用户名' , `password` varchar (40 ) DEFAULT NULL COMMENT '用户密码' , PRIMARY KEY (`id` ) ) ENGINE =InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET =utf8;
1 2 3 4 5 6 7 @Data @Accessors(chain=true) public class User { private String id; private String name; private String password; }
1 2 3 4 @Mapper public interface UserDAO { User login (User user) ; }
1 2 3 4 5 6 <mapper namespace ="com.baizhi.dao.UserDAO" > <select id ="login" parameterType ="User" resultType ="User" > select * from user where name=#{name} and password = #{password} </select > </mapper >
1 2 3 public interface UserService { User login (User user) ; }
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 @Service @Transactional public class UserServiceImpl implements UserService { @Autowired private UserDAO userDAO; @Override @Transactional(propagation = Propagation.SUPPORTS) public User login (User user) { User userDB = userDAO.login(user); if (userDB!=null ){ return userDB; } throw new RuntimeException("登录失败~~" ); } }
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 @RestController @Slf4j public class UserController { @Autowired private UserService userService; @GetMapping("/user/login") public Map<String,Object> login (User user) { Map<String,Object> result = new HashMap<>(); log.info("用户名: [{}]" , user.getName()); log.info("密码: [{}]" , user.getPassword()); try { User userDB = userService.login(user); Map<String, String> map = new HashMap<>(); map.put("id" ,userDB.getId()); map.put("username" , userDB.getName()); String token = JWTUtils.getToken(map); result.put("state" ,true ); result.put("msg" ,"登录成功!!!" ); result.put("token" ,token); } catch (Exception e) { e.printStackTrace(); result.put("state" ,"false" ); result.put("msg" ,e.getMessage()); } return result; } }
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 @PostMapping("/test/test") public Map<String, Object> test (String token) { Map<String, Object> map = new HashMap<>(); try { JWTUtils.verify(token); map.put("msg" , "验证通过~~~" ); map.put("state" , true ); } catch (TokenExpiredException e) { map.put("state" , false ); map.put("msg" , "Token已经过期!!!" ); } catch (SignatureVerificationException e){ map.put("state" , false ); map.put("msg" , "签名错误!!!" ); } catch (AlgorithmMismatchException e){ map.put("state" , false ); map.put("msg" , "加密算法不匹配!!!" ); } catch (Exception e) { e.printStackTrace(); map.put("state" , false ); map.put("msg" , "无效token~~" ); } return map; }
1 2 3 # 11.问题? - 使用上述方式每次都要传递token数据,每个方法都需要验证token代码冗余,不够灵活? 如何优化- 使用拦截器进行优化
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 @Override public boolean preHandle (HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token = request.getHeader("token" ); Map<String,Object> map = new HashMap<>(); try { JWTUtils.verify(token); return true ; } catch (TokenExpiredException e) { map.put("state" , false ); map.put("msg" , "Token已经过期!!!" ); } catch (SignatureVerificationException e){ map.put("state" , false ); map.put("msg" , "签名错误!!!" ); } catch (AlgorithmMismatchException e){ map.put("state" , false ); map.put("msg" , "加密算法不匹配!!!" ); } catch (Exception e) { e.printStackTrace(); map.put("state" , false ); map.put("msg" , "无效token~~" ); } String json = new ObjectMapper().writeValueAsString(map); response.setContentType("application/json;charset=UTF-8" ); response.getWriter().println(json); return false ; }
1 2 3 4 5 6 7 8 9 @Component public class InterceptorConfig implements WebMvcConfigurer { @Override public void addInterceptors (InterceptorRegistry registry) { registry.addInterceptor(new JwtTokenInterceptor()). excludePathPatterns("/user/**" ) .addPathPatterns("/**" ); } }
10.参考文章
11.GitHub源码 springboot-jwt