Forms身份认证

时间:2022-12-15 20:30:31
引言

大家都知道Http是无状态的协议,所以访问一个url,你并不能知道用户在之前是否已经登陆过。但是许多业务上的逻辑又离不开user的信息,这个时候就可以借助身份认证来记录当前user的登录状态。这其中Forms身份认证是最常见的身份认证。

这篇博客讲的内容就是结合一个最普通的MVC工程来讲解下Forms身份认证是怎么实现记录用户登录状态的。并说下怎么自定义一个身份认证。

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>
}

运行之后,你能看到:

Forms身份认证

继续修改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里加上对应的方法:

 [HttpPost]
public ActionResult Index(string id)
{
string userName = Request.Params["userName"];
FormsAuthentication.SetAuthCookie(userName, true);
return Index();
}

按F5运行之后,在输入框内填上user name,运行之后的结果:

Forms身份认证

注意上述的结果都是在web.config里开启Forms认证的基础上

<authentication mode="Forms">
</authentication>
内部运行机理

Forms身份认证的核心类是FormsAuthenticationModule

它是一个http module,实现了接口IHttpModule,这个接口的主要方法:

Init(HttpApplication Context)

看FomrsAuthenticationModule的实现

         public void Init(HttpApplication app)
{
if (!_fAuthChecked)
{
_fAuthRequired = AuthenticationConfig.Mode == AuthenticationMode.Forms;
_fAuthChecked = true;
}
if (_fAuthRequired)
{
FormsAuthentication.Initialize();
app.AuthenticateRequest += new EventHandler(this.OnEnter);
app.EndRequest += new EventHandler(this.OnLeave);
}
}

解释下代码,这个方法首先判断是否开启了Forms 认证,如果是Forms认证,就注册了两个HttpApplication管道事件AuthenticateRequest和EndRequest,继续看下

注册的AuthenticateRequest事件

 HttpApplication application = (HttpApplication)source;
HttpContext context = application.Context;
this.OnAuthenticate(new FormsAuthenticationEventArgs(context));

找到了最核心的方法OnAuthenticate

由于此方法比较长,笔者只摘录出最核心的几句话

FormsAuthenticationTicket tOld = ExtractTicketFromCookie(e.Context, FormsAuthentication.FormsCookieName, out cookielessTicket);
e.Context.SetPrincipalNoDemand(new GenericPrincipal(new FormsIdentity(ticket), new string[]));

可以看出最核心的方法是Forms module从http context中的Cookie中解析出FormsAuthenticationTicket对象,然后new出来FormsIdentity,最后传给HttpContext

module一般都是注册Application管道事件,在事件里实现自己的核心处理,比如MVC,也是Module,实现自己的UrlRoutingModule,注册ResolveRequestCache事件

拓展:Authorization

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事件

         protected void Application_AuthenticateRequest()
{
HttpContext context = HttpContext.Current;
if (!context.Request.RawUrl.Equals("/"))
{
HttpCookie cookie = context.Request.Cookies["CustomCookie"];
string[] strs = cookie.Value.Split('x');
bool rememberMe = Convert.ToInt32(strs[]) == ? true : false;
HttpContext.Current.User = new CustomPrincipal(new CustomIdentity(strs[], rememberMe));
}
}

标注:

context.Request.RawUrl.Equals("/") 此句是简单的将Index.cshtml作为登录页面,实际应用中当然需要修改下。

其中CustomPrincipal和CustomIdentity类的代码如下

     public class CustomPrincipal : IPrincipal
{
private IIdentity identity; public CustomPrincipal(IIdentity identity)
{
this.identity = identity;
} public IIdentity Identity
{
get { return identity; }
} public bool IsInRole(string role)
{
throw new NotImplementedException();
}
} public class CustomIdentity : IIdentity
{ private string name;
private bool rememberMe; public CustomIdentity(string name, bool rememberMe)
{
this.name = name;
this.rememberMe = rememberMe;
} public string AuthenticationType
{
get { return string.Empty; }
} public bool IsAuthenticated
{
get { return true; }
} public string Name
{
get { return name; }
}
}

Index.cshtml继续作为登录页面,对应的登录方法:

         [HttpPost]
public ActionResult Index(string id)
{
string userName = Request.Params["userName"];
HttpCookie cookie = new HttpCookie("CustomCookie");
cookie.Value = userName + "x" + .ToString();
cookie.Expires = DateTime.Now.AddHours();
System.Web.HttpContext.Current.Response.SetCookie(cookie);
return RedirectToAction("About");
}

About.cshtml作为判断是否登录的页面

 @if (Request.IsAuthenticated)
{
<text>用户已登录:</text>
@Context.User.Identity.Name
}
else
{
<text>用户未登录</text>
}

最后运行结果:

Forms身份认证

到此,整篇博客已结束,许多地方说的还是比较简单抽象,望理解。