第三章 授权（一）访问控制

一、简介

授权，也叫访问控制，即在应用中控制谁能访问哪些资源（如访问页面/编辑数据/页面操作），其中包括如下对象：

1. 主体

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

2. 资源

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

3. 权限

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

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

4. 角色

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

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

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

二、授权方式

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>

后续部分将详细介绍如何使用。

三、基于角色的访问控制（隐式角色）—— 主要判断有无这个角色

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

[users]
zhang=123,role1,role2
wang=123,role1

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

2. 测试用例

@Test
public void testHasRole(){
	login("classpath:shiro-role.ini","zhang","123");
	Subject subject = SecurityUtils.getSubject();
	//判断拥有角色: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/hasAllRoles/hasRoles 用于判断用户是否拥有某个角色/某些权限；但是没有提供如hashAnyRole用于判断是否有某些权限中的某一个。

@Test
public void testCheckRole(){
	login("classpath:shiro-role.ini","zhang","123");
	Subject subject = SecurityUtils.getSubject();
	//断言拥有角色：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. 测试用例

@Test
public void testIsPermitted(){
	login("classpath:shiro-permission.ini","zhang","123");
	Subject subject = SecurityUtils.getSubject();
	//判断拥有权限：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
public void testCheckPermission(){
	login("classpath:shiro-permission.ini","zhang","123");
	Subject subject = SecurityUtils.getSubject();
	//断言拥有权限：user:create
	subject.checkPermission("user:create");
	//断言拥有权限：user:delete and user:update
	subject.checkPermissions("user:delete","user:update");
	//断言拥有权限：user:view失败抛出异常
	subject.checkPermissions("user:view");
}

Shiro 提供的 checkPermission /checkPermissions 和 isPermitted/isPermittedAll 不同的地方是它在判断为假的情况下会抛出UnauthorizedException异常。

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