ASP.NET Web Pages WebSecurity 參考手冊

asp.net web pages - websecurity 對象

描述

websecurity 對象提供 asp.net web pages 應(yīng)用程序的安全性和認(rèn)證。

通過 websecurity 對象，您可以創(chuàng)建用戶帳戶，登錄和注銷用戶，重置或者更改密碼，以及其他更多與安全性相關(guān)的功能。

websecurity 對象參考手冊 - 屬性

屬性	描述
currentuserid	獲取當(dāng)前登錄用戶的 id。
currentusername	獲取當(dāng)前登錄用戶的名稱。
hasuserid	如果當(dāng)前有用戶 id，則返回 true。
isauthenticated	如果當(dāng)前用戶是登錄的，則返回 true。

websecurity 對象參考手冊 - 方法

方法	描述
changepassword()	為指定的用戶更改密碼。
confirmaccount()	使用帳戶確認(rèn)令牌確認(rèn)帳戶。
createaccount()	創(chuàng)建一個新的用戶帳戶。
createuserandaccount()	創(chuàng)建一個新的用戶帳戶。
generatepasswordresettoken()	生成一個密碼重置令牌，可以在電子郵件中發(fā)送給用戶以便用戶可以重設(shè)密碼。
getcreatedate()	獲取指定會員創(chuàng)建的時間。
getpasswordchangedate()	獲取密碼變更的日期和時間。
getuserid()	根據(jù)用戶名稱獲取用戶 id。
initializedatabaseconnection()	初始化 websecurity 系統(tǒng)（數(shù)據(jù)庫）。
isconfirmed()	檢查用戶是否已被確認(rèn)。如果已確認(rèn)，則返回 true。（例如，可通過電子郵件進(jìn)行確認(rèn)。）
iscurrentuser()	檢查當(dāng)前用戶的名稱是否與指定用戶名匹配。如果匹配，則返回 true。
login()	設(shè)置身份驗證令牌，登錄用戶。
logout()	移除身份驗證令牌，注銷用戶。
requireauthenticateduser()	如果用戶未通過身份驗證，則設(shè)置 http 狀態(tài)為 401（未經(jīng)授權(quán)）。
requireroles()	如果當(dāng)前用戶不是指定角色的成員，則設(shè)置 http 狀態(tài)為 401（未經(jīng)授權(quán)）。
requireuser()	如果當(dāng)前用戶不是指定用戶名的用戶，則設(shè)置 http 狀態(tài)為 401（未經(jīng)授權(quán)）。
resetpassword()	如果密碼重置令牌是有效的，改變用戶的密碼為新密碼。
userexists()	檢查指定的用戶是否存在。

技術(shù)數(shù)據(jù)

名稱	值
class	webmatrix.webdata.websecurity
namespace	webmatrix.webdata
assembly	webmatrix.webdata.dll

初始化 websecurity 數(shù)據(jù)庫

如果您想在您的代碼中使用 websecurity 對象，首先您必須創(chuàng)建或者初始化 websecurity 數(shù)據(jù)庫。

在您的 web 根目錄下，創(chuàng)建一個名為 _appstart.cshtml 的頁面（如果已存在，則直接編輯頁面）。

將下面的代碼復(fù)制到文件中：

_appstart.cshtml

@{
websecurity.initializedatabaseconnection("users", "userprofile", "userid", "email", true);
}

上面的代碼將在每次網(wǎng)站（應(yīng)用程序）啟動時運(yùn)行。它初始化了 websecurity 數(shù)據(jù)庫。

"users" 是 websecurity 數(shù)據(jù)庫（users.sdf）的名稱。

"userprofile" 是包含用戶配置信息的數(shù)據(jù)庫表的名稱。

"userid" 是包含用戶 id（主鍵）的列的名稱。

"email" 是包含用戶名的列的名稱。

最后一個參數(shù) true 是一個布爾值，表示如果用戶配置表和會員表不存在，則會自動創(chuàng)建表。如果不想自動創(chuàng)建表，應(yīng)設(shè)置參數(shù)為 false。

	雖然 true 表示自動創(chuàng)建數(shù)據(jù)庫表，但是數(shù)據(jù)庫不會被自動創(chuàng)建。所以數(shù)據(jù)庫必須存在。

websecurity 數(shù)據(jù)庫

userprofile 表為每個用戶創(chuàng)建保存一條記錄，用戶 id（主鍵）和用戶名字（email）：

userid	email
1	john@johnson.net
2	peter@peterson.com
3	lars@larson.eut

membership 表包含會員信息，比如用戶是什么時候創(chuàng)建的，該會員是否已認(rèn)證，會員是什么時候認(rèn)證的，等等。

具體如下所示（一些列不顯示）：

user id	create date	confirmation token	is confirmed	last password failure	password	password change
1	12.04.2012 16:12:17	null	true	null	afnqhwfy....	12.04.2012 16:12:17

注釋：如果您想看到所有的列和內(nèi)容，請打開數(shù)據(jù)庫，看看里邊的每個表。

簡單的會員配置

在您使用 websecurity 對象時，如果您的站點(diǎn)沒有配置使用 asp.net web pages 會員系統(tǒng) simplemembership，可能會報錯。

如果托管服務(wù)提供商的服務(wù)器的配置與您本地服務(wù)器的配置不同，也可能會報錯。為了解決這個問題，請在網(wǎng)站的 web.config 文件中添加以下元素：

相關(guān)文章

ASP實戰(zhàn)