Enterprise Library 2.0 -- Security Application Block

 今天来介绍一下Enterprise Library 2.0中的Security Application Block ，它可以帮助程序开发者在应用程序中实现与授权有关的大部分功能，不仅如此，它还支持缓存我们系统中用户的授权以及，授权数据。主要包括一下几个部分的功 能： 1、减少代码编写量； 2、保持应用程序中安全管理的一致性； 3、提供了应用程序中很多安全问题的实现方法； 4、可扩展，支持自定义Provider。 ...

       关于Security Application Block的介绍部分，我不再多说，具体可以参考帮助文档。下面我们来看一下如何配置Security Application Block,首先打开配置工具，新建一个Security Application Block,如下： 然后在Authorization节点下创建一个Authorization Rule Provider,名称为RuleProvider,如下： 现在就可以在RuleProvider节点下，创建一系列的规则(Rule)了。如下图： 新建了规则，我们还需要为这个规则定义一个表达式，用于在程序中判断是否满足该规则，如下图： 如图所示，我们定义了能通过该规则的用户的身份必须是User或Admin.我们可以根据我们的实际需要定义各种各样的规则。 最后我们可以为我们建立的Security Application Block分配一个默认的Authorization实例，如图： 此时，我们的配置文件中就多了如下内容：

<section name="securityConfiguration" type="Microsoft.Practices.EnterpriseLibrary.Security.Configuration.SecuritySettings, Microsoft.Practices.EnterpriseLibrary.Security, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null" /> <securityConfiguration defaultAuthorizationInstance="RuleProvider"     defaultSecurityCacheInstance="">     <authorizationProviders>       <add type="Microsoft.Practices.EnterpriseLibrary.Security.AuthorizationRuleProvider, Microsoft.Practices.EnterpriseLibrary.Security, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"         name="RuleProvider">         <rules>           <add expression="R:User OR R:Admin" name="Rule" />         </rules>       </add>     </authorizationProviders>   </securityConfiguration>

       关于Security Application Block的配置就说到这里。

      下面来看看Enterprise Library 2.0 的Security Application Block 与1.0版本中的一点区别，因为ASP.NET2.0中提供了角色与成员管理的新特性，所以在某些方面和1.0版本还是有一定的区别：     因为ASP.NET2.0提供了MemberShip,Roles两个类，其中包含了验证用户、角色管理以及对Profile信息的设置与读取功能，所以 Security Application Block 2.0将这些功能去掉了。因此和1.0版本的主要区别在于下面三方面： 首先导入下面两个命名空间: using System.Web.Profile; using System.Web.Security; 1、验证用户的方法如下：

        /**//**//**//// <summary>         /// 验证用户         /// http://pw.cnblogs.com         /// </summary>         /// <param name="username">用户名</param>         /// <param name="password">密码</param>         /// <returns></returns>         public bool CheckUser(string username, string password)         {             return Membership.ValidateUser(username, password);         }

2、读取或设置Profile信息

        /**//**//**//// <summary>         /// 使用 Profile         /// http://pw.cnblogs.com         /// </summary>         [TestMethod]         public void UseProfile()         {             IIdentity identity;             identity = new GenericIdentity("SHY520", Membership.Provider.Name);             //设置Profile             ProfileBase setuserProfile = ProfileBase.Create(identity.Name);             setuserProfile["Name"] = "SHY520";             setuserProfile["Address"] = "Wuhu China";             //保存Profile信息             setuserProfile.Save();             //读取Profile信息             ProfileBase readuserProfile = ProfileBase.Create(identity.Name);             string Name = readuserProfile["Name"].ToString();             string Address = readuserProfile["Address"].ToString();             Assert.AreEqual(Name,"SHY520");             Assert.AreEqual(Address,"Wuhu China");         }

3、得到某个用户所属角色列表

        /**//**//**//// <summary>         /// 得到某用户所属角色列表         /// http://pw.cnblogs.com         /// </summary>         /// <returns>角色列表</returns>         public string[] GetUserRoles()         {             IIdentity identity = new GenericIdentity("SHY520", Membership.Provider.Name);             return Roles.GetRolesForUser(identity.Name);         }

      与上一个版本的区别基本上就是以上几点，下面我们来看看Security Application Block2.0的基本使用方法：

1、为已授权的用户分配一个Token(记号):        Security Application Block将授权用户的身份信息放进缓存，并返回一个Token,所以我们在使用此方之前需要先配置一个Security Cache，具体方法我就不多说了，可以参考官方教程，下面贴出配置后的App.Config中的代码：

<securityCacheProviders>       <add cacheManagerInstanceName="Cache Manager" defaultSlidingSessionExpirationInMinutes="10"         defaultAbsoluteSessionExpirationInMinutes="60" type="Microsoft.Practices.EnterpriseLibrary.Security.Cache.CachingStore.CachingStoreProvider, Microsoft.Practices.EnterpriseLibrary.Security.Cache.CachingStore, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"         name="Caching Store Provider" /> </securityCacheProviders>

这段代码是在securityConfiguration节中的，其中cacheManagerInstanceName是我们在Caching Application Block中配置的实例。

        /**//**//**//// <summary>         /// 使用SaveIdentity方法，保存用户身份，并返回一个Token         /// http://pw.cnblogs.com         /// </summary>         /// <returns></returns>         public IToken SaveUserInfo()         {             ISecurityCacheProvider sc = SecurityCacheFactory.GetSecurityCacheProvider("Cache Manager");             //将用户身份装入缓存，并返回一个IToken类型的记号             return sc.SaveIdentity(new GenericIdentity("SHY520"));         }

2、使用Token来验证用户是否已被授权

        /**//**//**//// <summary>         /// 根据Token来判断用户是否已被授权         /// http://pw.cnblogs.com         /// </summary>         /// <param name="token"></param>         /// <returns></returns>         public bool CheckUserByToken(IToken token)         {             ISecurityCacheProvider sc = SecurityCacheFactory.GetSecurityCacheProvider("Cache Manager");             //得到Token对应的身份IIdentity             IIdentity savedIdentity = sc.GetIdentity(token);             //返回该身份是否已被授权             return savedIdentity.IsAuthenticated;                      }   

3、结束User Session(即使Token过期)

        /**//**//**//// <summary>         /// 使用户Token过期         /// http://pw.cnblogs.com         /// </summary>         public void CloseUserSession()         {             ISecurityCacheProvider sc = SecurityCacheFactory.GetSecurityCacheProvider("Cache Manager");             //保存身份             IToken token = sc.SaveIdentity(new GenericIdentity("SHY520"));             //使身份过期             sc.ExpireIdentity(token);         }

4、判断用户是否满足一定的规则       首先需要导入下面的命名空间：  using System.Security;  using System.Security.Principal;  using Microsoft.Practices.EnterpriseLibrary.Security;

    /**//**//**//// <summary>         /// 判断用户是否满足一定的规则         /// http://pw.cnblogs.com         /// </summary>         /// <param name="username">用户名称</param>         /// <param name="role">角色名称</param>         /// <param name="rule">规则名称</param>         /// <returns></returns>         public bool CheckUserRoleByRule(string username, string role, string rule)         {             IPrincipal principal = new GenericPrincipal(new GenericIdentity(username), new string[] { role });             //创建一个默认的Authorization实例             IAuthorizationProvider autoprovider = AuthorizationFactory.GetAuthorizationProvider();             //返回验证是否通过             return autoprovider.Authorize(principal, rule);         }

通过上面的方法可以很简单的实现对用户权限的鉴定，关于Security Application Block的简单应用就说到这里，下面我们来看一下如何实现自定义的authorization provider。 1、首先我们建立自己的Provider类，该类需继承AuthorizationProvider； 2、并且要加上[ConfigurationElementType(typeof(CustomAuthorizationProviderData))]的Attribute； 3、添加构造函数，参数为NameValueCollection类型； 4、覆盖基类中的Authorize方法，在其中添加自己的验证是否授权的逻辑 这样就完成了一个自定义的authorization provider。 完整的类定义如下：

using System; using System.Collections.Generic; using System.Text; using Microsoft.Practices.EnterpriseLibrary.Security; using System.Collections.Specialized; using System.Security.Principal; using Microsoft.Practices.EnterpriseLibrary.Common.Configuration; using Microsoft.Practices.EnterpriseLibrary.Security.Configuration; namespace Enterprise_Library_2 {     [ConfigurationElementType(typeof(CustomAuthorizationProviderData))]     public class CustomProvider : AuthorizationProvider     {         public CustomProvider(NameValueCollection configurationItems)         {                      }         public override bool Authorize(IPrincipal principal, string context)         {             //TODO：在此处添加自己需要的验证授权的逻辑既可             return true;         }     } }