论坛首页 Java企业应用论坛

Acegi ACL使用

浏览 8127 次
锁定老帖子 主题:Acegi ACL使用
精华帖 (0) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
作者 正文
   发表时间:2007-03-20  
本文假设你对Acegi其他部分已经比较熟悉。Acegi 的ACL控制是建立在对相应业务方法拦截的基础上的。这里以Acegi自带的contacts例子来说明。
先看看总的配置

xml 代码
 
  1. <bean id="contactManagerSecurity" class="org.acegisecurity.intercept.method.aopalliance.MethodSecurityInterceptor">  
  2.       <property name="authenticationManager"><ref bean="authenticationManager"/>property>  
  3.       <property name="accessDecisionManager"><ref local="businessAccessDecisionManager"/>property>  
  4.       <property name="afterInvocationManager"><ref local="afterInvocationManager"/>property>  
  5.       <property name="objectDefinitionSource">  
  6.          <value>  
  7.             sample.contact.ContactManager.getAll=AFTER_ACL_COLLECTION_READ  
  8.             sample.contact.ContactManager.getById=AFTER_ACL_READ  
  9.             sample.contact.ContactManager.delete=ACL_CONTACT_DELETE  
  10.             sample.contact.ContactManager.deletePermission=ACL_CONTACT_ADMIN  
  11.             sample.contact.ContactManager.addPermission=ACL_CONTACT_ADMIN  
  12.          <value>  
  13.       <property>  
  14.    bean>  

该 拦截器实现了org.aopalliance.intercept.MethodInterceptor接口。在方法被调用之前,拦截器会先调用 AuthenticationManager判断用户身份是否已验证,然后从objectDefinitionSource中获取方法所对应的权限,再调 用AccessDecisionManager来匹配用户权限和方法对应的权限。如果用户没有足够权限调用当前方法,则抛出 AccessDeniedException使方法不能被调用。方法调用后会调用AfterInvocationManager对返回的结果进行再次处 理。下面依次说明。
AccessDecisionManager的配置
xml 代码
 
  1. <bean id="businessAccessDecisionManager" class="org.acegisecurity.vote.AffirmativeBased">  
  2.       <property name="allowIfAllAbstainDecisions"><value>falsevalue>property>  
  3.       <property name="decisionVoters">  
  4.          <list>  
  5.             <ref local="roleVoter"/>  
  6.             <ref local="aclContactReadVoter"/>  
  7.             <ref local="aclContactDeleteVoter"/>  
  8.             <ref local="aclContactAdminVoter"/>  
  9.          list>  
  10.       property>  
  11.    bean>  

AccessDecisionManager 接口有decide()和support()方法。decide()方法决策是否批准通过即方法是否容许调用,如果没抛出 AccessDeniedException则为允许访问资源,否则拒绝访问。support()方法是根据配置属性和受保护资源的类来判断是否需要对该 资源作出决策判断。
AccessDecisionManager的 decisionVoters属性需要一个或多个Voter(投票者),Voter必须实现AccessDecisionVoter 接口。Voter的工作是去匹配用户已拥有的权限和受保护的资源要求的权限,在该资源有相应权限的情况下,如果匹配则投允许票,否则投反对票。
allowIfAllAbstainDecisions属性表示是否允许所有都弃权时就通过。Voter的实现类RoleVoter在当受保护资源的名字由ROLE_开始时才参与投票。
AccessDecisionManager有三个实现类,功能各不相同:
AffirmativeBased: 当至少有一个Voter投允许票时才通过
UnanimousBased: 没有Voter投反对票时才通过
ConsensusBased: 当所有Voter都投允许票时才通过
下面列出一个Voter的配置
xml 代码
 
  1. <bean id="aclContactDeleteVoter" class="org.acegisecurity.vote.BasicAclEntryVoter">  
  2.       <property name="processConfigAttribute"><value>ACL_CONTACT_DELETEvalue>property>  
  3.       <property name="processDomainObjectClass"><value>sample.contact.Contactvalue>property>  
  4.       <property name="aclManager"><ref local="aclManager"/>property>  
  5.       <property name="requirePermission">  
  6.         <list>  
  7.           <ref local="org.acegisecurity.acl.basic.SimpleAclEntry.ADMINISTRATION"/>  
  8.           <ref local="org.acegisecurity.acl.basic.SimpleAclEntry.DELETE"/>  
  9.         <list>  
  10.       <property>  
  11.    <bean>  

上面第一个配置里有这么一行:sample.contact.ContactManager.delete=ACL_CONTACT_DELETE
所 以在调用sample.contact.ContactManager.delete这个方法时aclContactDeleteVoter会参与投票, 它会获得sample.contact.Contact这个对象(这个对象从delete方法的参数中获得),然后通过aclManager去获得当前用 户对该Contact实例的ACL权限,最后拿这个权限与我们需要的权限比对,我们配置需要的权限是 org.acegisecurity.acl.basic.SimpleAclEntry.ADMINISTRATION和 org.acegisecurity.acl.basic.SimpleAclEntry.DELETE。如果我们通过aclManager获得的权限包 括这两个配置的权限之一,Voter就投容许票,方法容许调用。如果不包括,那对不起,反对票,AccessDecisionManager就会抛出 AccessDeniedException。方法拒绝调用。
AclManager的配置
xml 代码
 
  1. <bean id="aclManager" class="org.acegisecurity.acl.AclProviderManager">  
  2.       <property name="providers">  
  3.          <list>  
  4.             <ref local="basicAclProvider"/>  
  5.          <list>  
  6.       <property>  
  7.    <bean>  
  8.   
  9.    <bean id="basicAclProvider" class="org.acegisecurity.acl.basic.BasicAclProvider">  
  10.       <property name="basicAclDao"><ref local="basicAclExtendedDao"/><property>  
  11.    bean>  
  12.   
  13.    <bean id="basicAclExtendedDao" class="org.acegisecurity.acl.basic.jdbc.JdbcExtendedDaoImpl">  
  14.       <property name="dataSource"><ref bean="dataSource"/><property>  
  15.    <bean>  

AclManager是整个ACL中一个很核心的概念,它包含了两个方法AclEntry[] getAcls(Object domainInstance)和
AclEntry[] getAcls(Object domainInstance, Authentication authentication)。在了解这两个方法前,我们先了解AclEntry这个对象。AclEntry只是一个接口,系统中一般都是造型为 BasicAclEntry。它包括了这个Entry所保护的domainObject instance(这里是Contact),实际它实现上是以AclObjectIdentity来替代这个domainObject的 (domainClass+domainObjectId);它包括了谁(Recipient)拥有这个domainObject instance以及他所对这个domainObject instance的操作权限(mask)。
一个domainObject instance对应了多个AclEntry,比如一条通讯录张三可以查看,而李四可以管理,一个Contact instance就对应了两个AclEntry,第一个AclEntry包含信息:所保护的domainObject(Contact),谁(张三),权 限(查看);第二个AclEntry包含信息:所保护的domainObject(Contact),谁(李四),权限(管理)。
这样AclManager的两个方法就很好理解了getAcls(Object domainInstance)返回所有这个domainInstance所对应的权限信息,
getAcls(Object domainInstance, Authentication authentication)在第一个方法返回结果的基础上做了过滤,过滤出和authentication(当前用户)相关的权限信息。如果当前用户 是张三,则返回与张三对应的记录。

这样Acegi就会拦截业务方法发挥相应的作用,但是在业务方法返回一个List或是单个 domainObject instance的时候,同样也是需要把用户没有权限查看的domainObject instance过滤掉的,这时就要用afterInvocationManager了,看配置
xml 代码
 
  1. <bean id="afterInvocationManager" class="org.acegisecurity.afterinvocation.AfterInvocationProviderManager">  
  2.       <property name="providers">  
  3.          <list>  
  4.             <ref local="afterAclRead"/>  
  5.             <ref local="afterAclCollectionRead"/>  
  6.          </list>  
  7.       </property>  
  8.    </bean>  
  9.      
  10.    <!-- Processes AFTER_ACL_COLLECTION_READ configuration settings -->  
  11.    <bean id="afterAclCollectionRead" class="org.acegisecurity.afterinvocation.BasicAclEntryAfterInvocationCollectionFilteringProvider">  
  12.       <property name="aclManager"><ref local="aclManager"/></property>  
  13.       <property name="requirePermission">  
  14.         <list>  
  15.           <ref local="org.acegisecurity.acl.basic.SimpleAclEntry.ADMINISTRATION"/>  
  16.           <ref local="org.acegisecurity.acl.basic.SimpleAclEntry.READ"/>  
  17.         </list>  
  18.       </property>  
  19.    </bean>  
  20.      
  21.    <!-- Processes AFTER_ACL_READ configuration settings -->  
  22.    <bean id="afterAclRead" class="org.acegisecurity.afterinvocation.BasicAclEntryAfterInvocationProvider">  
  23.       <property name="aclManager"><ref local="aclManager"/></property>  
  24.       <property name="requirePermission">  
  25.         <list>  
  26.           <ref local="org.acegisecurity.acl.basic.SimpleAclEntry.ADMINISTRATION"/>  
  27.           <ref local="org.acegisecurity.acl.basic.SimpleAclEntry.READ"/>  
  28.         </list>  
  29.       </property>  
  30.    </bean>  

afterAclCollectionRead 会对配置AFTER_ACL_COLLECTION_READ的方法进行拦截,这里是 sample.contact.ContactManager.getAll方法,它会遍历方法返回的domainObject,然后挨个通过 aclManager判断当前用户对domainObject的权限,如果和需要的权限不和,则过滤掉。呵呵,传说中的虎牙子就在此时产生了!
afterAclRead则依次类推。
参考了ss wiki里相关的文档,特别是差沙和cac的文档,写的相当好。另外acegi的代码也是相当的易读。
   发表时间:2007-04-06  
写的这么好大家怎么都没反应啊,
想问 ronghao 一下,用acl数据库需要两张表 ,这两张表从何而来啊
0 请登录后投票
   发表时间:2007-04-07  
虎牙子是什么东西?
0 请登录后投票
   发表时间:2007-04-08  
差沙 写道
虎牙子是什么东西?

就是分页时会产生的问题,比如说第一页10条数据,你过滤完后只有3条,这样在界面上给人的感觉就是不整齐,与页面分页信息不合
0 请登录后投票
   发表时间:2007-04-08  
mazzystar 写道
写的这么好大家怎么都没反应啊,
想问 ronghao 一下,用acl数据库需要两张表 ,这两张表从何而来啊

需要自己去建,你也可以做自己的扩展
可以看看这个http://www.springside.org.cn/docs/reference/Acegi6.htm差沙的文档
0 请登录后投票
论坛首页 Java企业应用版

跳转论坛:
Global site tag (gtag.js) - Google Analytics