一.Shiro简介
- Apache Shiro 是 Java 的一个安全( 权限)框架。
- Shiro 可以非常容易的开发出足够好的应用,其不仅可以用在JavaSE 环境,也可以用在 JavaEE 环境。
- Shiro 可以完成:认证、授权、加密、会话管理、与Web 集成、 缓存等。
二.功能介绍
- Authentication: 身份认证/登录,验证用户是不是拥有相应的身份;
- Authorization: 授权,即权限验证,验证某个已认证的用户是否拥有某个权限;即判断用户是否能进行什么操作,如:验证某个用户是否拥有某个角色。或者细粒度的验证某个用户
对某个资源是否具有某个权限; - Session Manager: 会话管理,即用户登录后就是一次会话,在没有退出之前,它的所有信息都在会话中; 会话可以是普通 JavaSE 环境, 也可以是 Web 环境的;
- Cryptography: 加密,保护数据的安全性,如密码加密存储到数据库,而不是明文存储;
- Web Support: Web 支持,可以非常容易的集成到Web 环境;
- Caching: 缓存,比如用户登录后,其用户信息、拥有的角色/权限不必每次去查,这样可以提高效率;
- Concurrency: Shiro 支持多线程应用的并发验证,即如在一个线程中开启另一个线程,能把权限自动传播过去
- Testing:提供测试支持;
- Run As: 允许一个用户假装为另一个用户(如果他们允许) 的身份进行访问;
- Remember Me: 记住我,这个是非常常见的功能,即一次登录后,下次再来的话不用登录了
三.Shiro框架工作流程
- Subject: 应用代码直接交互的对象是 Subject,也就是说 Shiro 的对外API 核心就是 Subject。 Subject 代表了当前“用户” , 这个用户不一定是一个具体的人,与当前应用交互的任何东西都是 Subject,如网络爬虫,
机器人等; 与 Subject 的所有交互都会委托给 SecurityManager;Subject 其实是一个门面, SecurityManager 才是实际的执行者; - SecurityManager: 安全管理器;即所有与安全有关的操作都会与SecurityManager 交互;且其管理着所有 Subject;可以看出它是 Shiro的核心,它负责与 Shiro 的其他组件进行交互,它相当于 SpringMVC 中DispatcherServlet 的角色
- Realm: Shiro 从 Realm 获取安全数据(如用户、角色、权限), 就是说SecurityManager 要验证用户身份,那么它需要从 Realm 获取相应的用户进行比较以确定用户身份是否合法;也需要从 Realm 得到用户相应的角色/权限进行验证用户是否能进行操作;可以把 Realm 看成 DataSource
- SessionManager: 管理 Session 生命周期的组件;而 Shiro 并不仅仅可以用在 Web环境, 也可以用在如普通的 JavaSE 环境
- CacheManager: 缓存控制器,来管理如用户、角色、权限等的缓存的;因为这些数据基本上很少改变,放到缓存中后可以提高访问的性能
- Cryptography: 密码模块, Shiro 提高了一些常见的加密组件用于如密码加密/解密。
四.ShiroFilter
五.认证
1.认证基本流程
- 收集用户身份/凭证,即如用户名/密码
- 调用 Subject.login 进行登录,如果失败将得到相应的 AuthenticationException 异常, 根据异常提示用户错误信息;否则登录成功
- 创建自定义的 Realm 类,继承org.apache.shiro.realm.AuthorizingRealm 类,实现doGetAuthenticationInfo() 方法
2.认证具体流程
- 首先调用 Subject.login(token) 进行登录,其会自动委托给SecurityManager
- SecurityManager 负责真正的身份验证逻辑;它会委托给Authenticator 进行身份验证;
- Authenticator 才是真正的身份验证者, Shiro API 中核心的身份认证入口点,此处可以自定义插入自己的实现;
- Authenticator 可能会委托给相应的 AuthenticationStrategy 进行多 Realm 身份验证,默认 ModularRealmAuthenticator 会调用AuthenticationStrategy 进行多 Realm 身份验证;
- Authenticator 会把相应的 token 传入 Realm, 从 Realm 获取身份验证信息,如果没有返回/抛出异常表示身份验证失败了。此处可以配置多个Realm,将按照相应的顺序及策略进行访问
六.Realm
- 一般继承 AuthorizingRealm(授权)即可;其继承了AuthenticatingRealm(即身份验证),而且也间接继承了CachingRealm(带有缓存实现)。
- Realm 的继承关系:
- Authenticator 的职责是验证用户帐号,是 Shiro API 中身份验证核心的入口点:如果验证成功,将返回AuthenticationInfo 验证信息;此信息中包含了身份及凭证;如果验证失败将抛出相应的AuthenticationException 异常
- SecurityManager 接口继承了 Authenticator,另外还有一个ModularRealmAuthenticator实现,其委托给多个Realm 进行验证, 验证规则通过 AuthenticationStrategy 接口指定
七.授权
- 授权,也叫访问控制,即在应用中控制谁访问哪些资源(如访问页面/编辑数据/页面操作等)。在授权中需了解的几个关键对象:主体( Subject)、资源( Resource)、权限( Permission)、角色( Role)。
- 主体(Subject): 访问应用的用户, 在 Shiro 中使用 Subject 代表该用户。用户只有授权后才允许访问相应的资源。
- 资源(Resource): 在应用中用户可以访问的 URL, 比如访问 JSP 页面、查看/编辑某些数据、访问某个业务方法、打印文本等等都是资源。用户只要授权后才能访问。
- 权限(Permission): 安全策略中的原子授权单位,通过权限我们可以表示在应用中用户有没有操作某个资源的权力。即权限表示在应用中用户能不能访问某个资源,如:访问用户列表页面查看/新增/修改/删除用户数据(即很多时候都是CRUD(增查改删)式权限控制)等。权限代表了用户有没有操作某个资源的权利,即反映在某个资源上的操作允不允许。
- Shiro 支持粗粒度权限(如用户模块的所有权限)和细粒度权限(操作某个用户的权限,即实例级别的)
- 角色(Role): 权限的集合,一般情况下会赋予用户角色而不是权限,即这样用户可以拥有一组权限,赋予权限时比较方便。典型的如:项目经理、技术总监、 CTO、开发工程师等都是角色,不同的角色拥有一组不同的权限。
八.整合SpringBoot搭建开发环境
1.导入maven依赖
<!-- https://mvnrepository.com/artifact/org.apache.shiro/shiro-spring-boot-web-starter -->
<dependency>
<groupId>org.apache.shiro</groupId>
<artifactId>shiro-spring-boot-web-starter</artifactId>
<version>1.8.0</version>
</dependency>
2.自定义Realm数据源
Shiro默认读取Shiro.ini配置文件来获得认证授权数据, 实际开发中, 认证授权数据往往存在数据库, 所有需要自定义Realm来代替默认的读取配置文件
/**
* @author Dracarys
*/
public class CustomRealm extends AuthorizingRealm {
@Autowired
private UserService userService;
@Autowired
private UserResourceDao userResourceDao;
/**
* 授权
* @param principals 用户认证后存放的信息
*/
@Override
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {
//获取用户认证的信息
User user = (User) principals.getPrimaryPrincipal();
//根据用户信息从数据库获取相应的资源授权信息
List<String> codeList = userResourceDao.queryByuId(user.getId());
//实例化授权信息
SimpleAuthorizationInfo authorizationInfo = new SimpleAuthorizationInfo();
//将用户对应的资源授权信息传入授权信息对象
authorizationInfo.addStringPermissions(codeList);
return authorizationInfo;
}
/**
* 认证
* @param authenticationToken 用户输入的账户和密码信息认证令牌
*/
@Override
protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken authenticationToken)
throws AuthenticationException {
//获取用户需要认证的信息
UsernamePasswordToken token = (UsernamePasswordToken) authenticationToken;
//从数据库获取用户的信息
User user = userService.doLogin(token.getUsername());
if(user != null){
//认证
return new SimpleAuthenticationInfo(user,user.getPassword(),this.getName());
}
return null;
}
}
3.配置Shiro
shiro需要Subject对象来执行login认证操作, 获得Subject依赖于SecurityManager对象和Realm对象, 需要将相关对象实例化并存入IOC容器
/**
* @author Dracarys
*/
@Configuration
public class ShiroConfig {
/**
* 实例化自定义Realm, 并存入IOC容器
*/
@Bean
public CustomRealm customRealm(){
return new CustomRealm();
}
/**
* 实例化安全管理器,配置Realm环境
* @param customRealm 自定义Realm对象
*/
@Bean
public DefaultWebSecurityManager securityManager(CustomRealm customRealm){
DefaultWebSecurityManager securityManager = new DefaultWebSecurityManager();
securityManager.setRealm(customRealm);
return securityManager;
}
/**
* 实例化shiro过滤器
*/
@Bean
public ShiroFilterFactoryBean shiroFilterFactoryBean(SecurityManager securityManager){
ShiroFilterFactoryBean filterFactoryBean = new ShiroFilterFactoryBean();
filterFactoryBean.setSecurityManager(securityManager);
Map<String, String> map = filterFactoryBean.getFilterChainDefinitionMap();
//放行doLogin
map.put("/doLogin","anon"); //匿名拦截器, 无需登录即可访问
//拦截所有请求
map.put("/**","authc"); //需要登录才能访问
//用户为认证且访问需拦截的请求, 转到登录请求
filterFactoryBean.setLoginUrl("/login");
return filterFactoryBean;
}
}
4.登录认证
@GetMapping("doLogin")
public ResponseResult<Void> doLogin(String account,String password) {
UsernamePasswordToken token = new UsernamePasswordToken(account,password);
SecurityUtils.getSubject().login(token);
return new ResponseResult<>(200,"登录成功");
}
5.添加授权注解@RequiresPermissions
@GetMapping("list")
@RequiresPermissions("user:list")
public ResponseResult<Void> getList() {
return new ResponseResult<>(200,"查询用户列表");
}
6.自定义全局异常类, 捕获登录授权产生的异常
/**
* 全局异常处理器
*/
@RestControllerAdvice
public class GlobalException {
/**
* 账户不存在
*/
@ExceptionHandler(value = {UnknownAccountException.class})
public ResponseResult<Void> unknownAccountExceptionHandler(UnknownAccountException e) {
return new ResponseResult<>(421,"账户不存在");
}
/**
* 密码错误
*/
@ExceptionHandler(value = {IncorrectCredentialsException.class})
public ResponseResult<Void> incorrectCredentialsExceptionHandler(IncorrectCredentialsException e) {
return new ResponseResult<>(422,"密码错误");
}
/**
* 其它异常
*/
@ExceptionHandler(value = {Exception.class})
public ResponseResult<Void> exceptionHandler(Exception e) {
return new ResponseResult<>(500,"服务器出错啦");
}
/**
* 无权限
*/
@ExceptionHandler(UnauthorizedException.class)
public ResponseResult<Void> unauthorizedException(){
return new ResponseResult<>(403, "无此权限,请联系管理员");
}
}