大家都知道Http是無狀態的協議,所以訪問一個url,你並不能知道用戶在之前是否已經登陸過。但是許多業務上的邏輯又離不開user的信息,這個時候就可以藉助身份認證來記錄當前user的登錄狀態。這其中Forms身份認證是最常見的身份認證。
這篇博客講的內容就是結合一個最普通的MVC工程來講解下Forms身份認證是怎麼實現記錄用戶登錄狀態的。並說下怎麼自定義一個身份認證。
打開Visual Studio 2013,新建Asp.net web mvc application,選擇Internet Application
建好之後,按F5就能看到新建的網站。
修改Index,cshtml:
@if (Request.IsAuthenticated){ <text>用戶已登錄:</text> @Context.User.Identity.Name }else{ <text>用戶未登錄</text>}
運行之後,你能看到:
繼續修改Index.cshtml
@if (Request.IsAuthenticated){ <text>用戶已登錄:</text> @Context.User.Identity.Name }else{ <text>用戶未登錄</text> <form method="post" action="@Request.RawUrl"> <input type="text" name="userName" /> <input type="submit" value="Submit" /> </form>}
在對應的HomeController里加上對應的方法:
1[HttpPost]2public ActionResult Index(string id)3{4string userName = Request.Params["userName"];5 FormsAuthentication.SetAuthCookie(userName, true);6return Index();7 }
按F5運行之後,在輸入框內填上user name,運行之後的結果:
注意上述的結果都是在web.config裏開啓Forms認證的基礎上
<authentication mode="Forms"></authentication>
Forms身份認證的核心類是FormsAuthenticationModule
它是一個http module,實現了接口IHttpModule,這個接口的主要方法:
Init(HttpApplication Context)
看FomrsAuthenticationModule的實現
1publicvoid Init(HttpApplication app) 2 { 3if (!_fAuthChecked) 4 { 5 _fAuthRequired = AuthenticationConfig.Mode == AuthenticationMode.Forms; 6 _fAuthChecked = true; 7 } 8if (_fAuthRequired) 9 {10 FormsAuthentication.Initialize();11 app.AuthenticateRequest += new EventHandler(this.OnEnter);12 app.EndRequest += new EventHandler(this.OnLeave);13 }14 }
解釋下代碼,這個方法首先判斷是否開啓了Forms 認證,如果是Forms認證,就註冊了兩個HttpApplication管道事件AuthenticateRequest和EndRequest,繼續看下
註冊的AuthenticateRequest事件
1 HttpApplication application = (HttpApplication)source;2 HttpContext context = application.Context;3this.OnAuthenticate(new FormsAuthenticationEventArgs(context));
找到了最核心的方法OnAuthenticate
由於此方法比較長,筆者只摘錄出最核心的幾句話
FormsAuthenticationTicket tOld = ExtractTicketFromCookie(e.Context, FormsAuthentication.FormsCookieName, out cookielessTicket);e.Context.SetPrincipalNoDemand(new GenericPrincipal(new FormsIdentity(ticket), newstring[0]));
可以看出最核心的方法是Forms module從http context中的Cookie中解析出FormsAuthenticationTicket對象,然後new出來FormsIdentity,最後傳給HttpContext
module一般都是註冊Application管道事件,在事件裏實現自己的核心處理,比如MVC,也是Module,實現自己的UrlRoutingModule,註冊ResolveRequestCache事件
Authorization可以控制user對網站的訪問權限,比如哪種user可以訪問哪種資源
在上述的工程web.config里加上
<authentication mode="Forms"><forms loginUrl="~/Home/Index"/></authentication><authorization><deny users="?"/></authorization>
deny users="?"代表只有登錄用戶纔可以訪問網站
於此對應的還有allow users="*" 允許任何用戶可以訪問
此類功能是UrlAuthorizationModule 實現,在此不在贅述,實現方式和FormsAuthenticationModule方式大同小異。
在某些業務功能裏,需要cookie記住的功能不僅僅是user name,比如remember me功能,這個時候就可以用自定義身份認證來實現。
至於實現方式,既然已經知道Forms身份認證怎麼實現,完全可以比葫蘆畫瓢實現自己需要的認證
下面寫一個簡單的實例
首先仿照FormsAuthenticationModule,註冊AuthenticateRequest事件
1protectedvoid Application_AuthenticateRequest() 2 { 3 HttpContext context = HttpContext.Current; 4if (!context.Request.RawUrl.Equals("/")) 5 { 6 HttpCookie cookie = context.Request.Cookies["CustomCookie"]; 7string[] strs = cookie.Value.Split('x'); 8bool rememberMe = Convert.ToInt32(strs[1]) == 1 ? true : false; 9 HttpContext.Current.User = new CustomPrincipal(new CustomIdentity(strs[0], rememberMe));10 }11 }
標註:
context.Request.RawUrl.Equals("/") 此句是簡單的將Index.cshtml作爲登錄頁面,實際應用中當然需要修改下。
其中CustomPrincipal和CustomIdentity類的代碼如下
1publicclass CustomPrincipal : IPrincipal 2 { 3private IIdentity identity; 4 5public CustomPrincipal(IIdentity identity) 6 { 7this.identity = identity; 8 } 910public IIdentity Identity11 {12get { return identity; }13 }1415publicbool IsInRole(string role)16 {17thrownew NotImplementedException();18 }19 }2021publicclass CustomIdentity : IIdentity22 {2324privatestring name;25privatebool rememberMe;2627public CustomIdentity(string name, bool rememberMe)28 {29this.name = name;30this.rememberMe = rememberMe;31 }3233publicstring AuthenticationType34 {35get { returnstring.Empty; }36 }3738publicbool IsAuthenticated39 {40get { returntrue; }41 }4243publicstring Name44 {45get { return name; }46 }47 }
Index.cshtml繼續作爲登錄頁面,對應的登錄方法:
1 [HttpPost] 2public ActionResult Index(string id) 3 { 4string userName = Request.Params["userName"]; 5 HttpCookie cookie = new HttpCookie("CustomCookie"); 6 cookie.Value = userName + "x" + 1.ToString(); 7 cookie.Expires = DateTime.Now.AddHours(1); 8 System.Web.HttpContext.Current.Response.SetCookie(cookie); 9return RedirectToAction("About");10 }
About.cshtml作爲判斷是否登錄的頁面
1@if (Request.IsAuthenticated)2{3 <text>用戶已登錄:</text> 4 @Context.User.Identity.Name 5}6else7{8 <text>用戶未登錄</text> 9 }
最後運行結果:
到此,整篇博客已結束,許多地方說的還是比較簡單抽象,望理解。