ASP.NET Web Pages - WebSecurity オブジェクト
描述
WebSecurity オブジェクトASP.NET Web Pages アプリケーションのセキュリティと認証を提供します。
WebSecurity オブジェクトを使用して、ユーザーアカウントの作成、ユーザーのログインとログアウト、パスワードのリセットまたは変更、その他のセキュリティ関連機能を実行できます。
WebSecurity オブジェクトリファレンスマニュアル - プロパティ
| 属性 | 描述 |
|---|---|
| CurrentUserId | 現在ログインしているユーザーの ID を取得します。 |
| CurrentUserName | 現在ログインしているユーザーの名前を取得します。 |
| HasUserId | 現在ユーザー ID がある場合は、true を返します。 |
| IsAuthenticated | 現在のユーザーがログインしている場合は、true を返します。 |
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 オブジェクトを使用したい場合は、まず WebSecurity データベースを作成または初期化する必要があります。
Web ルートディレクトリの下に、次の名前のものを作成します。_AppStart.cshtmlのページ(既に存在する場合は、そのページを直接編集します)。
以下のコードをファイルにコピーします:
_AppStart.cshtml
WebSecurity.InitializeDatabaseConnection("Users", "UserProfile", "UserId", "Email", true);
}
上記のコードは、Web サイト(アプリケーション)が起動するたびに実行されます。これは WebSecurity データベースを初期化します。
"Users"WebSecurity データベース(Users.sdf)の名前です。
"UserProfile"ユーザープロファイル情報を含むデータベーステーブルの名前です。
"UserId"ユーザー ID(主キー)を含む列の名前です。
"Email"ユーザー名を含む列の名前です。
最後のパラメータtrueユーザープロファイルテーブルとメンバーシップテーブルが存在しない場合にテーブルを自動的に作成するかどうかを示すブール値です。テーブルを自動的に作成したくない場合は、パラメータを次のように設定してください。false。
| 虽然trueデータベースを自動的に作成することを示します表ただし、データベースは自動的に作成されません。そのため、データベースは存在している必要があります。 |
WebSecurity データベース
UserProfileテーブルは、各ユーザーについて 1 つのレコードを作成して保存します。ユーザー ID(主キー)とユーザー名(email):
| UserId | |
|---|---|
| 1 | john@johnson.net |
| 2 | peter@peterson.com |
| 3 | lars@larson.eut |
Membershipテーブルには、ユーザーがいつ作成されたか、メンバーが認証されているかどうか、メンバーがいつ認証されたかなどのメンバーシップ情報が含まれます。
具体的には次のようになります(一部の列は表示されません):
| 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 |
注:すべての列と内容を確認したい場合は、データベースを開いて、各テーブルの中を見てください。
シンプルなメンバーシップ設定
WebSecurity オブジェクトを使用する際に、サイトが ASP.NET Web Pages メンバーシップシステムを使用するように構成されていない場合SimpleMembership、エラーが発生する可能性があります。
ホスティングサービスプロバイダーのサーバーの構成がローカルサーバーの構成と異なる場合も、エラーが発生する可能性があります。この問題を解決するには、Web サイトの Web.config ファイルに次の要素を追加してください。
<add key="enableSimpleMembership" value="true" />
</appSettings>
其他扩展