Membership 三步曲
- ASP.NET 安全系列 Membership三步曲之入门篇
- ASP.NET 安全系列 Membership三步曲之进阶篇
- ASP.NET 安全系列 Membership三步曲之高级篇
Membership是ASP.NET为我们提供的一套验证和存储用户凭证的框架。它可以帮助我们快速的开发用户登录、管理以及权限验证相关的模块，很多人可能会说Membership开发起来确实很快，但是总是和需求有那么一点不匹配，那我们就要用到Membership的自定义扩展功能了，如果真正掌握了Membership的话，对于我们快速开发还是有很大帮助的，更重要的是Membership是一套可灵活扩展的框架，包括里面的Provider模型对于想学习架构的同学来说是一个不错的案例，那么接下来我们就来一步一步的看看Membership是如何做到的。
入门篇会从0开始将Membership集成到一个空的MVC站点中，并且与ASP.NET的权限管理体系相结合。进阶篇将剖析Membership的设计理念以及它的结构。高级篇我们将会扩展自己的MembershipProvider和RolesProvider，目地是直接利用我们老系统中已经存在的用户表和角色表，也就是用我们已经存在的数据库去集成Membership。
注意：使用VS2012建立一个Internet的MVC项目，会直接帮助我们生成一个已经集成好Membership的一个项目。但是我们会从头开始自己把Membership加入到一个空的项目中，这样更有利于我们理解它的工作原理 :)。
目录
Membership类成员介绍
一般来讲我们的网站要实现的与用户相关的最基本功能包括：注册，登录，修改用户资料和密码。Membership为我们提供了以下几个类来帮助我们完成这些功能。
在System.Web.Security的命名空间包含了上图中的8个类，但是实际上我们只需要Membership一个类就可以帮助我们完成大部份的功能。接下来我们就来一步一步的将Membership集成到我们的MVC站点中去。
集成Membership到ASP.NET MVC网站中
这里我们的需求很简单，只是要实现一个包含注册、登录、以及修改密码功能的网站就可以了。我们接下来要做的就是建立一个基本的MVC站点，然后再配置Membership，加上我们的功能代码。
2.1 新建一个基本的MVC站点
我们的站点默认已经启用Forms认证，如果不了解Foms的话，园子里面有一篇比较好的文章，我已经加上链接了。但是Forms有安全方面的隐患，这个系列的后面我们会对比各种认证方式，有兴趣的同学请继续关注。
同时，还为我们默认配置了一个MembershipProvider(我们下面会说这个东西，这里暂时忽略也没有关系）
2.2 添加功能代码
虽然说我们建立的这个项目已经配置好了Membership，但是并没有地方去使用它。我们没有Controller也没有View。所以接下来我们就要开始加入调用Membership的代码了。
首先我们在Layout里面加上三个链接：Register, Login, 如果已经登录的话我们就显示用户名和LogOff。
当然我们还得加上HomeController并且添加一个默认的Index Action。然后我们再加上AccountController并且添加4个Action（Login和Register的Get、Post版本），View的代码我就不贴了，大家可以到未尾下载整个项目的源码。
登录代码
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
public
ActionResult Login()
{ return
View();
}[HttpPost][AllowAnonymous][ValidateAntiForgeryToken]public
ActionResult Login(LoginModel model, string
returnUrl)
{ // Membership.ValidateUser 判断用户名和密码是否正确
if
(ModelState.IsValid && Membership.ValidateUser(model.UserName, model.Password))
{
// 调用Forms 的登录 User.Identity.IsAuthenticated 将设置为True
// User.Identity.Name 会设置成我们下面的UserName
FormsAuthentication.SetAuthCookie(model.UserName, false);
return
RedirectToLocal(returnUrl);
}
ModelState.AddModelError("", "The user name or password provided is incorrect.");
return
View(model);
} |
注册相关代码
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
public
ActionResult Register()
{ return
View();
}[HttpPost][AllowAnonymous][ValidateAntiForgeryToken]public
ActionResult Register(RegisterModel model)
{ if
(ModelState.IsValid)
{
try
{
// Membership.CreateUser去创建用户
var
user = Membership.CreateUser(model.UserName, model.Password);
if
(user != null)
{
//注册完成之后直接登录用户
FormsAuthentication.SetAuthCookie(user.UserName, false);
}
return
RedirectToAction("Index", "Home");
}
catch
(MembershipCreateUserException e)
{
ModelState.AddModelError("", ErrorCodeToString(e.StatusCode));
}
}
return
View(model);
} |
登出相关代码
|
1
2
3
4
5
6
7
|
[HttpPost][ValidateAntiForgeryToken]public
ActionResult LogOff()
{ FormsAuthentication.SignOut();
return
RedirectToAction("Index", "Home");
} |
修改密码相关代码
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
[HttpPost][ValidateAntiForgeryToken]public
ActionResult LogOff()
{ FormsAuthentication.SignOut();
return
RedirectToAction("Index", "Home");
}[Authorize]public
ActionResult Manage()
{ return
View();
}/**************************************************//*注意我们为Manage这两个Action加上了Authorize标签，只有登录过的用户才能访问 如果用户没有登录直接访问/Account/Manage会被跳到/Account/Login要求登录*/
[Authorize][HttpPost][ValidateAntiForgeryToken]public
ActionResult Manage(LocalPasswordModel model)
{ if
(ModelState.IsValid)
{
bool
changePasswordSucceeded;
try
{
var
user = Membership.GetUser(User.Identity.Name);
changePasswordSucceeded = user.ChangePassword(model.OldPassword,
model.NewPassword);
}
catch
(Exception)
{
changePasswordSucceeded = false;
}
if
(changePasswordSucceeded)
{
return
RedirectToAction("Manage", new
{ Message = "修改密码成功！"});
}
else
{
ModelState.AddModelError("", "老密码不正确或新密码不符合要求");
}
}
return
View(model);
} |
就是这么简单，我们的注册，登录，以及修改密码功能就完成了。
来看一下我们用到了哪些Membership的功能：
- Membership.ValidateUser 验证用户名和密码实现登录
- Membership.CreateUser 创建新用户
- Membership.GetUser 获取用户
- MembershipUser.ChangePassword 修改密码
还有更多的方法我们可以使用，在最上面的表中我们已经列出来了，大家可以自行尝试。这些功能都出来以后，我们还有一个疑问没有解答，那就是我们的用户保存到哪里去了？
Membership的配置节点中有一个connctionStringName的属性，可以指定我们的数据库连接字符串。那我们就来看一下它都帮我们搞了一个什么样的数据库。注：这个数据库是Membership帮我们生成的，我之前并没有创建它，也就是我们只需要写好连接字符串就可以了。
而我们的用户信息就保存在Users表和Memberships表中。
为Membership启用角色管理
我们已经完成了登录、注册和修改密码的功能。登录属性认证的范畴，而与认证如影随形的还是授权。通俗的讲，认证是看这个用户是不是合法的，像一扇门，你放不放穿上用户进来。而授权是在他进来之后能够干什么，他可以坐在椅子上，但绝对不能坐在你头上，又或者你只允许你爸或者你老婆坐在你头上，这就是授权了。
相信很多人都自己写过权限相关的代码，也有人会写出一套权限管理的框架来。其实ASP.NET已经有一套比较成熟的权限体系，加上它的自定义功能基本可以满足我们大多数的需求了。
在我们创建这个MVC站点的时候，VS也为我们配置了权限模块。就在挨着membership结点的下方：
因为我们这里面的连接字符串与我们的membersihp中用到的是同一个，所以和权限相关的表Roles、UserInRoles也创建到了同一个数据库中。不一样的是我们不需要写一行代码就可以完成角色管理的功能，包括创建/修改/删除角色，以及给用户赋予角色。
通过项目->ASP.NET 配置就可以打开这个小网站去管理我们的角色（抱歉，我用的英文版 - -! )。
我们可以点击Security（安全）到管理用户和角色的地页面。
我们先添加3个角色：Admin, Manager, User
然后我们就可以给我们的用户赋予角色了。
接下来我们就可以在代码中使用User.IsInRole方法是看用户是否具有某一个角色的权限了。在MVC的Action上我们可以直接在Authorize标签中指定某个角色，那么这个Action就只有这个角色下的用户才能够访问了。
|
1
2
3
4
5
|
[Authorize(Roles="Admin")]
public
ActionResult Manage()
{ return
View();
} |
我们还可以通过调用Roles.GetRolesForUser将这个用户相关的角色的都取出来。
现在我们就已经为我们的网站添加认证和授权模块了，分分搞定啊！功能是完成了，但是还留下了不少的问题需要解决，因为大多数情况下我们的User表都不会这么简单，要多加一些字段怎么办？ 我们使用了EF需要使用User entity怎么办？又或者角色是有父子关系的又该如何做呢？我们后面的进阶篇将会告诉你答案。
Demo下载：http://pan.baidu.com/s/1gduY5CR （你点或不点，推荐按钮就在右下角 ！）