原文 http://kdboy.iteye.com/blog/1154652
http://jinnianshilongnian.iteye.com/blog/2020017
如,判断一个用户有查看页面的权限,编辑数据的权限,拥有某一按钮的权限,以及是否拥有打印的权限等等。
一、授权的三要素
授权有着三个核心元素:权限、角色和用户。
权限
权限是Apache Shiro安全机制最核心的元素。它在应用程序中明确声明了被允许的行为和表现。一个格式良好好的权限声明可以清晰表达出用户对该资源拥有的权限。
大多数的资源会支持典型的CRUD操作(create,read,update,delete),但是任何操作建立在特定的资源上才是有意义的。因此,权限声明的根本思想就是建立在资源以及操作上。
而我们通过权限声明仅仅能了解这个权限可以在应用程序中做些什么,而不能确定谁拥有此权限。
于是,我们就需要在应用程序中对用户和权限建立关联。
通常的做法就是将权限分配给某个角色,然后将这个角色关联一个或多个用户。
权限声明及粒度
Shiro权限声明通常是使用以冒号分隔的表达式。就像前文所讲,一个权限表达式可以清晰的指定资源类型,允许的操作,可访问的数据。同时,Shiro权限表达式支持简单的通配符,可以更加灵活的进行权限设置。
下面以实例来说明权限表达式。
可查询用户数据
User:view
可查询或编辑用户数据
User:view,edit
可对用户数据进行所有操作
User:* 或 user
可编辑id为123的用户数据
User:edit:123
角色
Shiro支持两种角色模式:
1、传统角色:一个角色代表着一系列的操作,当需要对某一操作进行授权验证时,只需判断是否是该角色即可。这种角色权限相对简单、模糊,不利于扩展。
2、权限角色:一个角色拥有一个权限的集合。授权验证时,需要判断当前角色是否拥有该权限。这种角色权限可以对该角色进行详细的权限描述,适合更复杂的权限设计。
下面将详细描述对两种角色模式的授权实现。
二、授权实现
Shiro支持三种方式实现授权过程:
-
编码实现
-
注解实现
-
JSP Taglig实现
1、基于编码的授权实现
1.1基于传统角色授权实现
当需要验证用户是否拥有某个角色时,可以调用Subject 实例的hasRole*方法验证。
-
Subject currentUser = SecurityUtils.getSubject();
-
if (currentUser.hasRole("administrator")) {
-
//show the admin button
-
} else {
-
//don't show the button? Grey it out?
-
}
相关验证方法如下:
Subject方法 | 描述 |
hasRole(String roleName) | 当用户拥有指定角色时,返回true |
hasRoles(List<String> roleNames) | 按照列表顺序返回相应的一个boolean值数组 |
hasAllRoles(Collection<String> roleNames) | 如果用户拥有所有指定角色时,返回true |
断言支持
Shiro还支持以断言的方式进行授权验证。断言成功,不返回任何值,程序继续执行;断言失败时,将抛出异常信息。使用断言,可以使我们的代码更加简洁。
-
Subject currentUser = SecurityUtils.getSubject();
-
//guarantee that the current user is a bank teller and
-
//therefore allowed to open the account:
-
currentUser.checkRole("bankTeller");
-
openBankAccount();
断言的相关方法:
Subject方法 | 描述 |
checkRole(String roleName) | 断言用户是否拥有指定角色 |
checkRoles(Collection<String> roleNames) | 断言用户是否拥有所有指定角色 |
checkRoles(String... roleNames) | 对上一方法的方法重载 |
1.2 基于权限角色授权实现
相比传统角色模式,基于权限的角色模式耦合性要更低些,它不会因角色的改变而对源代码进行修改,因此,基于权限的角色模式是更好的访问控制方式。
它的代码实现有以下几种实现方式:
1、基于权限对象的实现
创建org.apache.shiro.authz.Permission的实例,将该实例对象作为参数传递给Subject.isPermitted()进行验证。
-
Permission printPermission = new PrinterPermission("laserjet4400n", "print");
-
Subject currentUser = SecurityUtils.getSubject();
-
if (currentUser.isPermitted(printPermission)) {
-
//show the Print button
-
} else {
-
//don't show the button? Grey it out?
-
}
-
Permission printPermission = new PrinterPermission("laserjet4400n", "print");
-
Subject currentUser = SecurityUtils.getSubject();
-
if (currentUser.isPermitted(printPermission)) {
-
//show the Print button
-
} else {
-
//don't show the button? Grey it out?
-
}
相关方法如下:
Subject方法 | 描述 |
isPermitted(Permission p) | Subject拥有制定权限时,返回treu |
isPermitted(List<Permission> perms) | 返回对应权限的boolean数组 |
isPermittedAll(Collection<Permission> perms) | Subject拥有所有制定权限时,返回true |
2、 基于字符串的实现
相比笨重的基于对象的实现方式,基于字符串的实现便显得更加简洁。
-
Subject currentUser = SecurityUtils.getSubject();
-
if (currentUser.isPermitted("printer:print:laserjet4400n")) {
-
//show the Print button
-
} else {
-
//don't show the button? Grey it out?
-
}
使用冒号分隔的权限表达式是org.apache.shiro.authz.permission.WildcardPermission 默认支持的实现方式。
这里分别代表了 资源类型:操作:资源ID
类似基于对象的实现相关方法,基于字符串的实现相关方法:
isPermitted(String perm)、isPermitted(String... perms)、isPermittedAll(String... perms)
基于权限对象的断言实现
-
Subject currentUser = SecurityUtils.getSubject();
-
//guarantee that the current user is permitted
-
//to open a bank account:
-
Permission p = new AccountPermission("open");
-
currentUser.checkPermission(p);
-
openBankAccount();
基于字符串的断言实现
-
Subject currentUser = SecurityUtils.getSubject();
-
//guarantee that the current user is permitted
-
//to open a bank account:
-
currentUser.checkPermission("account:open");
-
openBankAccount();
断言实现的相关方法
Subject方法 | 说明 |
checkPermission(Permission p) | 断言用户是否拥有制定权限 |
checkPermission(String perm) | 断言用户是否拥有制定权限 |
checkPermissions(Collection<Permission> perms) | 断言用户是否拥有所有指定权限 |
checkPermissions(String... perms) | 断言用户是否拥有所有指定权限 |
2、基于注解的授权实现
Shiro注解支持AspectJ、Spring、Google-Guice等,可根据应用进行不同的配置。
相关的注解:
@ RequiresAuthentication
可以用户类/属性/方法,用于表明当前用户需是经过认证的用户。
-
@RequiresAuthentication
-
public void updateAccount(Account userAccount) {
-
//this method will only be invoked by a
-
//Subject that is guaranteed authenticated
-
...
-
}
@ RequiresGuest
表明该用户需为”guest”用户
@ RequiresPermissions
当前用户需拥有制定权限
-
@RequiresPermissions("account:create")
-
public void createAccount(Account account) {
-
//this method will only be invoked by a Subject
-
//that is permitted to create an account
-
...
-
}
@RequiresRoles
当前用户需拥有制定角色
@ RequiresUser
当前用户需为已认证用户或已记住用户
3、基于JSP TAG的授权实现
Shiro提供了一套JSP标签库来实现页面级的授权控制。
在使用Shiro标签库前,首先需要在JSP引入shiro标签:
-
<%@ taglib prefix="shiro" uri="http://shiro.apache.org/tags" %>
下面一一介绍Shiro的标签:
guest标签
验证当前用户是否为“访客”,即未认证(包含未记住)的用户
-
<shiro:guest>
-
Hi there! Please <a href="login.jsp">Login</a> or <a href="signup.jsp">Signup</a> today!
-
</shiro:guest>
user标签
认证通过或已记住的用户
-
<shiro:user>
-
Welcome back John! Not John? Click <a href="login.jsp">here<a> to login.
-
</shiro:user>
authenticated标签
已认证通过的用户。不包含已记住的用户,这是与user标签的区别所在。
-
<shiro:authenticated>
-
<a href="updateAccount.jsp">Update your contact information</a>.
-
</shiro:authenticated>
notAuthenticated标签
未认证通过用户,与authenticated标签相对应。与guest标签的区别是,该标签包含已记住用户。
-
<shiro:notAuthenticated>
-
Please <a href="login.jsp">login</a> in order to update your credit card information.
-
</shiro:notAuthenticated>
principal 标签
输出当前用户信息,通常为登录帐号信息
-
Hello, <shiro:principal/>, how are you today?
hasRole标签
验证当前用户是否属于该角色
-
<shiro:hasRole name="administrator">
-
<a href="admin.jsp">Administer the system</a>
-
</shiro:hasRole>
lacksRole标签
与hasRole标签逻辑相反,当用户不属于该角色时验证通过
-
<shiro:lacksRole name="administrator">
-
Sorry, you are not allowed to administer the system.
-
</shiro:lacksRole>
hasAnyRole标签
验证当前用户是否属于以下任意一个角色。
-
<shiro:hasAnyRoles name="developer, project manager, administrator">
-
You are either a developer, project manager, or administrator.
-
</shiro:lacksRole>
hasPermission标签
验证当前用户是否拥有制定权限
-
<shiro:hasPermission name="user:create">
-
<a href="createUser.jsp">Create a new User</a>
-
</shiro:hasPermission>
lacksPermission标签
与hasPermission标签逻辑相反,当前用户没有制定权限时,验证通过
-
<shiro:hasPermission name="user:create">
-
<a href="createUser.jsp">Create a new User</a>
-
</shiro:hasPermission>
三、Shiro授权的内部处理机制
1、在应用程序中调用授权验证方法(Subject的isPermitted*或hasRole*等)
2、Sbuject的实例通常是DelegatingSubject类(或子类)的实例对象,在认证开始时,会委托应用程序设置的securityManager实例调用相应的isPermitted*或hasRole*方法。
3、接下来SecurityManager会委托内置的Authorizer的实例(默认是ModularRealmAuthorizer 类的实例,类似认证实例,它同样支持一个或多个Realm实例认证)调用相应的授权方法。
4、每一个Realm将检查是否实现了相同的 Authorizer 接口。然后,将调用Reaml自己的相应的授权验证方法。
当使用多个Realm时,不同于认证策略处理方式,授权处理过程中:
1、当调用Realm出现异常时,将立即抛出异常,结束授权验证。
2、只要有一个Realm验证成功,那么将认为授权成功,立即返回,结束认证。
第二篇
授权,也叫访问控制,即在应用中控制谁能访问哪些资源(如访问页面/编辑数据/页面操作等)。在授权中需了解的几个关键对象:主体(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授权代码块完成:
-
Subject subject = SecurityUtils.getSubject();
-
if(subject.hasRole(“admin”)) {
-
//有权限
-
} else {
-
//无权限
-
}
注解式:通过在执行的Java方法上放置相应的注解完成:
-
@RequiresRoles("admin")
-
public void hello() {
-
//有权限
-
}
没有权限将抛出相应的异常;
JSP/GSP标签:在JSP/GSP页面通过相应的标签完成:
-
<shiro:hasRole name="admin">
-
<!— 有权限 —>
-
</shiro:hasRole>
后续部分将详细介绍如何使用。
3.2 授权
基于角色的访问控制(隐式角色)
1、在ini配置文件配置用户拥有的角色(shiro-role.ini)
-
[users]
-
zhang=123,role1,role2
-
wang=123,role1
规则即:“用户名=密码,角色1,角色2”,如果需要在应用中判断用户是否有相应角色,就需要在相应的Realm中返回角色信息,也就是说Shiro不负责维护用户-角色信息,需要应用提供,Shiro只是提供相应的接口方便验证,后续会介绍如何动态的获取用户角色。
2、测试用例(com.github.zhangkaitao.shiro.chapter3.RoleTest)
-
@Test
-
public void testHasRole() {
-
login("classpath:shiro-role.ini", "zhang", "123");
-
//判断拥有角色:role1
-
Assert.assertTrue(subject().hasRole("role1"));
-
//判断拥有角色:role1 and role2
-
Assert.assertTrue(subject().hasAllRoles(Arrays.asList("role1", "role2")));
-
//判断拥有角色:role1 and role2 and !role3
-
boolean[] result = subject().hasRoles(Arrays.asList("role1", "role2", "role3"));
-
Assert.assertEquals(true, result[0]);
-
Assert.assertEquals(true, result[1]);
-
Assert.assertEquals(false, result[2]);
-
}
Shiro提供了hasRole/hasRole用于判断用户是否拥有某个角色/某些权限;但是没有提供如hashAnyRole用于判断是否有某些权限中的某一个。
-
@Test(expected = UnauthorizedException.class)
-
public void testCheckRole() {
-
login("classpath:shiro-role.ini", "zhang", "123");
-
//断言拥有角色:role1
-
subject().checkRole("role1");
-
//断言拥有角色:role1 and role3 失败抛出异常
-
subject().checkRoles("role1", "role3");
-
}
Shiro提供的checkRole/checkRoles和hasRole/hasAllRoles不同的地方是它在判断为假的情况下会抛出UnauthorizedException异常。
到此基于角色的访问控制(即隐式角色)就完成了,这种方式的缺点就是如果很多地方进行了角色判断,但是有一天不需要了那么就需要修改相应代码把所有相关的地方进行删除;这就是粗粒度造成的问题。
基于资源的访问控制(显示角色)
1、在ini配置文件配置用户拥有的角色及角色-权限关系(shiro-permission.ini)
-
[users]
-
zhang=123,role1,role2
-
wang=123,role1
-
[roles]
-
role1=user:create,user:update
-
role2=user:create,user:delete
规则:“用户名=密码,角色1,角色2”“角色=权限1,权限2”,即首先根据用户名找到角色,然后根据角色再找到权限;即角色是权限集合;Shiro同样不进行权限的维护,需要我们通过Realm返回相应的权限信息。只需要维护“用户——角色”之间的关系即可。
2、测试用例(com.github.zhangkaitao.shiro.chapter3.PermissionTest)
-
@Test
-
public void testIsPermitted() {
-
login("classpath:shiro-permission.ini", "zhang", "123");
-
//判断拥有权限:user:create
-
Assert.assertTrue(subject().isPermitted("user:create"));
-
//判断拥有权限:user:update and user:delete
-
Assert.assertTrue(subject().isPermittedAll("user:update", "user:delete"));
-
//判断没有权限:user:view
-
Assert.assertFalse(subject().isPermitted("user:view"));
-
}
Shiro提供了isPermitted和isPermittedAll用于判断用户是否拥有某个权限或所有权限,也没有提供如isPermittedAny用于判断拥有某一个权限的接口。
-
@Test(expected = UnauthorizedException.class)
-
public void testCheckPermission () {
-
login("classpath:shiro-permission.ini", "zhang", "123");
-
//断言拥有权限:user:create
-
subject().checkPermission("user:create");
-
//断言拥有权限:user:delete and user:update
-
subject().checkPermissions("user:delete", "user:update");
-
//断言拥有权限:user:view 失败抛出异常
-
subject().checkPermissions("user:view");
-
}
但是失败的情况下会抛出UnauthorizedException异常。
到此基于资源的访问控制(显示角色)就完成了,也可以叫基于权限的访问控制,这种方式的一般规则是“资源标识符:操作”,即是资源级别的粒度;这种方式的好处就是如果要修改基本都是一个资源级别的修改,不会对其他模块代码产生影响,粒度小。但是实现起来可能稍微复杂点,需要维护“用户——角色,角色——权限(资源:操作)”之间的关系。
3.3 Permission
字符串通配符权限
规则:“资源标识符:操作:对象实例ID” 即对哪个资源的哪个实例可以进行什么操作。其默认支持通配符权限字符串,“:”表示资源/操作/实例的分割;“,”表示操作的分割;“*”表示任意资源/操作/实例。
1、单个资源单个权限
-
subject().checkPermissions("system:user:update");
用户拥有资源“system:user”的“update”权限。
2、单个资源多个权限
ini配置文件
-
role41=system:user:update,system:user:delete
然后通过如下代码判断
-
subject().checkPermissions("system:user:update", "system:user:delete");
用户拥有资源“system:user”的“update”和“delete”权限。如上可以简写成:
ini配置(表示角色4拥有system:user资源的update和delete权限)
-
role42="system:user:update,delete"
接着可以通过如下代码判断
-
subject().checkPermissions("system:user:update,delete");
通过“system:user:update,delete”验证"system:user:update, system:user:delete"是没问题的,但是反过来是规则不成立。
3、单个资源全部权限
ini配置
-
role51="system:user:create,update,delete,view"
然后通过如下代码判断
-
subject().checkPermissions("system:user:create,delete,update:view");
用户拥有资源“system:user”的“create”、“update”、“delete”和“view”所有权限。如上可以简写成:
ini配置文件(表示角色5拥有system:user的所有权限)
-
role52=system:user:*
也可以简写为(推荐上边的写法):
-
role53=system:user
然后通过如下代码判断
-
subject().checkPermissions("system:user:*");
-
subject().checkPermissions("system:user");
通过“system:user:*”验证“system:user:create,delete,update:view”可以,但是反过来是不成立的。
4、所有资源全部权限
ini配置
-
role61=*:view
然后通过如下代码判断
-
subject().checkPermissions("user:view");
用户拥有所有资源的“view”所有权限。假设判断的权限是“"system:user:view”,那么需要“role5=*:*:view”这样写才行。
5、实例级别的权限
5.1、单个实例单个权限
ini配置
-
role71=user:view:1
对资源user的1实例拥有view权限。
然后通过如下代码判断
-
subject().checkPermissions("user:view:1");
5.2、单个实例多个权限
ini配置
-
role72="user:update,delete:1"
对资源user的1实例拥有update、delete权限。
然后通过如下代码判断
-
subject().checkPermissions("user:delete,update:1");
-
subject().checkPermissions("user:update:1", "user:delete:1");
5.3、单个实例所有权限
ini配置
-
role73=user:*:1
对资源user的1实例拥有所有权限。
然后通过如下代码判断
-
subject().checkPermissions("user:update:1", "user:delete:1", "user:view:1");
5.4、所有实例单个权限
ini配置
-
role74=user:auth:*
对资源user的1实例拥有所有权限。
然后通过如下代码判断
-
subject().checkPermissions("user:auth:1", "user:auth:2");
5.5、所有实例所有权限
ini配置
-
role75=user:*:*
对资源user的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
如下两种方式是等价的:
-
subject().checkPermission("menu:view:1");
-
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。
3.5 Authorizer、PermissionResolver及RolePermissionResolver
Authorizer的职责是进行授权(访问控制),是Shiro API中授权核心的入口点,其提供了相应的角色/权限判断接口,具体请参考其Javadoc。SecurityManager继承了Authorizer接口,且提供了ModularRealmAuthorizer用于多Realm时的授权匹配。PermissionResolver用于解析权限字符串到Permission实例,而RolePermissionResolver用于根据角色解析相应的权限集合。
我们可以通过如下ini配置更改Authorizer实现:
-
authorizer=org.apache.shiro.authz.ModularRealmAuthorizer
-
securityManager.authorizer=$authorizer
对于ModularRealmAuthorizer,相应的AuthorizingSecurityManager会在初始化完成后自动将相应的realm设置进去,我们也可以通过调用其setRealms()方法进行设置。对于实现自己的authorizer可以参考ModularRealmAuthorizer实现即可,在此就不提供示例了。
设置ModularRealmAuthorizer的permissionResolver,其会自动设置到相应的Realm上(其实现了PermissionResolverAware接口),如:
-
permissionResolver=org.apache.shiro.authz.permission.WildcardPermissionResolver
-
authorizer.permissionResolver=$permissionResolver
设置ModularRealmAuthorizer的rolePermissionResolver,其会自动设置到相应的Realm上(其实现了RolePermissionResolverAware接口),如:
-
rolePermissionResolver=com.github.zhangkaitao.shiro.chapter3.permission.MyRolePermissionResolver
-
authorizer.rolePermissionResolver=$rolePermissionResolver
示例
1、ini配置(shiro-authorizer.ini)
-
[main]
-
#自定义authorizer
-
authorizer=org.apache.shiro.authz.ModularRealmAuthorizer
-
#自定义permissionResolver
-
#permissionResolver=org.apache.shiro.authz.permission.WildcardPermissionResolver
-
permissionResolver=com.github.zhangkaitao.shiro.chapter3.permission.BitAndWildPermissionResolver
-
authorizer.permissionResolver=$permissionResolver
-
#自定义rolePermissionResolver
-
rolePermissionResolver=com.github.zhangkaitao.shiro.chapter3.permission.MyRolePermissionResolver
-
authorizer.rolePermissionResolver=$rolePermissionResolver
-
-
securityManager.authorizer=$authorizer
-
#自定义realm 一定要放在securityManager.authorizer赋值之后(因为调用setRealms会将realms设置给authorizer,并给各个Realm设置permissionResolver和rolePermissionResolver)
-
realm=com.github.zhangkaitao.shiro.chapter3.realm.MyRealm
-
securityManager.realms=$realm
设置securityManager 的realms一定要放到最后,因为在调用SecurityManager.setRealms时会将realms设置给authorizer,并为各个Realm设置permissionResolver和rolePermissionResolver。另外,不能使用IniSecurityManagerFactory创建的IniRealm,因为其初始化顺序的问题可能造成后续的初始化Permission造成影响。
2、定义BitAndWildPermissionResolver及BitPermission
BitPermission用于实现位移方式的权限,如规则是:
权限字符串格式:+资源字符串+权限位+实例ID;以+开头中间通过+分割;权限:0 表示所有权限;1 新增(二进制:0001)、2 修改(二进制:0010)、4 删除(二进制:0100)、8 查看(二进制:1000);如 +user+10 表示对资源user拥有修改/查看权限。
-
public class BitPermission implements Permission {
-
private String resourceIdentify;
-
private int permissionBit;
-
private String instanceId;
-
public BitPermission(String permissionString) {
-
String[] array = permissionString.split("\\+");
-
if(array.length > 1) {
-
resourceIdentify = array[1];
-
}
-
if(StringUtils.isEmpty(resourceIdentify)) {
-
resourceIdentify = "*";
-
}
-
if(array.length > 2) {
-
permissionBit = Integer.valueOf(array[2]);
-
}
-
if(array.length > 3) {
-
instanceId = array[3];
-
}
-
if(StringUtils.isEmpty(instanceId)) {
-
instanceId = "*";
-
}
-
}
-
-
@Override
-
public boolean implies(Permission p) {
-
if(!(p instanceof BitPermission)) {
-
return false;
-
}
-
BitPermission other = (BitPermission) p;
-
if(!("*".equals(this.resourceIdentify) || this.resourceIdentify.equals(other.resourceIdentify))) {
-
return false;
-
}
-
if(!(this.permissionBit ==0 || (this.permissionBit & other.permissionBit) != 0)) {
-
return false;
-
}
-
if(!("*".equals(this.instanceId) || this.instanceId.equals(other.instanceId))) {
-
return false;
-
}
-
return true;
-
}
-
}
Permission接口提供了boolean implies(Permission p)方法用于判断权限匹配的;
-
public class BitAndWildPermissionResolver implements PermissionResolver {
-
@Override
-
public Permission resolvePermission(String permissionString) {
-
if(permissionString.startsWith("+")) {
-
return new BitPermission(permissionString);
-
}
-
return new WildcardPermission(permissionString);
-
}
-
}
BitAndWildPermissionResolver实现了PermissionResolver接口,并根据权限字符串是否以“+”开头来解析权限字符串为BitPermission或WildcardPermission。
3、定义MyRolePermissionResolver
RolePermissionResolver用于根据角色字符串来解析得到权限集合。
-
public class MyRolePermissionResolver implements RolePermissionResolver {
-
@Override
-
public Collection<Permission> resolvePermissionsInRole(String roleString) {
-
if("role1".equals(roleString)) {
-
return Arrays.asList((Permission)new WildcardPermission("menu:*"));
-
}
-
return null;
-
}
-
}
此处的实现很简单,如果用户拥有role1,那么就返回一个“menu:*”的权限。
4、自定义Realm
-
public class MyRealm extends AuthorizingRealm {
-
@Override
-
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {
-
SimpleAuthorizationInfo authorizationInfo = new SimpleAuthorizationInfo();
-
authorizationInfo.addRole("role1");
-
authorizationInfo.addRole("role2");
-
authorizationInfo.addObjectPermission(new BitPermission("+user1+10"));
-
authorizationInfo.addObjectPermission(new WildcardPermission("user1:*"));
-
authorizationInfo.addStringPermission("+user2+10");
-
authorizationInfo.addStringPermission("user2:*");
-
return authorizationInfo;
-
}
-
@Override
-
protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token) throws AuthenticationException {
-
//和com.github.zhangkaitao.shiro.chapter2.realm.MyRealm1. getAuthenticationInfo代码一样,省略
-
}
-
}
此时我们继承AuthorizingRealm而不是实现Realm接口;推荐使用AuthorizingRealm,因为:
AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token):表示获取身份验证信息;
AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals):表示根据用户身份获取授权信息。
这种方式的好处是当只需要身份验证时只需要获取身份验证信息而不需要获取授权信息。对于AuthenticationInfo和AuthorizationInfo请参考其Javadoc获取相关接口信息。
另外我们可以使用JdbcRealm,需要做的操作如下:
1、执行sql/ shiro-init-data.sql 插入相关的权限数据;
2、使用shiro-jdbc-authorizer.ini配置文件,需要设置jdbcRealm.permissionsLookupEnabled
为true来开启权限查询。
此次还要注意就是不能把我们自定义的如“+user1+10”配置到INI配置文件,即使有IniRealm完成,因为IniRealm在new完成后就会解析这些权限字符串,默认使用了WildcardPermissionResolver完成,即此处是一个设计权限,如果采用生命周期(如使用初始化方法)的方式进行加载就可以解决我们自定义permissionResolver的问题。
5、测试用例
-
public class AuthorizerTest extends BaseTest {
-
-
@Test
-
public void testIsPermitted() {
-
login("classpath:shiro-authorizer.ini", "zhang", "123");
-
//判断拥有权限:user:create
-
Assert.assertTrue(subject().isPermitted("user1:update"));
-
Assert.assertTrue(subject().isPermitted("user2:update"));
-
//通过二进制位的方式表示权限
-
Assert.assertTrue(subject().isPermitted("+user1+2"));//新增权限
-
Assert.assertTrue(subject().isPermitted("+user1+8"));//查看权限
-
Assert.assertTrue(subject().isPermitted("+user2+10"));//新增及查看
-
-
Assert.assertFalse(subject().isPermitted("+user1+4"));//没有删除权限
-
-
Assert.assertTrue(subject().isPermitted("menu:view"));//通过MyRolePermissionResolver解析得到的权限
-
}
-
}
通过如上步骤可以实现自定义权限验证了。另外因为不支持hasAnyRole/isPermittedAny这种方式的授权,可以参考我的一篇《简单shiro扩展实现NOT、AND、OR权限验证 》进行简单的扩展完成这个需求,在这篇文章中通过重写AuthorizingRealm里的验证逻辑实现的。