Apache Shiro 角色和权限

本文转载自 《跟我学Shiro》

授权，也叫访问控制，即在应用中控制谁能访问哪些资源（如访问页面/编辑数据/页面操作等）。在授权中需了解的几个关键对象：主体（Subject）、资源（Resource）、权限（Permission）、角色（Role）。

主体

主体，即访问应用的用户，在Shiro中使用Subject代表该用户。用户只有授权后才允许访问相应的资源。

资源

在应用中用户可以访问的任何东西，比如访问JSP页面、查看/编辑某些数据、访问某个业务方法、打印文本等等都是资源。用户只要授权后才能访问。

权限

安全策略中的原子授权单位，通过权限我们可以表示在应用中用户有没有操作某个资源的权力。即权限表示在应用中用户能不能访问某个资源，如：

访问用户列表页面

查看/新增/修改/删除用户数据（即很多时候都是CRUD（增查改删）式权限控制）

打印文档等等。。。

 

如上可以看出，权限代表了用户有没有操作某个资源的权利，即反映在某个资源上的操作允不允许，不反映谁去执行这个操作。所以后续还需要把权限赋予给用户，即定义哪个用户允许在某个资源上做什么操作（权限），Shiro不会去做这件事情，而是由实现人员提供。

 

Shiro支持粗粒度权限（如用户模块的所有权限）和细粒度权限（操作某个用户的权限，即实例级别的），后续部分介绍。

角色

角色代表了操作集合，可以理解为权限的集合，一般情况下我们会赋予用户角色而不是权限，即这样用户可以拥有一组权限，赋予权限时比较方便。典型的如：项目经理、技术总监、CTO、开发工程师等都是角色，不同的角色拥有一组不同的权限。

隐式角色：即直接通过角色来验证用户有没有操作权限，如在应用中CTO、技术总监、开发工程师可以使用打印机，假设某天不允许开发工程师使用打印机，此时需要从应用中删除相应代码；再如在应用中CTO、技术总监可以查看用户、查看权限；突然有一天不允许技术总监查看用户、查看权限了，需要在相关代码中把技术总监角色从判断逻辑中删除掉；即粒度是以角色为单位进行访问控制的，粒度较粗；如果进行修改可能造成多处代码修改。

显示角色：在程序中通过权限控制谁能访问某个资源，角色聚合一组权限集合；这样假设哪个角色不能访问某个资源，只需要从角色代表的权限集合中移除即可；无须修改多处代码；即粒度是以资源/实例为单位的；粒度较细。

 

 

请google搜索“RBAC”和“RBAC新解”分别了解“基于角色的访问控制”“基于资源的访问控制(Resource-Based Access Control)”。

3.1 角色查询

Shiro支持三种方式的授权：

 

编程式：通过写if/else授权代码块完成： 

public void login(String iniPath,String username,String password){ //1、获取SecurityManager工厂，此处使用Ini配置文件初始化SecurityManager      Factory<org.apache.shiro.mgt.SecurityManager> factory =              new IniSecurityManagerFactory(iniPath);      //2、得到SecurityManager实例 并绑定给SecurityUtils      org.apache.shiro.mgt.SecurityManager securityManager = factory.getInstance();      SecurityUtils.setSecurityManager(securityManager);      //3、得到Subject及创建用户名/密码身份验证Token（即用户身份/凭证）      Subject subject = SecurityUtils.getSubject();     UsernamePasswordToken token = new UsernamePasswordToken(username, password);     try {          //4、登录，即身份验证          subject.login(token);      <span style="color:#ff0000;">  //5、角色，即角色查询        if(subject.hasRole("admin")) {              //有权限          System.out.println("当前用户拥有admin权限");        } else {              //无权限          System.out.println("当前用户没有admin权限");        }  </span>           } catch (AuthenticationException e) {          //5、身份验证失败      System.out.println("身份验证失败");    }finally{    //6、退出      subject.logout();         }   }public static void main(String[] args){Authorization authorization = new Authorization();authorization.login("classpath:shiro.ini","zhang","123456");}

注解式：通过在执行的Java方法上放置相应的注解完成： 

@RequiresRoles("admin")public void hello() {    //有权限} 

没有权限将抛出相应的异常；

SP/GSP标签：在JSP/GSP页面通过相应的标签完成： 

<shiro:hasRole name="admin"><!— 有权限 —></shiro:hasRole> 

3.2 角色授权

基于角色的访问控制（隐式角色）

 

1、在ini配置文件配置用户拥有的角色（shiro-role.ini） 

[users]zhang=123456

规则即：“用户名=密码,角色1，角色2”，如果需要在应用中判断用户是否有相应角色，就需要在相应的Realm中返回角色信息，也就是说Shiro不负责维护用户-角色信息，需要应用提供，Shiro只是提供相应的接口方便验证，后续会介绍如何动态的获取用户角色。

package com.shiro.authentication;import org.apache.shiro.SecurityUtils;import org.apache.shiro.authc.AuthenticationException;import org.apache.shiro.authc.UsernamePasswordToken;import org.apache.shiro.config.IniSecurityManagerFactory;import org.apache.shiro.subject.Subject;import org.apache.shiro.util.Factory;public class Authorization {/** *  * @param iniPath * @param username * @param password */public void annotation(String iniPath, String username, String password) {// 1、获取SecurityManager工厂，此处使用Ini配置文件初始化SecurityManagerFactory<org.apache.shiro.mgt.SecurityManager> factory = new IniSecurityManagerFactory(iniPath);// 2、得到SecurityManager实例 并绑定给SecurityUtilsorg.apache.shiro.mgt.SecurityManager securityManager = factory.getInstance();SecurityUtils.setSecurityManager(securityManager);// 3、得到Subject及创建用户名/密码身份验证Token（即用户身份/凭证）Subject subject = SecurityUtils.getSubject();UsernamePasswordToken token = new UsernamePasswordToken(username, password);try {// 4、登录，即身份验证subject.login(token);} catch (AuthenticationException e) {// 5、身份验证失败System.out.println("身份验证失败");}}/** * 返回当前Subject 对象 *  * @return */public static Subject getsubject() {return SecurityUtils.getSubject();}public static void main(String[] args) {Authorization authorization = new Authorization();authorization.annotation("classpath:shiro.ini", "zhang", "123456");//判断当前对象Subject 是否包含"role1"角色<span style="color:#ff0000;">boolean hasRole=getsubject().hasRole("role1");if(hasRole){System.out.println("当前用户Object,拥有role1角色");}else{System.out.println("当前用户Object,没有role1角色");}</span>}}

Shiro提供了hasRole/hasRole用于判断用户是否拥有某个角色/某些权限；但是没有提供如hashAnyRole用于判断是否有某些权限中的某一个。 

package com.shiro.authentication;import org.apache.shiro.SecurityUtils;import org.apache.shiro.authc.AuthenticationException;import org.apache.shiro.authc.UsernamePasswordToken;import org.apache.shiro.authz.UnauthorizedException;import org.apache.shiro.config.IniSecurityManagerFactory;import org.apache.shiro.subject.Subject;import org.apache.shiro.util.Factory;public class Authorization {/** *  * @param iniPath * @param username * @param password */public void annotation(String iniPath, String username, String password) {// 1、获取SecurityManager工厂，此处使用Ini配置文件初始化SecurityManagerFactory<org.apache.shiro.mgt.SecurityManager> factory = new IniSecurityManagerFactory(iniPath);// 2、得到SecurityManager实例 并绑定给SecurityUtilsorg.apache.shiro.mgt.SecurityManager securityManager = factory.getInstance();SecurityUtils.setSecurityManager(securityManager);// 3、得到Subject及创建用户名/密码身份验证Token（即用户身份/凭证）Subject subject = SecurityUtils.getSubject();UsernamePasswordToken token = new UsernamePasswordToken(username, password);try {// 4、登录，即身份验证subject.login(token);} catch (AuthenticationException e) {// 5、身份验证失败System.out.println("身份验证失败");}}/** * 返回当前Subject 对象 *  * @return */public static Subject getsubject() {return SecurityUtils.getSubject();}public static void main(String[] args) {Authorization authorization = new Authorization();authorization.annotation("classpath:shiro.ini", "zhang", "123456");//判断当前对象Subject 是否包含"role1"角色boolean hasRole=getsubject().hasRole("role1");if(hasRole){System.out.println("当前用户Object,拥有role1角色");}else{System.out.println("当前用户Object,没有role1角色");}//检查当前对象Subject 是否包含"role1"角色[提示：当当前用户Subject，不包含"role1"角色，会提示UnauthorizedException异常]<span style="color:#ff0000;">try{getsubject().checkRole("role1");}catch(UnauthorizedException e){System.out.println("异常抛出："+e.getMessage());}</span>}}

Shiro提供的checkRole/checkRoles和hasRole/hasAllRoles不同的地方是它在判断为假的情况下会抛出UnauthorizedException异常。

 

到此基于角色的访问控制（即隐式角色）就完成了，这种方式的缺点就是如果很多地方进行了角色判断，但是有一天不需要了那么就需要修改相应代码把所有相关的地方进行删除；这就是粗粒度造成的问题。

基于资源的访问控制（显示角色）

1、在ini配置文件配置用户拥有的角色及角色-权限关系（shiro-permission.ini） 

[users]zhang=123,role1[roles]role1=user:create,user:update

规则：“用户名=密码，角色1，角色2”“角色=权限1，权限2”，即首先根据用户名找到角色，然后根据角色再找到权限；即角色是权限集合；Shiro同样不进行权限的维护，需要我们通过Realm返回相应的权限信息。只需要维护“用户——角色”之间的关系即可

package com.shiro.authentication;import org.apache.shiro.SecurityUtils;import org.apache.shiro.authc.AuthenticationException;import org.apache.shiro.authc.UsernamePasswordToken;import org.apache.shiro.authz.UnauthorizedException;import org.apache.shiro.config.IniSecurityManagerFactory;import org.apache.shiro.subject.Subject;import org.apache.shiro.util.Factory;public class Authorization {/** *  * @param iniPath * @param username * @param password */public void annotation(String iniPath, String username, String password) {// 1、获取SecurityManager工厂，此处使用Ini配置文件初始化SecurityManagerFactory<org.apache.shiro.mgt.SecurityManager> factory = new IniSecurityManagerFactory(iniPath);// 2、得到SecurityManager实例 并绑定给SecurityUtilsorg.apache.shiro.mgt.SecurityManager securityManager = factory.getInstance();SecurityUtils.setSecurityManager(securityManager);// 3、得到Subject及创建用户名/密码身份验证Token（即用户身份/凭证）Subject subject = SecurityUtils.getSubject();UsernamePasswordToken token = new UsernamePasswordToken(username, password);try {// 4、登录，即身份验证subject.login(token);} catch (AuthenticationException e) {// 5、身份验证失败System.out.println("身份验证失败");}}/** * 返回当前Subject 对象 *  * @return */public static Subject getsubject() {return SecurityUtils.getSubject();}public static void main(String[] args) {Authorization authorization = new Authorization();authorization.annotation("classpath:shiro.ini", "zhang", "123456");////判断当前对象Subject 是否包含"role1"角色//boolean hasRole=getsubject().hasRole("role1");//if(hasRole){//System.out.println("当前用户Object,拥有role1角色");//}else{//System.out.println("当前用户Object,没有role1角色");//}//////检查当前对象Subject 是否包含"role1"角色[提示：当当前用户Subject，不包含"role1"角色，会提示UnauthorizedException异常]//try{//getsubject().checkRole("role1");//}catch(UnauthorizedException e){//System.out.println("异常抛出："+e.getMessage());//}//检查当前对象Subject 是否包含"role1"角色且该角色拥有"user.add"权限[提示：当前用户Subject，不包含"user.add"权限，会提示UnauthorizedException异常]try{getsubject().checkPermission("user.add");System.out.println("当前Subject 包含user.add权限");getsubject().checkPermission("user.delete");System.out.println("当前Subject 包含user.delete权限");}catch(UnauthorizedException e){System.out.println("异常抛出："+e.getMessage());}}}

Shiro提供了isPermitted和isPermittedAll用于判断用户是否拥有某个权限或所有权限，也没有提供如isPermittedAny用于判断拥有某一个权限的接口。

注意：但是失败的情况下会抛出UnauthorizedException异常。

到此基于资源的访问控制（显示角色）就完成了，也可以叫基于权限的访问控制，这种方式的一般规则是“资源标识符：操作”，即是资源级别的粒度；这种方式的好处就是如果要修改基本都是一个资源级别的修改，不会对其他模块代码产生影响，粒度小。但是实现起来可能稍微复杂点，需要维护“用户——角色，角色——权限（资源：操作）”之间的关系。  

3.3 Permission

字符串通配符权限

规则：“资源标识符：操作：对象实例ID”  即对哪个资源的哪个实例可以进行什么操作。其默认支持通配符权限字符串，“:”表示资源/操作/实例的分割；“,”表示操作的分割；“*”表示任意资源/操作/实例。

  

1、单个资源单个权限 

Java代码  

1. subject().checkPermissions("system:user:update");  

用户拥有资源“system:user”的“update”权限。

 

2、单个资源多个权限

ini配置文件 

Java代码  

1. role41=system:user:update,system:user:delete  

然后通过如下代码判断

Java代码  

1. subject().checkPermissions("system:user:update", "system:user:delete");  

用户拥有资源“system:user”的“update”和“delete”权限。如上可以简写成：

 

ini配置（表示角色4拥有system:user资源的update和delete权限）   

Java代码  

1. role42="system:user:update,delete"    

 接着可以通过如下代码判断 

Java代码  

1. subject().checkPermissions("system:user:update,delete");  

通过“system:user:update,delete”验证"system:user:update, system:user:delete"是没问题的，但是反过来是规则不成立。

 

3、单个资源全部权限

ini配置 

Java代码  

1. role51="system:user:create,update,delete,view"  

然后通过如下代码判断 

Java代码  

1. subject().checkPermissions("system:user:create,delete,update:view");  

用户拥有资源“system:user”的“create”、“update”、“delete”和“view”所有权限。如上可以简写成：

 

ini配置文件（表示角色5拥有system:user的所有权限）

Java代码  

1. role52=system:user:*  

也可以简写为（推荐上边的写法）：

Java代码  

1. role53=system:user  

然后通过如下代码判断

Java代码  

1. subject().checkPermissions("system:user:*");  
2. subject().checkPermissions("system:user");   

通过“system:user:*”验证“system:user:create,delete,update:view”可以，但是反过来是不成立的。

 

4、所有资源全部权限

ini配置 

Java代码  

1. role61=*:view  

然后通过如下代码判断

Java代码  

1. subject().checkPermissions("user:view");  

用户拥有所有资源的“view”所有权限。假设判断的权限是“"system:user:view”，那么需要“role5=*:*:view”这样写才行。

 

5、实例级别的权限

5.1、单个实例单个权限

ini配置

Java代码  

1. role71=user:view:1  

对资源user的1实例拥有view权限。

然后通过如下代码判断 

Java代码  

1. subject().checkPermissions("user:view:1");  

 

5.2、单个实例多个权限

ini配置           

Java代码  

1. role72="user:update,delete:1"  

对资源user的1实例拥有update、delete权限。

然后通过如下代码判断

Java代码  

1. subject().checkPermissions("user:delete,update:1");  
2. subject().checkPermissions("user:update:1", "user:delete:1");   

  

5.3、单个实例所有权限

ini配置  

Java代码  

1. role73=user:*:1  

对资源user的1实例拥有所有权限。

然后通过如下代码判断 

Java代码  

1. subject().checkPermissions("user:update:1", "user:delete:1", "user:view:1");  

   

5.4、所有实例单个权限

ini配置 

Java代码  

1. role74=user:auth:*  

对资源user的1实例拥有所有权限。

然后通过如下代码判断 

Java代码  

1. subject().checkPermissions("user:auth:1", "user:auth:2");  

  

5.5、所有实例所有权限

ini配置 

Java代码  

1. role75=user:*:*  

对资源user的1实例拥有所有权限。

然后通过如下代码判断     

Java代码  

1. subject().checkPermissions("user:view:1", "user:auth:2");  

  

6、Shiro对权限字符串缺失部分的处理

如“user:view”等价于“user:view:*”；而“organization”等价于“organization:*”或者“organization:*:*”。可以这么理解，这种方式实现了前缀匹配。

另外如“user:*”可以匹配如“user:delete”、“user:delete”可以匹配如“user:delete:1”、“user:*:1”可以匹配如“user:view:1”、“user”可以匹配“user:view”或“user:view:1”等。即*可以匹配所有，不加*可以进行前缀匹配；但是如“*:view”不能匹配“system:user:view”，需要使用“*:*:view”，即后缀匹配必须指定前缀（多个冒号就需要多个*来匹配）。

 

7、WildcardPermission

如下两种方式是等价的：  

Java代码  

1. subject().checkPermission("menu:view:1");  
2. subject().checkPermission(new WildcardPermission("menu:view:1"));   

因此没什么必要的话使用字符串更方便。

 

8、性能问题

通配符匹配方式比字符串相等匹配来说是更复杂的，因此需要花费更长时间，但是一般系统的权限不会太多，且可以配合缓存来提供其性能，如果这样性能还达不到要求我们可以实现位操作算法实现性能更好的权限匹配。另外实例级别的权限验证如果数据量太大也不建议使用，可能造成查询权限及匹配变慢。可以考虑比如在sql查询时加上权限字符串之类的方式在查询时就完成了权限匹配。 

 

3.4 授权流程

流程如下：

1、首先调用Subject.isPermitted*/hasRole*接口，其会委托给SecurityManager，而SecurityManager接着会委托给Authorizer；

2、Authorizer是真正的授权者，如果我们调用如isPermitted(“user:view”)，其首先会通过PermissionResolver把字符串转换成相应的Permission实例；

3、在进行授权之前，其会调用相应的Realm获取Subject相应的角色/权限用于匹配传入的角色/权限；

4、Authorizer会判断Realm的角色/权限是否和传入的匹配，如果有多个Realm，会委托给ModularRealmAuthorizer进行循环判断，如果匹配如isPermitted*/hasRole*会返回true，否则返回false表示授权失败。

ModularRealmAuthorizer进行多Realm匹配流程：

1、首先检查相应的Realm是否实现了实现了Authorizer；

2、如果实现了Authorizer，那么接着调用其相应的isPermitted*/hasRole*接口进行匹配；

3、如果有一个Realm匹配那么将返回true，否则返回false。

 

如果Realm进行授权的话，应该继承AuthorizingRealm，其流程是：

1.1、如果调用hasRole*，则直接获取AuthorizationInfo.getRoles()与传入的角色比较即可；

1.2、首先如果调用如isPermitted(“user:view”)，首先通过PermissionResolver将权限字符串转换成相应的Permission实例，默认使用WildcardPermissionResolver，即转换为通配符的WildcardPermission；

2、通过AuthorizationInfo.getObjectPermissions()得到Permission实例集合；通过AuthorizationInfo. getStringPermissions()得到字符串集合并通过PermissionResolver解析为Permission实例；然后获取用户的角色，并通过RolePermissionResolver解析角色对应的权限集合（默认没有实现，可以自己提供）；

3、接着调用Permission. implies(Permission p)逐个与传入的权限比较，如果有匹配的则返回true，否则false。