EntLib实现ASP.NET页面的自动授权

　　ASP.NET默认采用UrlAuthorizationModule和FileAuthorizationModule分 别实现针对请求地址和物理文件的授权，但是在很多情况下我们需要额外的授权方式。Entlib提供了一种基于表达式的授权方式，它允许我们以一个表达式的 方式来定义授权的规则。在新的项目中我们希望利用EntLib的授权框架来实现针对ASP.NET页面的自动授权，本文描述的解决方案是我刚刚想到的，希 望广大网友朋友们帮助评估一下。[源代码从这里下载]

一、实例演示

　　我们先来作一个简单的实例演示。如下所示的EntLib安全模块的配置，如果读者对此不了解也没有关系，在这里我们只需要关注定义其中的一个授权规则（Authorization Rule）：“I:Foo OR R:Admin”。这是一个逻辑表达式，前缀I：和R：分别表示用户名（Identity）和角色（Role），整个表达式表示的授权逻辑是：“帐号为Foo的用户和所有具有Admin角色的用户”有权限方法与此表达式关联的操作或者资源。配置还定义了该授权规则的名称“FooOrAdmin”。

 <configuration>
   <configSections>
     <section name="securityConfiguration" 
              type="Microsoft.Practices.EnterpriseLibrary.Security.Configuration.SecuritySettings, 
                    Microsoft.Practices.EnterpriseLibrary.Security"/>
   </configSections>
   <securityConfiguration defaultAuthorizationInstance="Authorization Rule Provider">
     <authorizationProviders>
       <add name="Authorization Rule Provider"
            type="Microsoft.Practices.EnterpriseLibrary.Security.AuthorizationRuleProvider, 
                  Microsoft.Practices.EnterpriseLibrary.Security">
         <rules>
           <add expression="I:Foo OR R:Admin" name="FooOrAdmin" />
         </rules>
       </add>
     </authorizationProviders>
   </securityConfiguration>
 </configuration>

　　我们添加一个需要授权的Web页面（Default.aspx），并且使用上面定义的表达式来作为该页面的授权规则，我们通过自定义的 AuthorizeAttribute特性实现两者之间的关联（该特性构造函数中指定的字符串正是配置的授权规则名称）。除此之外，Web页面对应的类型 继承自我们自定义的基类PageBase。

 [Authorize("FooOrAdmin")]
 public partial class Default : PageBase
 {   
 }

　　我们随后添加一个登录页面，具体的实现就不再这里一一介绍了。为了模拟不同的登录用户具有不同的权限，我们通过注册HttpApplication 的AuthenticateRequest事件来对当前Principal进行定制。具体的定义如下所示：如果用户名为Bar，我们让当前的 Principal具有Admin角色，对于其他帐号的登录用户，角色列表为空。

 public class Global : System.Web.HttpApplication
 {
     protected void Application_AuthenticateRequest(object sender, EventArgs e)
     {
         if (null == HttpContext.Current.User || !HttpContext.Current.User.Identity.IsAuthenticated)
         {
             return;
         }
  
         IIdentity identity = new GenericIdentity(HttpContext.Current.User.Identity.Name);
         string[] roles = null;
         if (identity.Name.ToLower() == "bar")
         {
             roles = new string[] { "Admin" };
         }
         HttpContext.Current.User = new GenericPrincipal(identity, roles);
     }
 }

　　由于页面Default.aspx与配置名称为FooOrAdmin的授权规则进行了关联，根绝授权规则表达式定义和针对不同用户的角色列表，意味 着当我们以账户Foo和Bar登录后才能访问该页面，“自动化授权”可以通过下图得到证实：当前用户为Foo和Bar时，页面得以正常显示；而当我们以 Baz的身份登录后，显示“Access denied…”。

二、AuthorizationFilterAttribute

　　这里我吸取了ASP.NET MVC基于AuthorizationFilter的授权方式，不同的是AuthorizationFilter在ASP.NET MVC中以特性的方式应用到Controller类型和Action方法上，这里我们则将它应用到Web页面对应的类上。 AuthorizationFilterAttribute作为授权筛选器特性的基类定义如下，由于多个特性可以同时应用到同一个类型上，它们的执行顺序 通过属性Order来控制。具体的授权判断以及对非授权请求的处理定义在方法OnAuthorization方法上。

 [AttributeUsage( AttributeTargets.Class, AllowMultiple = true)]
 public abstract class AuthorizationFilterAttribute:Attribute
 {
     public int Order { get; set; }
     public abstract bool OnAuthorization(AuthorizationContext context);        
 }
  
 public class AuthorizationContext
 {
     public HttpContext  HttpContext { get; private set; }
     public bool         UnAuthorizedRequestHandled { get; set; }
  
     public AuthorizationContext(HttpContext httpContext)
     {
         this.HttpContext = httpContext;
     }
 }

　　OnAuthorization方法返回值代表的是真否授权的判断，它具有一个类型为AuthorizationContext参数。 AuthorizationContext是对HttpContext对象的封装，属性UnAuthorizedRequestHandled 表示是否完成了针对非授权请求的处理。如果多个AuthorizationFilterAttribute应用到同一个类型上，如果前面执行的 AuthorizationFilterAttribute将传入的AuthorizationContext的这个属性设置为True，后续的将不在执 行。

三、AuthorizeAttribute

　　基于EntLib的授权通过AuthorizeAttribute来实现。如下面的代码片断所示，AuthorizeAttribute 直接继承自AuthorizationFilterAttribute，代表授权规则配置名称的属性AuthorizationRule 在构造函数中被初始化。在实现的OnAuthorization我们按照Entlib授权框架的编程模式判断当前Principal是否具有针对指定授权 规则的权限，对于非授权请求我们直接调用HandleUnauthorizedRequest方法进行处理。具体的处理逻辑很简单：直接相应一段文字 “Access denied…”（正是上面截图中显示的文字）。出于可扩展的考虑，我们将此方法定义成受保护的虚方法。

 [AttributeUsage( AttributeTargets.Class, AllowMultiple = true)]
 public class AuthorizeAttribute : AuthorizationFilterAttribute
 {
     public string AuthorizationRule { get; private set; }
     public AuthorizeAttribute(string authorizationRule)
     {
         Guard.ArgumentNotNullOrEmpty(authorizationRule, "authorizationRule");
         this.AuthorizationRule = authorizationRule;
     }
  
     public override bool OnAuthorization(AuthorizationContext context)
     {
         IAuthorizationProvider authorizationProvider = AuthorizationFactory.GetAuthorizationProvider();
         if (authorizationProvider.Authorize(context.HttpContext.User, this.AuthorizationRule))
         {
             return true;
         }
         this.HandleUnauthorizedRequest(context);
         return false;
     }
  
     protected virtual void HandleUnauthorizedRequest(AuthorizationContext context)
     {
         context.HttpContext.Response.Write(context.HttpContext.User.Identity.Name + ": Access denied...");
     }
 }

四、PageBase

　　我们知道针对一个ASP.NET 资源的请求最后大都通过一个对应的HttpHandler来处理，这个授权解决方案的基本思路就是通过自定义HttpHandler实现自动化授权检验。 Page类型是我们最为熟悉的HttpHandler，为此我们定义了如下一个继承自它的类型PageBase。如下面的代码片断所示，在重写的 ProcessRequest方法中实现了对应用在当前类型上的AuthorizationFilterAttribute特性的解析和执行，进而提供了 对授权的实现。

 public abstract class PageBase: Page
 {
     public override void ProcessRequest(HttpContext context)
     {
         var filterAttributes = this.GetType().GetCustomAttributes(true)
                                 .OfType<AuthorizationFilterAttribute>()
                                 .OrderBy(attribute => attribute.Order);
         AuthorizationContext authorizationContext = new AuthorizationContext(context);
         bool isAuthorized = true;
         foreach (AuthorizationFilterAttribute attribute in filterAttributes)
         {
             isAuthorized = attribute.OnAuthorization(authorizationContext);
             if (authorizationContext.UnAuthorizedRequestHandled)
             {
                 break;
             }
         }
  
         if (isAuthorized)
         {
             base.ProcessRequest(context);
         }
     }    
 }