ASP.NET Web Pages WebSecurity 对象

本章我们将详细介绍 ASP.NET WebSecurity 对象

WebSecurity 对象 提供 ASP.NET Web Pages 应用程序的安全性和认证

通过 WebSecurity 对象，我们可以创建用户帐户，登录和注销用户，重置或者更改密码，以及其它更多与安全性相关的功能

WebSecurity 对象属性

方法	描述
ChangePassword()	为指定的用户更改密码
ConfirmAccount()	使用帐户确认令牌确认帐户
CreateAccount()	创建一个新的用户帐户
CreateUserAndAccount()	创建一个新的用户帐户
GeneratePasswordResetToken()	生成一个密码重置令牌，可以在电子邮件中发送给用户以便用户可以重设密码
GetCreateDate()	获取指定会员创建的时间
GetPasswordChangeDate()	获取密码变更的日期和时间
GetUserId()	根据用户名称获取用户 ID
InitializeDatabaseConnection()	初始化 WebSecurity 系统（数据库）
IsConfirmed()	检查用户是否已被确认。如果已确认，则返回 true。（例如，可通过电子邮件进行确认。）
IsCurrentUser()	检查当前用户的名称是否与指定用户名匹配。如果匹配，则返回 true
Login()	设置身份验证令牌，登录用户
Logout()	移除身份验证令牌，注销用户
RequireAuthenticatedUser()	如果用户未通过身份验证，则设置 HTTP 状态为 401（未经授权）
RequireRoles()	如果当前用户不是指定角色的成员，则设置 HTTP 状态为 401（未经授权）
RequireUser()	如果当前用户不是指定用户名的用户，则设置 HTTP 状态为 401（未经授权）
ResetPassword()	如果密码重置令牌是有效的，改变用户的密码为新密码
UserExists()	检查指定的用户是否存在

名称	值
Class	WebMatrix.WebData.WebSecurity
Namespace	WebMatrix.WebData
Assembly	WebMatrix.WebData.dll

在我们使用 WebSecurity 对象前，必须先创建或者初始化 WebSecurity 数据库

在我们的 Web 根目录下，创建一个名为 _AppStart.cshtml 的页面，如果已存在，则直接编辑页面

添加以下内容到文件中

@{
    WebSecurity.InitializeDatabaseConnection("Users", "UserProfile","UserId", "Email", true);
}

上面的代码会在每次网站（应用程序）启动时运行

这些代码用于初始化 WebSecurity 数据库

UserProfile 表为每个用户创建保存一条记录，用户 ID（主键）和用户名字（email）

Membership 表包含会员信息，比如用户是什么时候创建的，该会员是否已认证，会员是什么时候认证的等等

UserId	CreateDate	ConfirmationToken	PasswordChange
1	12.04.2012 16:12:17	NULL	AFNQhWfy....

忽略了一些列的显示

如果你想看到所有的列和内容，请打开数据库，看看里边的每个表

如果我们使用了 WebSecurity 对象，但有没有没有配置使用 ASP.NET Web Pages 会员系统 SimpleMembership ，可能会报错

如果托管服务提供商的服务器的配置与我们本地服务器的配置不同，也可能会报错

为了解决这个问题，请在网站的 Web.config 文件中添加以下元素

<appSettings>
    <add key="enableSimpleMembership" value="true" />
</appSettings>