干货|一个案例学会Spring Security 中使用 JWT
在先后端分离的项目中，登陆策略也有很多，不过 JWT 算是目前比较流行的一种解决方案了，本文就和你们来分享一下如何将 Spring Security 和 JWT 结合在一块儿使用，进而实现先后端分离时的登陆解决方案。前端
1 无状态登陆
1.1 什么是有状态？
有状态服务，即服务端须要记录每次会话的客户端信息，从而识别客户端身份，根据用户身份进行请求的处理，典型的设计如Tomcat中的Session。例如登陆：用户登陆后，咱们把用户的信息保存在服务端session中，而且给用户一个cookie值，记录对应的session，而后下次请求，用户携带cookie值来（这一步有浏览器自动完成），咱们就能识别到对应session，从而找到用户的信息。这种方式目前来看最方便，可是也有一些缺陷，以下：java
- 服务端保存大量数据，增长服务端压力
- 服务端保存用户状态，不支持集群化部署
1.2 什么是无状态
微服务集群中的每一个服务，对外提供的都使用RESTful风格的接口。而RESTful风格的一个最重要的规范就是：服务的无状态性，即：git
- 服务端不保存任何客户端请求者信息
- 客户端的每次请求必须具有自描述信息，经过这些信息识别客户端身份
那么这种无状态性有哪些好处呢？github
- 客户端请求不依赖服务端的信息，屡次请求不须要必须访问到同一台服务器
- 服务端的集群和状态对客户端透明
- 服务端能够任意的迁移和伸缩（能够方便的进行集群化部署）
- 减少服务端存储压力
1.3.如何实现无状态
无状态登陆的流程：web
- 首先客户端发送帐户名/密码到服务端进行认证
- 认证经过后，服务端将用户信息加密而且编码成一个token，返回给客户端
- 之后客户端每次发送请求，都须要携带认证的token
- 服务端对客户端发送来的token进行解密，判断是否有效，而且获取用户登陆信息
1.4 JWT
1.4.1 简介
JWT，全称是Json Web Token， 是一种JSON风格的轻量级的受权和身份认证规范，可实现无状态、分布式的Web应用受权： redis
JWT 做为一种规范，并无和某一种语言绑定在一块儿，经常使用的Java 实现是GitHub 上的开源项目 jjwt，地址以下：https://github.com/jwtk/jjwt算法
1.4.2 JWT数据格式
JWT包含三部分数据：spring
-
Header：头部，一般头部有两部分信息：数据库
- 声明类型，这里是JWT
- 加密算法，自定义
咱们会对头部进行Base64Url编码（可解码），获得第一部分数据。json
-
Payload：载荷，就是有效数据，在官方文档中(RFC7519)，这里给了7个示例信息：
- iss (issuer)：表示签发人
- exp (expiration time)：表示token过时时间
- sub (subject)：主题
- aud (audience)：受众
- nbf (Not Before)：生效时间
- iat (Issued At)：签发时间
- jti (JWT ID)：编号
这部分也会采用Base64Url编码，获得第二部分数据。
- Signature：签名，是整个数据的认证信息。通常根据前两步的数据，再加上服务的的密钥secret（密钥保存在服务端，不能泄露给客户端），经过Header中配置的加密算法生成。用于验证整个数据完整和可靠性。
生成的数据格式以下图：
注意，这里的数据经过 . 隔开成了三部分，分别对应前面提到的三部分，另外，这里数据是不换行的，图片换行只是为了展现方便而已。
1.4.3 JWT交互流程
流程图：
步骤翻译：
- 应用程序或客户端向受权服务器请求受权
- 获取到受权后，受权服务器会向应用程序返回访问令牌
- 应用程序使用访问令牌来访问受保护资源（如API）
由于JWT签发的token中已经包含了用户的身份信息，而且每次请求都会携带，这样服务的就无需保存用户信息，甚至无需去数据库查询，这样就彻底符合了RESTful的无状态规范。
1.5 JWT 存在的问题
说了这么多，JWT 也不是完美无缺，由客户端维护登陆状态带来的一些问题在这里依然存在，举例以下：
- 续签问题，这是被不少人诟病的问题之一，传统的cookie+session的方案自然的支持续签，可是jwt因为服务端不保存用户状态，所以很难完美解决续签问题，若是引入redis，虽然能够解决问题，可是jwt也变得不三不四了。
- 注销问题，因为服务端再也不保存用户信息，因此通常能够经过修改secret来实现注销，服务端secret修改后，已经颁发的未过时的token就会认证失败，进而实现注销，不过毕竟没有传统的注销方便。
- 密码重置，密码重置后，本来的token依然能够访问系统，这时候也须要强制修改secret。
- 基于第2点和第3点，通常建议不一样用户取不一样secret。
2 实战
说了这么久，接下来咱们就来看看这个东西到底要怎么用？
2.1 环境搭建
首先咱们来建立一个Spring Boot项目，建立时须要添加Spring Security依赖，建立完成后，添加 jjwt 依赖，完整的pom.xml文件以下：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt</artifactId>
<version>0.9.1</version>
</dependency>
而后在项目中建立一个简单的 User 对象实现 UserDetails 接口，以下：
public class User implements UserDetails {
private String username;
private String password;
private List<GrantedAuthority> authorities;
public String getUsername() {
return username;
}
@Override
public boolean isAccountNonExpired() {
return true;
}
@Override
public boolean isAccountNonLocked() {
return true;
}
@Override
public boolean isCredentialsNonExpired() {
return true;
}
@Override
public boolean isEnabled() {
return true;
}
//省略getter/setter
}
这个就是咱们的用户对象，先放着备用，再建立一个HelloController，内容以下：
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "hello jwt !";
}
@GetMapping("/admin")
public String admin() {
return "hello admin !";
}
}
HelloController 很简单，这里有两个接口，设计是 /hello 接口能够被具备 user 角色的用户访问，而 /admin 接口则能够被具备 admin 角色的用户访问。
2.2 JWT 过滤器配置
接下来提供两个和 JWT 相关的过滤器配置：
- 一个是用户登陆的过滤器，在用户的登陆的过滤器中校验用户是否登陆成功，若是登陆成功，则生成一个token返回给客户端，登陆失败则给前端一个登陆失败的提示。
- 第二个过滤器则是当其余请求发送来，校验token的过滤器，若是校验成功，就让请求继续执行。
这两个过滤器，咱们分别来看，先看第一个：
public class JwtLoginFilter extends AbstractAuthenticationProcessingFilter {
protected JwtLoginFilter(String defaultFilterProcessesUrl, AuthenticationManager authenticationManager) {
super(new AntPathRequestMatcher(defaultFilterProcessesUrl));
setAuthenticationManager(authenticationManager);
}
@Override
public Authentication attemptAuthentication(HttpServletRequest req, HttpServletResponse resp) throws AuthenticationException, IOException, ServletException {
User user = new ObjectMapper().readValue(req.getInputStream(), User.class);
return getAuthenticationManager().authenticate(new UsernamePasswordAuthenticationToken(user.getUsername(), user.getPassword()));
}
@Override
protected void successfulAuthentication(HttpServletRequest req, HttpServletResponse resp, FilterChain chain, Authentication authResult) throws IOException, ServletException {
Collection<? extends GrantedAuthority> authorities = authResult.getAuthorities();
StringBuffer as = new StringBuffer();
for (GrantedAuthority authority : authorities) {
as.append(authority.getAuthority())
.append(",");
}
String jwt = Jwts.builder()
.claim("authorities", as)//配置用户角色
.setSubject(authResult.getName())
.setExpiration(new Date(System.currentTimeMillis() + 10 * 60 * 1000))
.signWith(SignatureAlgorithm.HS512,"sang@123")
.compact();
resp.setContentType("application/json;charset=utf-8");
PrintWriter out = resp.getWriter();
out.write(new ObjectMapper().writeValueAsString(jwt));
out.flush();
out.close();
}
protected void unsuccessfulAuthentication(HttpServletRequest req, HttpServletResponse resp, AuthenticationException failed) throws IOException, ServletException {
resp.setContentType("application/json;charset=utf-8");
PrintWriter out = resp.getWriter();
out.write("登陆失败!");
out.flush();
out.close();
}
}
关于这个类，我说以下几点：
- 自定义 JwtLoginFilter 继承自 AbstractAuthenticationProcessingFilter，并实现其中的三个默认方法。
- attemptAuthentication方法中，咱们从登陆参数中提取出用户名密码，而后调用AuthenticationManager.authenticate()方法去进行自动校验。
- 第二步若是校验成功，就会来到successfulAuthentication回调中，在successfulAuthentication方法中，将用户角色遍历而后用一个
,链接起来，而后再利用Jwts去生成token，按照代码的顺序，生成过程一共配置了四个参数，分别是用户角色、主题、过时时间以及加密算法和密钥，而后将生成的token写出到客户端。 - 第二步若是校验失败就会来到unsuccessfulAuthentication方法中，在这个方法中返回一个错误提示给客户端便可。
再来看第二个token校验的过滤器：
public class JwtFilter extends GenericFilterBean {
@Override
public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
HttpServletRequest req = (HttpServletRequest) servletRequest;
String jwtToken = req.getHeader("authorization");
System.out.println(jwtToken);
Claims claims = Jwts.parser().setSigningKey("sang@123").parseClaimsJws(jwtToken.replace("Bearer",""))
.getBody();
String username = claims.getSubject();//获取当前登陆用户名
List<GrantedAuthority> authorities = AuthorityUtils.commaSeparatedStringToAuthorityList((String) claims.get("authorities"));
UsernamePasswordAuthenticationToken token = new UsernamePasswordAuthenticationToken(username, null, authorities);
SecurityContextHolder.getContext().setAuthentication(token);
filterChain.doFilter(req,servletResponse);
}
}
关于这个过滤器，我说以下几点：
- 首先从请求头中提取出 authorization 字段，这个字段对应的value就是用户的token。
- 将提取出来的token字符串转换为一个Claims对象，再从Claims对象中提取出当前用户名和用户角色，建立一个UsernamePasswordAuthenticationToken放到当前的Context中，而后执行过滤链使请求继续执行下去。
如此以后，两个和JWT相关的过滤器就算配置好了。
2.3 Spring Security 配置
接下来咱们来配置 Spring Security,以下：
@Configuration
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {
@Bean
PasswordEncoder passwordEncoder() {
return NoOpPasswordEncoder.getInstance();
}
@Override
protected void configure(AuthenticationManagerBuilder auth) throws Exception {
auth.inMemoryAuthentication().withUser("admin")
.password("123").roles("admin")
.and()
.withUser("sang")
.password("456")
.roles("user");
}
@Override
protected void configure(HttpSecurity http) throws Exception {
http.authorizeRequests()
.antMatchers("/hello").hasRole("user")
.antMatchers("/admin").hasRole("admin")
.antMatchers(HttpMethod.POST, "/login").permitAll()
.anyRequest().authenticated()
.and()
.addFilterBefore(new JwtLoginFilter("/login",authenticationManager()),UsernamePasswordAuthenticationFilter.class)
.addFilterBefore(new JwtFilter(),UsernamePasswordAuthenticationFilter.class)
.csrf().disable();
}
}
- 简单起见，这里我并未对密码进行加密，所以配置了NoOpPasswordEncoder的实例。
- 简单起见，这里并未链接数据库，我直接在内存中配置了两个用户，两个用户具有不一样的角色。
- 配置路径规则时，
/hello接口必需要具有 user 角色才能访问，/admin接口必需要具有 admin 角色才能访问，POST 请求而且是/login接口则能够直接经过，其余接口必须认证后才能访问。 - 最后配置上两个自定义的过滤器而且关闭掉csrf保护。
2.4 测试
作完这些以后，咱们的环境就算彻底搭建起来了，接下来启动项目而后在 POSTMAN 中进行测试，以下：
登陆成功后返回的字符串就是通过 base64url 转码的token，一共有三部分，经过一个 . 隔开，咱们能够对第一个 . 以前的字符串进行解码，即Header，以下：
再对两个 . 之间的字符解码，即 payload：
能够看到，咱们设置信息，因为base64并非加密方案，只是一种编码方案，所以，不建议将敏感的用户信息放到token中。
接下来再去访问 /hello 接口，注意认证方式选择 Bearer Token，Token值为刚刚获取到的值，以下：
能够看到，访问成功。
总结
这就是 JWT 结合 Spring Security 的一个简单用法，讲真，若是实例容许，相似的需求我仍是推荐使用 OAuth2 中的 password 模式。
不知道大伙有没有看懂呢？若是没看懂，松哥还有一个关于这个知识点的视频教程，以下：
如何获取这个视频教程呢？很简单，将本文转发到一个超过100人的微信群中(QQ群不算，松哥是群主的微信群也不算，群要为Java方向)，或者多个微信群中，只要累计人数达到100人便可，而后加松哥微信，截图发给松哥便可获取资料。
关注公众号【江南一点雨】，专一于 Spring Boot+微服务以及先后端分离等全栈技术，按期视频教程分享，关注后回复 Java ，领取松哥为你精心准备的 Java 干货！
- 1. 干货|一个案例学会Spring Security 中使用 JWT
- 2. Spring Security 实战干货：使用 JWT 认证访问接口
- 3. Spring Security + JWT学习
- 4. Spring Security 实战干货：手把手教你实现JWT Token
- 5. Spring Security 实战干货： 登陆成功后返回 JWT Token
- 6. Spring Security 实战干货： 登陆后返回 JWT Token
- 7. Spring Security With JWT
- 8. spring-security 与 jwt
- 9. Spring Boot中使用使用Spring Security和JWT
- 10. Spring Security JWT
- 更多相关文章...
- • 在Spring中使用Redis - Redis教程
- • 第一个Spring程序 - Spring教程
- • Java Agent入门实战（一）-Instrumentation介绍与使用
- • Kotlin学习（一）基本语法
-
每一个你不满意的现在，都有一个你没有努力的曾经。
- 1. 外部其他进程嵌入到qt FindWindow获得窗口句柄 报错无法链接的外部符号 [email protected] 无法被([email protected]@[email protected]@@引用
- 2. UVa 11524 - InCircle
- 3. The Monocycle（bfs）
- 4. VEC-C滑窗
- 5. 堆排序的应用-TOPK问题
- 6. 实例演示ElasticSearch索引查询term,match,match_phase,query_string之间的区别
- 7. 数学基础知识 集合
- 8. amazeUI 复择框问题解决
- 9. 背包问题理解
- 10. 算数平均-几何平均不等式的证明,从麦克劳林到柯西
- 1. 干货|一个案例学会Spring Security 中使用 JWT
- 2. Spring Security 实战干货：使用 JWT 认证访问接口
- 3. Spring Security + JWT学习
- 4. Spring Security 实战干货：手把手教你实现JWT Token
- 5. Spring Security 实战干货： 登陆成功后返回 JWT Token
- 6. Spring Security 实战干货： 登陆后返回 JWT Token
- 7. Spring Security With JWT
- 8. spring-security 与 jwt
- 9. Spring Boot中使用使用Spring Security和JWT
- 10. Spring Security JWT