SpringSecurity

课程介绍

image-20211219121555979.png

0. 简介

  1. **Spring Security** Spring 家族中的一个安全管理框架。相比与另外一个安全框架**Shiro**,它提供了更丰富的功能,社区资源也比Shiro丰富。
  2. 一般来说中大型的项目都是使用**SpringSecurity** 来做安全框架。小项目有Shiro的比较多,因为相比与SpringSecurityShiro的上手更加的简单。
  3. 一般Web应用的需要进行**认证**和**授权**。
  4. **认证:验证当前访问系统的是不是本系统的用户,并且要确认具体是哪个用户**
  5. **授权:经过认证后判断当前用户是否有权限进行某个操作**
  6. 而认证和授权也是SpringSecurity作为安全框架的核心功能。

1. 快速入门

1.1 准备工作

  1. 我们先要搭建一个简单的SpringBoot工程

① 设置父工程 添加依赖

  1. <parent>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-parent</artifactId>
  4. <version>2.5.0</version>
  5. </parent>
  6. <dependencies>
  7. <dependency>
  8. <groupId>org.springframework.boot</groupId>
  9. <artifactId>spring-boot-starter-web</artifactId>
  10. </dependency>
  11. <dependency>
  12. <groupId>org.projectlombok</groupId>
  13. <artifactId>lombok</artifactId>
  14. <optional>true</optional>
  15. </dependency>
  16. </dependencies>

② 创建启动类

  1. @SpringBootApplication
  2. public class SecurityApplication {
  3. public static void main(String[] args) {
  4. SpringApplication.run(SecurityApplication.class,args);
  5. }
  6. }

③ 创建Controller

  1. import org.springframework.web.bind.annotation.RequestMapping;
  2. import org.springframework.web.bind.annotation.RestController;
  3. @RestController
  4. public class HelloController {
  5. @RequestMapping("/hello")
  6. public String hello(){
  7. return "hello";
  8. }
  9. }

1.2 引入SpringSecurity

  1. SpringBoot项目中使用SpringSecurity我们只需要引入依赖即可实现入门案例。
  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-security</artifactId>
  4. </dependency>
  1. 引入依赖后我们在尝试去访问之前的接口就会自动跳转到一个SpringSecurity的默认登陆页面,默认用户名是user,密码会输出在控制台。
  2. 必须登陆之后才能对接口进行访问。

2. 认证

2.1 登陆校验流程

image-20211215093906256.png

2.2 原理初探

  1. 想要知道如何实现自己的登陆流程就必须要先知道入门案例中SpringSecurity的流程。

2.2.1 SpringSecurity完整流程

  1. SpringSecurity的原理其实就是一个过滤器链,内部包含了提供各种功能的过滤器。这里我们可以看看入门案例中的过滤器。

image-20211214144425527.png

  1. 图中只展示了核心过滤器,其它的非核心过滤器并没有在图中展示。

UsernamePasswordAuthenticationFilter:负责处理我们在登陆页面填写了用户名密码后的登陆请求。入门案例的认证工作主要有它负责。

ExceptionTranslationFilter:处理过滤器链中抛出的任何AccessDeniedException和AuthenticationException 。

FilterSecurityInterceptor:负责权限校验的过滤器。

image.png

  1. 我们可以通过Debug查看当前系统中SpringSecurity过滤器链中有哪些过滤器及它们的顺序。<br />![image-20211214145824903.png](https://cdn.nlark.com/yuque/0/2022/png/25966321/1650846044522-71aaf59a-5386-4c02-93b0-ad708f1e3f3c.png#clientId=ubd0befa4-da32-4&crop=0&crop=0&crop=1&crop=1&from=drop&id=uda89b97b&margin=%5Bobject%20Object%5D&name=image-20211214145824903.png&originHeight=478&originWidth=675&originalType=binary&ratio=1&rotation=0&showTitle=false&size=56426&status=done&style=none&taskId=ud46da752-da73-4993-b195-f294efd763d&title=)

2.2.2 认证流程详解

image-20211214151515385.png
image-20211215095331510.png概念速查:

Authentication接口: 它的实现类,表示当前访问系统的用户,封装了用户相关信息。

AuthenticationManager接口:定义了认证Authentication的方法

UserDetailsService接口:加载用户特定数据的核心接口。里面定义了一个根据用户名查询用户信息的方法。

UserDetails接口:提供核心用户信息。通过UserDetailsService根据用户名获取处理的用户信息要封装成UserDetails对象返回。然后将这些信息封装到Authentication对象中。

2.3 解决问题

2.3.1 思路分析

登录

  1. ①自定义登录接口
  2. 调用ProviderManager的方法进行认证 如果认证通过生成jwt
  3. 把用户信息存入redis
  4. ②自定义UserDetailsService
  5. 在这个实现类中去查询数据库

校验:

  1. ①定义Jwt认证过滤器
  2. 获取token
  3. 解析token获取其中的userid
  4. redis中获取用户信息
  5. 存入SecurityContextHolder

2.3.2 准备工作

①添加依赖

  1. <!--redis依赖-->
  2. <dependency>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-starter-data-redis</artifactId>
  5. </dependency>
  6. <!--fastjson依赖-->
  7. <dependency>
  8. <groupId>com.alibaba</groupId>
  9. <artifactId>fastjson</artifactId>
  10. <version>1.2.33</version>
  11. </dependency>
  12. <!--jwt依赖-->
  13. <dependency>
  14. <groupId>io.jsonwebtoken</groupId>
  15. <artifactId>jjwt</artifactId>
  16. <version>0.9.0</version>
  17. </dependency>

② 添加Redis相关配置

  1. import com.alibaba.fastjson.JSON;
  2. import com.alibaba.fastjson.serializer.SerializerFeature;
  3. import com.fasterxml.jackson.databind.JavaType;
  4. import com.fasterxml.jackson.databind.ObjectMapper;
  5. import com.fasterxml.jackson.databind.type.TypeFactory;
  6. import org.springframework.data.redis.serializer.RedisSerializer;
  7. import org.springframework.data.redis.serializer.SerializationException;
  8. import com.alibaba.fastjson.parser.ParserConfig;
  9. import org.springframework.util.Assert;
  10. import java.nio.charset.Charset;
  11. /**
  12. * Redis使用FastJson序列化
  13. *
  14. * @author sg
  15. */
  16. public class FastJsonRedisSerializer<T> implements RedisSerializer<T>
  17. {
  18. public static final Charset DEFAULT_CHARSET = Charset.forName("UTF-8");
  19. private Class<T> clazz;
  20. static
  21. {
  22. ParserConfig.getGlobalInstance().setAutoTypeSupport(true);
  23. }
  24. public FastJsonRedisSerializer(Class<T> clazz)
  25. {
  26. super();
  27. this.clazz = clazz;
  28. }
  29. @Override
  30. public byte[] serialize(T t) throws SerializationException
  31. {
  32. if (t == null)
  33. {
  34. return new byte[0];
  35. }
  36. return JSON.toJSONString(t, SerializerFeature.WriteClassName).getBytes(DEFAULT_CHARSET);
  37. }
  38. @Override
  39. public T deserialize(byte[] bytes) throws SerializationException
  40. {
  41. if (bytes == null || bytes.length <= 0)
  42. {
  43. return null;
  44. }
  45. String str = new String(bytes, DEFAULT_CHARSET);
  46. return JSON.parseObject(str, clazz);
  47. }
  48. protected JavaType getJavaType(Class<?> clazz)
  49. {
  50. return TypeFactory.defaultInstance().constructType(clazz);
  51. }
  52. }
  1. import org.springframework.context.annotation.Bean;
  2. import org.springframework.context.annotation.Configuration;
  3. import org.springframework.data.redis.connection.RedisConnectionFactory;
  4. import org.springframework.data.redis.core.RedisTemplate;
  5. import org.springframework.data.redis.serializer.StringRedisSerializer;
  6. @Configuration
  7. public class RedisConfig {
  8. @Bean
  9. @SuppressWarnings(value = { "unchecked", "rawtypes" })
  10. public RedisTemplate<Object, Object> redisTemplate(RedisConnectionFactory connectionFactory)
  11. {
  12. RedisTemplate<Object, Object> template = new RedisTemplate<>();
  13. template.setConnectionFactory(connectionFactory);
  14. FastJsonRedisSerializer serializer = new FastJsonRedisSerializer(Object.class);
  15. // 使用StringRedisSerializer来序列化和反序列化redis的key值
  16. template.setKeySerializer(new StringRedisSerializer());
  17. template.setValueSerializer(serializer);
  18. // Hash的key也采用StringRedisSerializer的序列化方式
  19. template.setHashKeySerializer(new StringRedisSerializer());
  20. template.setHashValueSerializer(serializer);
  21. template.afterPropertiesSet();
  22. return template;
  23. }
  24. }

③ 响应类

  1. import com.fasterxml.jackson.annotation.JsonInclude;
  2. /**
  3. * @Author 三更 B站: https://space.bilibili.com/663528522
  4. */
  5. @JsonInclude(JsonInclude.Include.NON_NULL)
  6. public class ResponseResult<T> {
  7. /**
  8. * 状态码
  9. */
  10. private Integer code;
  11. /**
  12. * 提示信息,如果有错误时,前端可以获取该字段进行提示
  13. */
  14. private String msg;
  15. /**
  16. * 查询到的结果数据,
  17. */
  18. private T data;
  19. public ResponseResult(Integer code, String msg) {
  20. this.code = code;
  21. this.msg = msg;
  22. }
  23. public ResponseResult(Integer code, T data) {
  24. this.code = code;
  25. this.data = data;
  26. }
  27. public Integer getCode() {
  28. return code;
  29. }
  30. public void setCode(Integer code) {
  31. this.code = code;
  32. }
  33. public String getMsg() {
  34. return msg;
  35. }
  36. public void setMsg(String msg) {
  37. this.msg = msg;
  38. }
  39. public T getData() {
  40. return data;
  41. }
  42. public void setData(T data) {
  43. this.data = data;
  44. }
  45. public ResponseResult(Integer code, String msg, T data) {
  46. this.code = code;
  47. this.msg = msg;
  48. this.data = data;
  49. }
  50. }

④工具类

  1. import io.jsonwebtoken.Claims;
  2. import io.jsonwebtoken.JwtBuilder;
  3. import io.jsonwebtoken.Jwts;
  4. import io.jsonwebtoken.SignatureAlgorithm;
  5. import javax.crypto.SecretKey;
  6. import javax.crypto.spec.SecretKeySpec;
  7. import java.util.Base64;
  8. import java.util.Date;
  9. import java.util.UUID;
  10. /**
  11. * JWT工具类
  12. */
  13. public class JwtUtil {
  14. //有效期为
  15. public static final Long JWT_TTL = 60 * 60 *1000L;// 60 * 60 *1000 一个小时
  16. //设置秘钥明文
  17. public static final String JWT_KEY = "sangeng";
  18. public static String getUUID(){
  19. String token = UUID.randomUUID().toString().replaceAll("-", "");
  20. return token;
  21. }
  22. /**
  23. * 生成jtw
  24. * @param subject token中要存放的数据(json格式)
  25. * @return
  26. */
  27. public static String createJWT(String subject) {
  28. JwtBuilder builder = getJwtBuilder(subject, null, getUUID());// 设置过期时间
  29. return builder.compact();
  30. }
  31. /**
  32. * 生成jtw
  33. * @param subject token中要存放的数据(json格式)
  34. * @param ttlMillis token超时时间
  35. * @return
  36. */
  37. public static String createJWT(String subject, Long ttlMillis) {
  38. JwtBuilder builder = getJwtBuilder(subject, ttlMillis, getUUID());// 设置过期时间
  39. return builder.compact();
  40. }
  41. private static JwtBuilder getJwtBuilder(String subject, Long ttlMillis, String uuid) {
  42. SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256;
  43. SecretKey secretKey = generalKey();
  44. long nowMillis = System.currentTimeMillis();
  45. Date now = new Date(nowMillis);
  46. if(ttlMillis==null){
  47. ttlMillis=JwtUtil.JWT_TTL;
  48. }
  49. long expMillis = nowMillis + ttlMillis;
  50. Date expDate = new Date(expMillis);
  51. return Jwts.builder()
  52. .setId(uuid) //唯一的ID
  53. .setSubject(subject) // 主题 可以是JSON数据
  54. .setIssuer("sg") // 签发者
  55. .setIssuedAt(now) // 签发时间
  56. .signWith(signatureAlgorithm, secretKey) //使用HS256对称加密算法签名, 第二个参数为秘钥
  57. .setExpiration(expDate);
  58. }
  59. /**
  60. * 创建token
  61. * @param id
  62. * @param subject
  63. * @param ttlMillis
  64. * @return
  65. */
  66. public static String createJWT(String id, String subject, Long ttlMillis) {
  67. JwtBuilder builder = getJwtBuilder(subject, ttlMillis, id);// 设置过期时间
  68. return builder.compact();
  69. }
  70. public static void main(String[] args) throws Exception {
  71. String token = "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJjYWM2ZDVhZi1mNjVlLTQ0MDAtYjcxMi0zYWEwOGIyOTIwYjQiLCJzdWIiOiJzZyIsImlzcyI6InNnIiwiaWF0IjoxNjM4MTA2NzEyLCJleHAiOjE2MzgxMTAzMTJ9.JVsSbkP94wuczb4QryQbAke3ysBDIL5ou8fWsbt_ebg";
  72. Claims claims = parseJWT(token);
  73. System.out.println(claims);
  74. }
  75. /**
  76. * 生成加密后的秘钥 secretKey
  77. * @return
  78. */
  79. public static SecretKey generalKey() {
  80. byte[] encodedKey = Base64.getDecoder().decode(JwtUtil.JWT_KEY);
  81. SecretKey key = new SecretKeySpec(encodedKey, 0, encodedKey.length, "AES");
  82. return key;
  83. }
  84. /**
  85. * 解析
  86. *
  87. * @param jwt
  88. * @return
  89. * @throws Exception
  90. */
  91. public static Claims parseJWT(String jwt) throws Exception {
  92. SecretKey secretKey = generalKey();
  93. return Jwts.parser()
  94. .setSigningKey(secretKey)
  95. .parseClaimsJws(jwt)
  96. .getBody();
  97. }
  98. }
  1. import java.util.*;
  2. import java.util.concurrent.TimeUnit;
  3. @SuppressWarnings(value = { "unchecked", "rawtypes" })
  4. @Component
  5. public class RedisCache
  6. {
  7. @Autowired
  8. public RedisTemplate redisTemplate;
  9. /**
  10. * 缓存基本的对象,Integer、String、实体类等
  11. *
  12. * @param key 缓存的键值
  13. * @param value 缓存的值
  14. */
  15. public <T> void setCacheObject(final String key, final T value)
  16. {
  17. redisTemplate.opsForValue().set(key, value);
  18. }
  19. /**
  20. * 缓存基本的对象,Integer、String、实体类等
  21. *
  22. * @param key 缓存的键值
  23. * @param value 缓存的值
  24. * @param timeout 时间
  25. * @param timeUnit 时间颗粒度
  26. */
  27. public <T> void setCacheObject(final String key, final T value, final Integer timeout, final TimeUnit timeUnit)
  28. {
  29. redisTemplate.opsForValue().set(key, value, timeout, timeUnit);
  30. }
  31. /**
  32. * 设置有效时间
  33. *
  34. * @param key Redis键
  35. * @param timeout 超时时间
  36. * @return true=设置成功;false=设置失败
  37. */
  38. public boolean expire(final String key, final long timeout)
  39. {
  40. return expire(key, timeout, TimeUnit.SECONDS);
  41. }
  42. /**
  43. * 设置有效时间
  44. *
  45. * @param key Redis键
  46. * @param timeout 超时时间
  47. * @param unit 时间单位
  48. * @return true=设置成功;false=设置失败
  49. */
  50. public boolean expire(final String key, final long timeout, final TimeUnit unit)
  51. {
  52. return redisTemplate.expire(key, timeout, unit);
  53. }
  54. /**
  55. * 获得缓存的基本对象。
  56. *
  57. * @param key 缓存键值
  58. * @return 缓存键值对应的数据
  59. */
  60. public <T> T getCacheObject(final String key)
  61. {
  62. ValueOperations<String, T> operation = redisTemplate.opsForValue();
  63. return operation.get(key);
  64. }
  65. /**
  66. * 删除单个对象
  67. *
  68. * @param key
  69. */
  70. public boolean deleteObject(final String key)
  71. {
  72. return redisTemplate.delete(key);
  73. }
  74. /**
  75. * 删除集合对象
  76. *
  77. * @param collection 多个对象
  78. * @return
  79. */
  80. public long deleteObject(final Collection collection)
  81. {
  82. return redisTemplate.delete(collection);
  83. }
  84. /**
  85. * 缓存List数据
  86. *
  87. * @param key 缓存的键值
  88. * @param dataList 待缓存的List数据
  89. * @return 缓存的对象
  90. */
  91. public <T> long setCacheList(final String key, final List<T> dataList)
  92. {
  93. Long count = redisTemplate.opsForList().rightPushAll(key, dataList);
  94. return count == null ? 0 : count;
  95. }
  96. /**
  97. * 获得缓存的list对象
  98. *
  99. * @param key 缓存的键值
  100. * @return 缓存键值对应的数据
  101. */
  102. public <T> List<T> getCacheList(final String key)
  103. {
  104. return redisTemplate.opsForList().range(key, 0, -1);
  105. }
  106. /**
  107. * 缓存Set
  108. *
  109. * @param key 缓存键值
  110. * @param dataSet 缓存的数据
  111. * @return 缓存数据的对象
  112. */
  113. public <T> BoundSetOperations<String, T> setCacheSet(final String key, final Set<T> dataSet)
  114. {
  115. BoundSetOperations<String, T> setOperation = redisTemplate.boundSetOps(key);
  116. Iterator<T> it = dataSet.iterator();
  117. while (it.hasNext())
  118. {
  119. setOperation.add(it.next());
  120. }
  121. return setOperation;
  122. }
  123. /**
  124. * 获得缓存的set
  125. *
  126. * @param key
  127. * @return
  128. */
  129. public <T> Set<T> getCacheSet(final String key)
  130. {
  131. return redisTemplate.opsForSet().members(key);
  132. }
  133. /**
  134. * 缓存Map
  135. *
  136. * @param key
  137. * @param dataMap
  138. */
  139. public <T> void setCacheMap(final String key, final Map<String, T> dataMap)
  140. {
  141. if (dataMap != null) {
  142. redisTemplate.opsForHash().putAll(key, dataMap);
  143. }
  144. }
  145. /**
  146. * 获得缓存的Map
  147. *
  148. * @param key
  149. * @return
  150. */
  151. public <T> Map<String, T> getCacheMap(final String key)
  152. {
  153. return redisTemplate.opsForHash().entries(key);
  154. }
  155. /**
  156. * 往Hash中存入数据
  157. *
  158. * @param key Redis键
  159. * @param hKey Hash键
  160. * @param value 值
  161. */
  162. public <T> void setCacheMapValue(final String key, final String hKey, final T value)
  163. {
  164. redisTemplate.opsForHash().put(key, hKey, value);
  165. }
  166. /**
  167. * 获取Hash中的数据
  168. *
  169. * @param key Redis键
  170. * @param hKey Hash键
  171. * @return Hash中的对象
  172. */
  173. public <T> T getCacheMapValue(final String key, final String hKey)
  174. {
  175. HashOperations<String, String, T> opsForHash = redisTemplate.opsForHash();
  176. return opsForHash.get(key, hKey);
  177. }
  178. /**
  179. * 删除Hash中的数据
  180. *
  181. * @param key
  182. * @param hkey
  183. */
  184. public void delCacheMapValue(final String key, final String hkey)
  185. {
  186. HashOperations hashOperations = redisTemplate.opsForHash();
  187. hashOperations.delete(key, hkey);
  188. }
  189. /**
  190. * 获取多个Hash中的数据
  191. *
  192. * @param key Redis键
  193. * @param hKeys Hash键集合
  194. * @return Hash对象集合
  195. */
  196. public <T> List<T> getMultiCacheMapValue(final String key, final Collection<Object> hKeys)
  197. {
  198. return redisTemplate.opsForHash().multiGet(key, hKeys);
  199. }
  200. /**
  201. * 获得缓存的基本对象列表
  202. *
  203. * @param pattern 字符串前缀
  204. * @return 对象列表
  205. */
  206. public Collection<String> keys(final String pattern)
  207. {
  208. return redisTemplate.keys(pattern);
  209. }
  210. }
  1. import javax.servlet.http.HttpServletResponse;
  2. import java.io.IOException;
  3. public class WebUtils
  4. {
  5. /**
  6. * 将字符串渲染到客户端
  7. *
  8. * @param response 渲染对象
  9. * @param string 待渲染的字符串
  10. * @return null
  11. */
  12. public static String renderString(HttpServletResponse response, String string) {
  13. try
  14. {
  15. response.setStatus(200);
  16. response.setContentType("application/json");
  17. response.setCharacterEncoding("utf-8");
  18. response.getWriter().print(string);
  19. }
  20. catch (IOException e)
  21. {
  22. e.printStackTrace();
  23. }
  24. return null;
  25. }
  26. }

⑤实体类

  1. import java.io.Serializable;
  2. import java.util.Date;
  3. /**
  4. * 用户表(User)实体类
  5. *
  6. * @author 三更
  7. */
  8. @Data
  9. @AllArgsConstructor
  10. @NoArgsConstructor
  11. public class User implements Serializable {
  12. private static final long serialVersionUID = -40356785423868312L;
  13. /**
  14. * 主键
  15. */
  16. private Long id;
  17. /**
  18. * 用户名
  19. */
  20. private String userName;
  21. /**
  22. * 昵称
  23. */
  24. private String nickName;
  25. /**
  26. * 密码
  27. */
  28. private String password;
  29. /**
  30. * 账号状态(0正常 1停用)
  31. */
  32. private String status;
  33. /**
  34. * 邮箱
  35. */
  36. private String email;
  37. /**
  38. * 手机号
  39. */
  40. private String phonenumber;
  41. /**
  42. * 用户性别(0男,1女,2未知)
  43. */
  44. private String sex;
  45. /**
  46. * 头像
  47. */
  48. private String avatar;
  49. /**
  50. * 用户类型(0管理员,1普通用户)
  51. */
  52. private String userType;
  53. /**
  54. * 创建人的用户id
  55. */
  56. private Long createBy;
  57. /**
  58. * 创建时间
  59. */
  60. private Date createTime;
  61. /**
  62. * 更新人
  63. */
  64. private Long updateBy;
  65. /**
  66. * 更新时间
  67. */
  68. private Date updateTime;
  69. /**
  70. * 删除标志(0代表未删除,1代表已删除)
  71. */
  72. private Integer delFlag;
  73. }

2.3.3 实现

2.3.3.1 数据库校验用户
  1. 从之前的分析我们可以知道,我们可以自定义一个UserDetailsService,让SpringSecurity使用我们的UserDetailsService。我们自己的UserDetailsService可以从数据库中查询用户名和密码。

准备工作
  1. 我们先创建一个用户表, 建表语句如下:
  1. CREATE TABLE `sys_user` (
  2. `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
  3. `user_name` VARCHAR(64) NOT NULL DEFAULT 'NULL' COMMENT '用户名',
  4. `nick_name` VARCHAR(64) NOT NULL DEFAULT 'NULL' COMMENT '昵称',
  5. `password` VARCHAR(64) NOT NULL DEFAULT 'NULL' COMMENT '密码',
  6. `status` CHAR(1) DEFAULT '0' COMMENT '账号状态(0正常 1停用)',
  7. `email` VARCHAR(64) DEFAULT NULL COMMENT '邮箱',
  8. `phonenumber` VARCHAR(32) DEFAULT NULL COMMENT '手机号',
  9. `sex` CHAR(1) DEFAULT NULL COMMENT '用户性别(0男,1女,2未知)',
  10. `avatar` VARCHAR(128) DEFAULT NULL COMMENT '头像',
  11. `user_type` CHAR(1) NOT NULL DEFAULT '1' COMMENT '用户类型(0管理员,1普通用户)',
  12. `create_by` BIGINT(20) DEFAULT NULL COMMENT '创建人的用户id',
  13. `create_time` DATETIME DEFAULT NULL COMMENT '创建时间',
  14. `update_by` BIGINT(20) DEFAULT NULL COMMENT '更新人',
  15. `update_time` DATETIME DEFAULT NULL COMMENT '更新时间',
  16. `del_flag` INT(11) DEFAULT '0' COMMENT '删除标志(0代表未删除,1代表已删除)',
  17. PRIMARY KEY (`id`)
  18. ) ENGINE=INNODB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4 COMMENT='用户表'
  1. 引入MybatisPulsmysql驱动的依赖
  1. <dependency>
  2. <groupId>com.baomidou</groupId>
  3. <artifactId>mybatis-plus-boot-starter</artifactId>
  4. <version>3.4.3</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>mysql</groupId>
  8. <artifactId>mysql-connector-java</artifactId>
  9. </dependency>
  1. 配置数据库信息
  1. spring:
  2. datasource:
  3. url: jdbc:mysql://localhost:3306/sg_security?characterEncoding=utf-8&serverTimezone=UTC
  4. username: root
  5. password: root
  6. driver-class-name: com.mysql.cj.jdbc.Driver
  1. 定义Mapper接口
  1. public interface UserMapper extends BaseMapper<User> {
  2. }
  1. 修改User实体类
  1. 类名上加@TableName(value = "sys_user") ,id字段上加 @TableId
  1. 配置Mapper扫描
  1. @SpringBootApplication
  2. @MapperScan("com.sangeng.mapper")
  3. public class SimpleSecurityApplication {
  4. public static void main(String[] args) {
  5. ConfigurableApplicationContext run = SpringApplication.run(SimpleSecurityApplication.class);
  6. System.out.println(run);
  7. }
  8. }
  1. 添加junit依赖
  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-test</artifactId>
  4. </dependency>
  1. 测试MP是否能正常使用
  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @SpringBootTest
  5. public class MapperTest {
  6. @Autowired
  7. private UserMapper userMapper;
  8. @Test
  9. public void testUserMapper(){
  10. List<User> users = userMapper.selectList(null);
  11. System.out.println(users);
  12. }
  13. }

核心代码实现

创建一个类实现UserDetailsService接口,重写其中的方法。更加用户名从数据库中查询用户信息

  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @Service
  5. public class UserDetailsServiceImpl implements UserDetailsService {
  6. @Autowired
  7. private UserMapper userMapper;
  8. @Override
  9. public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
  10. //根据用户名查询用户信息
  11. LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
  12. wrapper.eq(User::getUserName,username);
  13. User user = userMapper.selectOne(wrapper);
  14. //如果查询不到数据就通过抛出异常来给出提示
  15. if(Objects.isNull(user)){
  16. throw new RuntimeException("用户名或密码错误");
  17. }
  18. //TODO 根据用户查询权限信息 添加到LoginUser中
  19. //封装成UserDetails对象返回
  20. return new LoginUser(user);
  21. }
  22. }

因为UserDetailsService方法的返回值是UserDetails类型,所以需要定义一个类,实现该接口,把用户信息封装在其中。

  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @Data
  5. @NoArgsConstructor
  6. @AllArgsConstructor
  7. public class LoginUser implements UserDetails {
  8. private User user;
  9. @Override
  10. public Collection<? extends GrantedAuthority> getAuthorities() {
  11. return null;
  12. }
  13. @Override
  14. public String getPassword() {
  15. return user.getPassword();
  16. }
  17. @Override
  18. public String getUsername() {
  19. return user.getUserName();
  20. }
  21. @Override
  22. public boolean isAccountNonExpired() {
  23. return true;
  24. }
  25. @Override
  26. public boolean isAccountNonLocked() {
  27. return true;
  28. }
  29. @Override
  30. public boolean isCredentialsNonExpired() {
  31. return true;
  32. }
  33. @Override
  34. public boolean isEnabled() {
  35. return true;
  36. }
  37. }

注意:如果要测试,需要往用户表中写入用户数据,并且如果你想让用户的密码是明文存储,需要在密码前加{noop}。例如
image-20211216123945882.png
这样登陆的时候就可以用sg作为用户名,1234作为密码来登陆了。

2.3.3.2 密码加密存储
  1. 实际项目中我们不会把密码明文存储在数据库中。
  2. 默认使用的PasswordEncoder要求数据库中的密码格式为:{id}password 。它会根据id去判断密码的加密方式。但是我们一般不会采用这种方式。所以就需要替换PasswordEncoder
  3. 我们一般使用SpringSecurity为我们提供的BCryptPasswordEncoder
  4. 我们只需要使用把BCryptPasswordEncoder对象注入Spring容器中,SpringSecurity就会使用该PasswordEncoder来进行密码校验。
  5. 我们可以定义一个SpringSecurity的配置类,SpringSecurity要求这个配置类要继承WebSecurityConfigurerAdapter
  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @Configuration
  5. public class SecurityConfig extends WebSecurityConfigurerAdapter {
  6. @Bean
  7. public PasswordEncoder passwordEncoder(){
  8. return new BCryptPasswordEncoder();
  9. }
  10. }

2.3.3.3 登陆接口
  1. 接下我们需要自定义登陆接口,然后让SpringSecurity对这个接口放行,让用户访问这个接口的时候不用登录也能访问。
  2. 在接口中我们通过AuthenticationManagerauthenticate方法来进行用户认证,所以需要在SecurityConfig中配置把AuthenticationManager注入容器。
  3. 认证成功的话要生成一个jwt,放入响应中返回。并且为了让用户下回请求时能通过jwt识别出具体的是哪个用户,我们需要把用户信息存入redis,可以把用户id作为key
  1. @RestController
  2. public class LoginController {
  3. @Autowired
  4. private LoginServcie loginServcie;
  5. @PostMapping("/user/login")
  6. public ResponseResult login(@RequestBody User user){
  7. return loginServcie.login(user);
  8. }
  9. }
  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @Configuration
  5. public class SecurityConfig extends WebSecurityConfigurerAdapter {
  6. @Bean
  7. public PasswordEncoder passwordEncoder(){
  8. return new BCryptPasswordEncoder();
  9. }
  10. @Override
  11. protected void configure(HttpSecurity http) throws Exception {
  12. http
  13. //关闭csrf
  14. .csrf().disable()
  15. //不通过Session获取SecurityContext
  16. .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
  17. .and()
  18. .authorizeRequests()
  19. // 对于登录接口 允许匿名访问
  20. .antMatchers("/user/login").anonymous()
  21. // 除上面外的所有请求全部需要鉴权认证
  22. .anyRequest().authenticated();
  23. }
  24. @Bean
  25. @Override
  26. public AuthenticationManager authenticationManagerBean() throws Exception {
  27. return super.authenticationManagerBean();
  28. }
  29. }
  1. @Service
  2. public class LoginServiceImpl implements LoginServcie {
  3. @Autowired
  4. private AuthenticationManager authenticationManager;
  5. @Autowired
  6. private RedisCache redisCache;
  7. @Override
  8. public ResponseResult login(User user) {
  9. UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(user.getUserName(),user.getPassword());
  10. Authentication authenticate = authenticationManager.authenticate(authenticationToken);
  11. if(Objects.isNull(authenticate)){
  12. throw new RuntimeException("用户名或密码错误");
  13. }
  14. //使用userid生成token
  15. LoginUser loginUser = (LoginUser) authenticate.getPrincipal();
  16. String userId = loginUser.getUser().getId().toString();
  17. String jwt = JwtUtil.createJWT(userId);
  18. //authenticate存入redis
  19. redisCache.setCacheObject("login:"+userId,loginUser);
  20. //把token响应给前端
  21. HashMap<String,String> map = new HashMap<>();
  22. map.put("token",jwt);
  23. return new ResponseResult(200,"登陆成功",map);
  24. }
  25. }

2.3.3.4 认证过滤器
  1. 我们需要自定义一个过滤器,这个过滤器会去获取请求头中的token,对token进行解析取出其中的userid
  2. 使用useridredis中获取对应的LoginUser对象。
  3. 然后封装Authentication对象存入SecurityContextHolder
  1. @Component
  2. public class JwtAuthenticationTokenFilter extends OncePerRequestFilter {
  3. @Autowired
  4. private RedisCache redisCache;
  5. @Override
  6. protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
  7. //获取token
  8. String token = request.getHeader("token");
  9. if (!StringUtils.hasText(token)) {
  10. //放行
  11. filterChain.doFilter(request, response);
  12. return;
  13. }
  14. //解析token
  15. String userid;
  16. try {
  17. Claims claims = JwtUtil.parseJWT(token);
  18. userid = claims.getSubject();
  19. } catch (Exception e) {
  20. e.printStackTrace();
  21. throw new RuntimeException("token非法");
  22. }
  23. //从redis中获取用户信息
  24. String redisKey = "login:" + userid;
  25. LoginUser loginUser = redisCache.getCacheObject(redisKey);
  26. if(Objects.isNull(loginUser)){
  27. throw new RuntimeException("用户未登录");
  28. }
  29. //存入SecurityContextHolder
  30. //TODO 获取权限信息封装到Authentication中
  31. UsernamePasswordAuthenticationToken authenticationToken =
  32. new UsernamePasswordAuthenticationToken(loginUser,null,null);
  33. SecurityContextHolder.getContext().setAuthentication(authenticationToken);
  34. //放行
  35. filterChain.doFilter(request, response);
  36. }
  37. }
  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @Configuration
  5. public class SecurityConfig extends WebSecurityConfigurerAdapter {
  6. @Bean
  7. public PasswordEncoder passwordEncoder(){
  8. return new BCryptPasswordEncoder();
  9. }
  10. @Autowired
  11. JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter;
  12. @Override
  13. protected void configure(HttpSecurity http) throws Exception {
  14. http
  15. //关闭csrf
  16. .csrf().disable()
  17. //不通过Session获取SecurityContext
  18. .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
  19. .and()
  20. .authorizeRequests()
  21. // 对于登录接口 允许匿名访问
  22. .antMatchers("/user/login").anonymous()
  23. // 除上面外的所有请求全部需要鉴权认证
  24. .anyRequest().authenticated();
  25. //把token校验过滤器添加到过滤器链中
  26. http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class);
  27. }
  28. @Bean
  29. @Override
  30. public AuthenticationManager authenticationManagerBean() throws Exception {
  31. return super.authenticationManagerBean();
  32. }
  33. }

2.3.3.5 退出登陆
  1. 我们只需要定义一个登陆接口,然后获取SecurityContextHolder中的认证信息,删除redis中对应的数据即可。
  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @Service
  5. public class LoginServiceImpl implements LoginServcie {
  6. @Autowired
  7. private AuthenticationManager authenticationManager;
  8. @Autowired
  9. private RedisCache redisCache;
  10. @Override
  11. public ResponseResult login(User user) {
  12. UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(user.getUserName(),user.getPassword());
  13. Authentication authenticate = authenticationManager.authenticate(authenticationToken);
  14. if(Objects.isNull(authenticate)){
  15. throw new RuntimeException("用户名或密码错误");
  16. }
  17. //使用userid生成token
  18. LoginUser loginUser = (LoginUser) authenticate.getPrincipal();
  19. String userId = loginUser.getUser().getId().toString();
  20. String jwt = JwtUtil.createJWT(userId);
  21. //authenticate存入redis
  22. redisCache.setCacheObject("login:"+userId,loginUser);
  23. //把token响应给前端
  24. HashMap<String,String> map = new HashMap<>();
  25. map.put("token",jwt);
  26. return new ResponseResult(200,"登陆成功",map);
  27. }
  28. @Override
  29. public ResponseResult logout() {
  30. Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
  31. LoginUser loginUser = (LoginUser) authentication.getPrincipal();
  32. Long userid = loginUser.getUser().getId();
  33. redisCache.deleteObject("login:"+userid);
  34. return new ResponseResult(200,"退出成功");
  35. }
  36. }

3. 授权

3.0 权限系统的作用

  1. 例如一个学校图书馆的管理系统,如果是普通学生登录就能看到借书还书相关的功能,不可能让他看到并且去使用添加书籍信息,删除书籍信息等功能。但是如果是一个图书馆管理员的账号登录了,应该就能看到并使用添加书籍信息,删除书籍信息等功能。
  2. 总结起来就是**不同的用户可以使用不同的功能**。这就是权限系统要去实现的效果。
  3. 我们不能只依赖前端去判断用户的权限来选择显示哪些菜单哪些按钮。因为如果只是这样,如果有人知道了对应功能的接口地址就可以不通过前端,直接去发送请求来实现相关功能操作。
  4. 所以我们还需要在后台进行用户权限的判断,判断当前用户是否有相应的权限,必须具有所需权限才能进行相应的操作。

3.1 授权基本流程

  1. SpringSecurity中,会使用默认的FilterSecurityInterceptor来进行权限校验。在FilterSecurityInterceptor中会从SecurityContextHolder获取其中的Authentication,然后获取其中的权限信息。当前用户是否拥有访问当前资源所需的权限。
  2. 所以我们在项目中只需要把当前登录用户的权限信息也存入Authentication
  3. 然后设置我们的资源所需要的权限即可。

3.2 授权实现

3.2.1 限制访问资源所需权限

  1. SpringSecurity为我们提供了基于注解的权限控制方案,这也是我们项目中主要采用的方式。我们可以使用注解去指定访问对应的资源所需的权限。
  2. 但是要使用它我们需要先开启相关配置。
  1. @EnableGlobalMethodSecurity(prePostEnabled = true)
  1. 然后就可以使用对应的注解。[@PreAuthorize ](/PreAuthorize )
  1. @RestController
  2. public class HelloController {
  3. @RequestMapping("/hello")
  4. @PreAuthorize("hasAuthority('test')")
  5. public String hello(){
  6. return "hello";
  7. }
  8. }

3.2.2 封装权限信息

  1. 我们前面在写UserDetailsServiceImpl的时候说过,在查询出用户后还要获取对应的权限信息,封装到UserDetails中返回。
  2. 我们先直接把权限信息写死封装到UserDetails中进行测试。
  3. 我们之前定义了UserDetails的实现类LoginUser,想要让其能封装权限信息就要对其进行修改。
  1. package com.sangeng.domain;
  2. import com.alibaba.fastjson.annotation.JSONField;
  3. import lombok.AllArgsConstructor;
  4. import lombok.Data;
  5. import lombok.NoArgsConstructor;
  6. import org.springframework.security.core.GrantedAuthority;
  7. import org.springframework.security.core.authority.SimpleGrantedAuthority;
  8. import org.springframework.security.core.userdetails.UserDetails;
  9. import java.util.Collection;
  10. import java.util.List;
  11. import java.util.stream.Collectors;
  12. /**
  13. * @Author 三更 B站: https://space.bilibili.com/663528522
  14. */
  15. @Data
  16. @NoArgsConstructor
  17. public class LoginUser implements UserDetails {
  18. private User user;
  19. //存储权限信息
  20. private List<String> permissions;
  21. public LoginUser(User user,List<String> permissions) {
  22. this.user = user;
  23. this.permissions = permissions;
  24. }
  25. //存储SpringSecurity所需要的权限信息的集合
  26. @JSONField(serialize = false)
  27. private List<GrantedAuthority> authorities;
  28. @Override
  29. public Collection<? extends GrantedAuthority> getAuthorities() {
  30. if(authorities!=null){
  31. return authorities;
  32. }
  33. //把permissions中字符串类型的权限信息转换成GrantedAuthority对象存入authorities中
  34. authorities = permissions.stream().
  35. map(SimpleGrantedAuthority::new)
  36. .collect(Collectors.toList());
  37. return authorities;
  38. }
  39. @Override
  40. public String getPassword() {
  41. return user.getPassword();
  42. }
  43. @Override
  44. public String getUsername() {
  45. return user.getUserName();
  46. }
  47. @Override
  48. public boolean isAccountNonExpired() {
  49. return true;
  50. }
  51. @Override
  52. public boolean isAccountNonLocked() {
  53. return true;
  54. }
  55. @Override
  56. public boolean isCredentialsNonExpired() {
  57. return true;
  58. }
  59. @Override
  60. public boolean isEnabled() {
  61. return true;
  62. }
  63. }
  1. LoginUser修改完后我们就可以在UserDetailsServiceImpl中去把权限信息封装到LoginUser中了。我们写死权限进行测试,后面我们再从数据库中查询权限信息。
  1. package com.sangeng.service.impl;
  2. import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
  3. import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
  4. import com.baomidou.mybatisplus.extension.conditions.query.LambdaQueryChainWrapper;
  5. import com.sangeng.domain.LoginUser;
  6. import com.sangeng.domain.User;
  7. import com.sangeng.mapper.UserMapper;
  8. import org.springframework.beans.factory.annotation.Autowired;
  9. import org.springframework.security.core.userdetails.UserDetails;
  10. import org.springframework.security.core.userdetails.UserDetailsService;
  11. import org.springframework.security.core.userdetails.UsernameNotFoundException;
  12. import org.springframework.stereotype.Service;
  13. import java.util.ArrayList;
  14. import java.util.Arrays;
  15. import java.util.List;
  16. import java.util.Objects;
  17. /**
  18. * @Author 三更 B站: https://space.bilibili.com/663528522
  19. */
  20. @Service
  21. public class UserDetailsServiceImpl implements UserDetailsService {
  22. @Autowired
  23. private UserMapper userMapper;
  24. @Override
  25. public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
  26. LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
  27. wrapper.eq(User::getUserName,username);
  28. User user = userMapper.selectOne(wrapper);
  29. if(Objects.isNull(user)){
  30. throw new RuntimeException("用户名或密码错误");
  31. }
  32. //TODO 根据用户查询权限信息 添加到LoginUser中
  33. List<String> list = new ArrayList<>(Arrays.asList("test"));
  34. return new LoginUser(user,list);
  35. }
  36. }

3.2.3 从数据库查询权限信息

3.2.3.1 RBAC权限模型
  1. RBAC权限模型(Role-Based Access Control)即:基于角色的权限控制。这是目前最常被开发者使用也是相对易用、通用权限模型。<br />![image-20211222110238165.png](https://cdn.nlark.com/yuque/0/2022/png/25966321/1650846130929-b9e1e692-ec50-4ffa-b7e0-e1d63630f9d4.png#clientId=ubd0befa4-da32-4&crop=0&crop=0&crop=1&crop=1&from=drop&id=u1961a7e8&margin=%5Bobject%20Object%5D&name=image-20211222110238165.png&originHeight=716&originWidth=1187&originalType=binary&ratio=1&rotation=0&showTitle=false&size=59299&status=done&style=none&taskId=ud46723a4-effc-4f34-ae34-94649c8a771&title=)

3.2.3.2 准备工作
  1. CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_security` /*!40100 DEFAULT CHARACTER SET utf8mb4 */;
  2. USE `sg_security`;
  3. /*Table structure for table `sys_menu` */
  4. DROP TABLE IF EXISTS `sys_menu`;
  5. CREATE TABLE `sys_menu` (
  6. `id` bigint(20) NOT NULL AUTO_INCREMENT,
  7. `menu_name` varchar(64) NOT NULL DEFAULT 'NULL' COMMENT '菜单名',
  8. `path` varchar(200) DEFAULT NULL COMMENT '路由地址',
  9. `component` varchar(255) DEFAULT NULL COMMENT '组件路径',
  10. `visible` char(1) DEFAULT '0' COMMENT '菜单状态(0显示 1隐藏)',
  11. `status` char(1) DEFAULT '0' COMMENT '菜单状态(0正常 1停用)',
  12. `perms` varchar(100) DEFAULT NULL COMMENT '权限标识',
  13. `icon` varchar(100) DEFAULT '#' COMMENT '菜单图标',
  14. `create_by` bigint(20) DEFAULT NULL,
  15. `create_time` datetime DEFAULT NULL,
  16. `update_by` bigint(20) DEFAULT NULL,
  17. `update_time` datetime DEFAULT NULL,
  18. `del_flag` int(11) DEFAULT '0' COMMENT '是否删除(0未删除 1已删除)',
  19. `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  20. PRIMARY KEY (`id`)
  21. ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4 COMMENT='菜单表';
  22. /*Table structure for table `sys_role` */
  23. DROP TABLE IF EXISTS `sys_role`;
  24. CREATE TABLE `sys_role` (
  25. `id` bigint(20) NOT NULL AUTO_INCREMENT,
  26. `name` varchar(128) DEFAULT NULL,
  27. `role_key` varchar(100) DEFAULT NULL COMMENT '角色权限字符串',
  28. `status` char(1) DEFAULT '0' COMMENT '角色状态(0正常 1停用)',
  29. `del_flag` int(1) DEFAULT '0' COMMENT 'del_flag',
  30. `create_by` bigint(200) DEFAULT NULL,
  31. `create_time` datetime DEFAULT NULL,
  32. `update_by` bigint(200) DEFAULT NULL,
  33. `update_time` datetime DEFAULT NULL,
  34. `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  35. PRIMARY KEY (`id`)
  36. ) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb4 COMMENT='角色表';
  37. /*Table structure for table `sys_role_menu` */
  38. DROP TABLE IF EXISTS `sys_role_menu`;
  39. CREATE TABLE `sys_role_menu` (
  40. `role_id` bigint(200) NOT NULL AUTO_INCREMENT COMMENT '角色ID',
  41. `menu_id` bigint(200) NOT NULL DEFAULT '0' COMMENT '菜单id',
  42. PRIMARY KEY (`role_id`,`menu_id`)
  43. ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4;
  44. /*Table structure for table `sys_user` */
  45. DROP TABLE IF EXISTS `sys_user`;
  46. CREATE TABLE `sys_user` (
  47. `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
  48. `user_name` varchar(64) NOT NULL DEFAULT 'NULL' COMMENT '用户名',
  49. `nick_name` varchar(64) NOT NULL DEFAULT 'NULL' COMMENT '昵称',
  50. `password` varchar(64) NOT NULL DEFAULT 'NULL' COMMENT '密码',
  51. `status` char(1) DEFAULT '0' COMMENT '账号状态(0正常 1停用)',
  52. `email` varchar(64) DEFAULT NULL COMMENT '邮箱',
  53. `phonenumber` varchar(32) DEFAULT NULL COMMENT '手机号',
  54. `sex` char(1) DEFAULT NULL COMMENT '用户性别(0男,1女,2未知)',
  55. `avatar` varchar(128) DEFAULT NULL COMMENT '头像',
  56. `user_type` char(1) NOT NULL DEFAULT '1' COMMENT '用户类型(0管理员,1普通用户)',
  57. `create_by` bigint(20) DEFAULT NULL COMMENT '创建人的用户id',
  58. `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  59. `update_by` bigint(20) DEFAULT NULL COMMENT '更新人',
  60. `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  61. `del_flag` int(11) DEFAULT '0' COMMENT '删除标志(0代表未删除,1代表已删除)',
  62. PRIMARY KEY (`id`)
  63. ) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb4 COMMENT='用户表';
  64. /*Table structure for table `sys_user_role` */
  65. DROP TABLE IF EXISTS `sys_user_role`;
  66. CREATE TABLE `sys_user_role` (
  67. `user_id` bigint(200) NOT NULL AUTO_INCREMENT COMMENT '用户id',
  68. `role_id` bigint(200) NOT NULL DEFAULT '0' COMMENT '角色id',
  69. PRIMARY KEY (`user_id`,`role_id`)
  70. ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
  1. SELECT
  2. DISTINCT m.`perms`
  3. FROM
  4. sys_user_role ur
  5. LEFT JOIN `sys_role` r ON ur.`role_id` = r.`id`
  6. LEFT JOIN `sys_role_menu` rm ON ur.`role_id` = rm.`role_id`
  7. LEFT JOIN `sys_menu` m ON m.`id` = rm.`menu_id`
  8. WHERE
  9. user_id = 2
  10. AND r.`status` = 0
  11. AND m.`status` = 0
  1. package com.sangeng.domain;
  2. import com.baomidou.mybatisplus.annotation.TableId;
  3. import com.baomidou.mybatisplus.annotation.TableName;
  4. import com.fasterxml.jackson.annotation.JsonInclude;
  5. import lombok.AllArgsConstructor;
  6. import lombok.Data;
  7. import lombok.NoArgsConstructor;
  8. import java.io.Serializable;
  9. import java.util.Date;
  10. /**
  11. * 菜单表(Menu)实体类
  12. *
  13. * @author makejava
  14. * @since 2021-11-24 15:30:08
  15. */
  16. @TableName(value="sys_menu")
  17. @Data
  18. @AllArgsConstructor
  19. @NoArgsConstructor
  20. @JsonInclude(JsonInclude.Include.NON_NULL)
  21. public class Menu implements Serializable {
  22. private static final long serialVersionUID = -54979041104113736L;
  23. @TableId
  24. private Long id;
  25. /**
  26. * 菜单名
  27. */
  28. private String menuName;
  29. /**
  30. * 路由地址
  31. */
  32. private String path;
  33. /**
  34. * 组件路径
  35. */
  36. private String component;
  37. /**
  38. * 菜单状态(0显示 1隐藏)
  39. */
  40. private String visible;
  41. /**
  42. * 菜单状态(0正常 1停用)
  43. */
  44. private String status;
  45. /**
  46. * 权限标识
  47. */
  48. private String perms;
  49. /**
  50. * 菜单图标
  51. */
  52. private String icon;
  53. private Long createBy;
  54. private Date createTime;
  55. private Long updateBy;
  56. private Date updateTime;
  57. /**
  58. * 是否删除(0未删除 1已删除)
  59. */
  60. private Integer delFlag;
  61. /**
  62. * 备注
  63. */
  64. private String remark;
  65. }

3.2.3.3 代码实现
  1. 我们只需要根据用户id去查询到其所对应的权限信息即可。
  2. 所以我们可以先定义个mapper,其中提供一个方法可以根据userid查询权限信息。
  1. import com.baomidou.mybatisplus.core.mapper.BaseMapper;
  2. import com.sangeng.domain.Menu;
  3. import java.util.List;
  4. /**
  5. * @Author 三更 B站: https://space.bilibili.com/663528522
  6. */
  7. public interface MenuMapper extends BaseMapper<Menu> {
  8. List<String> selectPermsByUserId(Long id);
  9. }
  1. 尤其是自定义方法,所以需要创建对应的mapper文件,定义对应的sql语句
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
  3. <mapper namespace="com.sangeng.mapper.MenuMapper">
  4. <select id="selectPermsByUserId" resultType="java.lang.String">
  5. SELECT
  6. DISTINCT m.`perms`
  7. FROM
  8. sys_user_role ur
  9. LEFT JOIN `sys_role` r ON ur.`role_id` = r.`id`
  10. LEFT JOIN `sys_role_menu` rm ON ur.`role_id` = rm.`role_id`
  11. LEFT JOIN `sys_menu` m ON m.`id` = rm.`menu_id`
  12. WHERE
  13. user_id = #{userid}
  14. AND r.`status` = 0
  15. AND m.`status` = 0
  16. </select>
  17. </mapper>
  1. application.yml中配置mapperXML文件的位置
  1. spring:
  2. datasource:
  3. url: jdbc:mysql://localhost:3306/sg_security?characterEncoding=utf-8&serverTimezone=UTC
  4. username: root
  5. password: root
  6. driver-class-name: com.mysql.cj.jdbc.Driver
  7. redis:
  8. host: localhost
  9. port: 6379
  10. mybatis-plus:
  11. mapper-locations: classpath*:/mapper/**/*.xml
  1. 然后我们可以在UserDetailsServiceImpl中去调用该mapper的方法查询权限信息封装到LoginUser对象中即可。
  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @Service
  5. public class UserDetailsServiceImpl implements UserDetailsService {
  6. @Autowired
  7. private UserMapper userMapper;
  8. @Autowired
  9. private MenuMapper menuMapper;
  10. @Override
  11. public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
  12. LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
  13. wrapper.eq(User::getUserName,username);
  14. User user = userMapper.selectOne(wrapper);
  15. if(Objects.isNull(user)){
  16. throw new RuntimeException("用户名或密码错误");
  17. }
  18. List<String> permissionKeyList = menuMapper.selectPermsByUserId(user.getId());
  19. // //测试写法
  20. // List<String> list = new ArrayList<>(Arrays.asList("test"));
  21. return new LoginUser(user,permissionKeyList);
  22. }
  23. }

4. 自定义失败处理

  1. 我们还希望在认证失败或者是授权失败的情况下也能和我们的接口一样返回相同结构的json,这样可以让前端能对响应进行统一的处理。要实现这个功能我们需要知道SpringSecurity的异常处理机制。
  2. SpringSecurity中,如果我们在认证或者授权的过程中出现了异常会被ExceptionTranslationFilter捕获到。在ExceptionTranslationFilter中会去判断是认证失败还是授权失败出现的异常。
  3. 如果是认证过程中出现的异常会被封装成AuthenticationException然后调用**AuthenticationEntryPoint**对象的方法去进行异常处理。
  4. 如果是授权过程中出现的异常会被封装成AccessDeniedException然后调用**AccessDeniedHandler**对象的方法去进行异常处理。
  5. 所以如果我们需要自定义异常处理,我们只需要自定义AuthenticationEntryPointAccessDeniedHandler然后配置给SpringSecurity即可。

①自定义实现类

  1. @Component
  2. public class AccessDeniedHandlerImpl implements AccessDeniedHandler {
  3. @Override
  4. public void handle(HttpServletRequest request, HttpServletResponse response, AccessDeniedException accessDeniedException) throws IOException, ServletException {
  5. ResponseResult result = new ResponseResult(HttpStatus.FORBIDDEN.value(), "权限不足");
  6. String json = JSON.toJSONString(result);
  7. WebUtils.renderString(response,json);
  8. }
  9. }
  1. /**
  2. * @Author 三更 B站: https://space.bilibili.com/663528522
  3. */
  4. @Component
  5. public class AuthenticationEntryPointImpl implements AuthenticationEntryPoint {
  6. @Override
  7. public void commence(HttpServletRequest request, HttpServletResponse response, AuthenticationException authException) throws IOException, ServletException {
  8. ResponseResult result = new ResponseResult(HttpStatus.UNAUTHORIZED.value(), "认证失败请重新登录");
  9. String json = JSON.toJSONString(result);
  10. WebUtils.renderString(response,json);
  11. }
  12. }

②配置给SpringSecurity

  1. 先注入对应的处理器
  1. @Autowired
  2. private AuthenticationEntryPoint authenticationEntryPoint;
  3. @Autowired
  4. private AccessDeniedHandler accessDeniedHandler;
  1. 然后我们可以使用HttpSecurity对象的方法去配置。
  1. http.exceptionHandling().authenticationEntryPoint(authenticationEntryPoint).
  2. accessDeniedHandler(accessDeniedHandler);

5. 跨域

  1. 浏览器出于安全的考虑,使用 XMLHttpRequest对象发起 HTTP请求时必须遵守同源策略,否则就是跨域的HTTP请求,默认情况下是被禁止的。 同源策略要求源相同才能正常进行通信,即协议、域名、端口号都完全一致。
  2. 前后端分离项目,前端项目和后端项目一般都不是同源的,所以肯定会存在跨域请求的问题。
  3. 所以我们就要处理一下,让前端能进行跨域请求。

①先对SpringBoot配置,运行跨域请求

  1. @Configuration
  2. public class CorsConfig implements WebMvcConfigurer {
  3. @Override
  4. public void addCorsMappings(CorsRegistry registry) {
  5. // 设置允许跨域的路径
  6. registry.addMapping("/**")
  7. // 设置允许跨域请求的域名
  8. .allowedOriginPatterns("*")
  9. // 是否允许cookie
  10. .allowCredentials(true)
  11. // 设置允许的请求方式
  12. .allowedMethods("GET", "POST", "DELETE", "PUT")
  13. // 设置允许的header属性
  14. .allowedHeaders("*")
  15. // 跨域允许时间
  16. .maxAge(3600);
  17. }
  18. }

②开启SpringSecurity的跨域访问

由于我们的资源都会收到SpringSecurity的保护,所以想要跨域访问还要让SpringSecurity运行跨域访问。

  1. @Override
  2. protected void configure(HttpSecurity http) throws Exception {
  3. http
  4. //关闭csrf
  5. .csrf().disable()
  6. //不通过Session获取SecurityContext
  7. .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
  8. .and()
  9. .authorizeRequests()
  10. // 对于登录接口 允许匿名访问
  11. .antMatchers("/user/login").anonymous()
  12. // 除上面外的所有请求全部需要鉴权认证
  13. .anyRequest().authenticated();
  14. //添加过滤器
  15. http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class);
  16. //配置异常处理器
  17. http.exceptionHandling()
  18. //配置认证失败处理器
  19. .authenticationEntryPoint(authenticationEntryPoint)
  20. .accessDeniedHandler(accessDeniedHandler);
  21. //允许跨域
  22. http.cors();
  23. }

6. 遗留小问题

其它权限校验方法

  1. 我们前面都是使用@PreAuthorize注解,然后在在其中使用的是hasAuthority方法进行校验。SpringSecurity还为我们提供了其它方法例如:hasAnyAuthorityhasRolehasAnyRole等。
  2. 这里我们先不急着去介绍这些方法,我们先去理解hasAuthority的原理,然后再去学习其他方法你就更容易理解,而不是死记硬背区别。并且我们也可以选择定义校验方法,实现我们自己的校验逻辑。
  3. hasAuthority方法实际是执行到了SecurityExpressionRoothasAuthority,大家只要断点调试既可知道它内部的校验原理。
  4. 它内部其实是调用authenticationgetAuthorities方法获取用户的权限列表。然后判断我们存入的方法参数数据在权限列表中。
  5. hasAnyAuthority方法可以传入多个权限,只有用户有其中任意一个权限都可以访问对应资源。
  1. @PreAuthorize("hasAnyAuthority('admin','test','system:dept:list')")
  2. public String hello(){
  3. return "hello";
  4. }
  1. hasRole要求有对应的角色才可以访问,但是它内部会把我们传入的参数拼接上 **ROLE_** 后再去比较。所以这种情况下要用用户对应的权限也要有 **ROLE_** 这个前缀才可以。
  1. @PreAuthorize("hasRole('system:dept:list')")
  2. public String hello(){
  3. return "hello";
  4. }
  1. hasAnyRole 有任意的角色就可以访问。它内部也会把我们传入的参数拼接上 **ROLE_** 后再去比较。所以这种情况下要用用户对应的权限也要有 **ROLE_** 这个前缀才可以。
  1. @PreAuthorize("hasAnyRole('admin','system:dept:list')")
  2. public String hello(){
  3. return "hello";
  4. }

自定义权限校验方法

  1. 我们也可以定义自己的权限校验方法,在@PreAuthorize注解中使用我们的方法。
  1. @Component("ex")
  2. public class SGExpressionRoot {
  3. public boolean hasAuthority(String authority){
  4. //获取当前用户的权限
  5. Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
  6. LoginUser loginUser = (LoginUser) authentication.getPrincipal();
  7. List<String> permissions = loginUser.getPermissions();
  8. //判断用户权限集合中是否存在authority
  9. return permissions.contains(authority);
  10. }
  11. }
  1. SPEL表达式中使用 @ex相当于获取容器中bean的名字未ex的对象。然后再调用这个对象的hasAuthority方法
  1. @RequestMapping("/hello")
  2. @PreAuthorize("@ex.hasAuthority('system:dept:list')")
  3. public String hello(){
  4. return "hello";
  5. }

基于配置的权限控制

  1. 我们也可以在配置类中使用使用配置的方式对资源进行权限控制。
  1. @Override
  2. protected void configure(HttpSecurity http) throws Exception {
  3. http
  4. //关闭csrf
  5. .csrf().disable()
  6. //不通过Session获取SecurityContext
  7. .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
  8. .and()
  9. .authorizeRequests()
  10. // 对于登录接口 允许匿名访问
  11. .antMatchers("/user/login").anonymous()
  12. .antMatchers("/testCors").hasAuthority("system:dept:list222")
  13. // 除上面外的所有请求全部需要鉴权认证
  14. .anyRequest().authenticated();
  15. //添加过滤器
  16. http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class);
  17. //配置异常处理器
  18. http.exceptionHandling()
  19. //配置认证失败处理器
  20. .authenticationEntryPoint(authenticationEntryPoint)
  21. .accessDeniedHandler(accessDeniedHandler);
  22. //允许跨域
  23. http.cors();
  24. }

CSRF

  1. CSRF是指跨站请求伪造(Cross-site request forgery),是web常见的攻击之一。
  2. [https://blog.csdn.net/freeking101/article/details/86537087](https://blog.csdn.net/freeking101/article/details/86537087)
  3. SpringSecurity去防止CSRF攻击的方式就是通过csrf_token。后端会生成一个csrf_token,前端发起请求的时候需要携带这个csrf_token,后端会有过滤器进行校验,如果没有携带或者是伪造的就不允许访问。
  4. 我们可以发现CSRF攻击依靠的是cookie中所携带的认证信息。但是在前后端分离的项目中我们的认证信息其实是token,而token并不是存储中cookie中,并且需要前端代码去把token设置到请求头中才可以,所以CSRF攻击也就不用担心了。

认证成功处理器

  1. 实际上在UsernamePasswordAuthenticationFilter进行登录认证的时候,如果登录成功了是会调用AuthenticationSuccessHandler的方法进行认证成功后的处理的。AuthenticationSuccessHandler就是登录成功处理器。
  2. 我们也可以自己去自定义成功处理器进行成功后的相应处理。
  1. @Component
  2. public class SGSuccessHandler implements AuthenticationSuccessHandler {
  3. @Override
  4. public void onAuthenticationSuccess(HttpServletRequest request, HttpServletResponse response, Authentication authentication) throws IOException, ServletException {
  5. System.out.println("认证成功了");
  6. }
  7. }
  1. @Configuration
  2. public class SecurityConfig extends WebSecurityConfigurerAdapter {
  3. @Autowired
  4. private AuthenticationSuccessHandler successHandler;
  5. @Override
  6. protected void configure(HttpSecurity http) throws Exception {
  7. http.formLogin().successHandler(successHandler);
  8. http.authorizeRequests().anyRequest().authenticated();
  9. }
  10. }

认证失败处理器

  1. 实际上在UsernamePasswordAuthenticationFilter进行登录认证的时候,如果认证失败了是会调用AuthenticationFailureHandler的方法进行认证失败后的处理的。AuthenticationFailureHandler就是登录失败处理器。
  2. 我们也可以自己去自定义失败处理器进行失败后的相应处理。
  1. @Component
  2. public class SGFailureHandler implements AuthenticationFailureHandler {
  3. @Override
  4. public void onAuthenticationFailure(HttpServletRequest request, HttpServletResponse response, AuthenticationException exception) throws IOException, ServletException {
  5. System.out.println("认证失败了");
  6. }
  7. }
  1. @Configuration
  2. public class SecurityConfig extends WebSecurityConfigurerAdapter {
  3. @Autowired
  4. private AuthenticationSuccessHandler successHandler;
  5. @Autowired
  6. private AuthenticationFailureHandler failureHandler;
  7. @Override
  8. protected void configure(HttpSecurity http) throws Exception {
  9. http.formLogin()
  10. // 配置认证成功处理器
  11. .successHandler(successHandler)
  12. // 配置认证失败处理器
  13. .failureHandler(failureHandler);
  14. http.authorizeRequests().anyRequest().authenticated();
  15. }
  16. }

登出成功处理器

  1. @Component
  2. public class SGLogoutSuccessHandler implements LogoutSuccessHandler {
  3. @Override
  4. public void onLogoutSuccess(HttpServletRequest request, HttpServletResponse response, Authentication authentication) throws IOException, ServletException {
  5. System.out.println("注销成功");
  6. }
  7. }
  1. @Configuration
  2. public class SecurityConfig extends WebSecurityConfigurerAdapter {
  3. @Autowired
  4. private AuthenticationSuccessHandler successHandler;
  5. @Autowired
  6. private AuthenticationFailureHandler failureHandler;
  7. @Autowired
  8. private LogoutSuccessHandler logoutSuccessHandler;
  9. @Override
  10. protected void configure(HttpSecurity http) throws Exception {
  11. http.formLogin()
  12. // 配置认证成功处理器
  13. .successHandler(successHandler)
  14. // 配置认证失败处理器
  15. .failureHandler(failureHandler);
  16. http.logout()
  17. //配置注销成功处理器
  18. .logoutSuccessHandler(logoutSuccessHandler);
  19. http.authorizeRequests().anyRequest().authenticated();
  20. }
  21. }

其他认证方案畅想

7. 源码讲解

  1. 投票过50更新源码讲解