Apache Shiro 使用手册(三) Shiro授权

如，判断一个用户有查看页面的权限，编辑数据的权限，拥有某一按钮的权限，以及是否拥有打印的权限等等。

一、授权的三要素

授权有着三个核心元素：权限、角色和用户。

权限

权限是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验证成功，那么将认为授权成功，立即返回，结束认证。