وصف
يوفر كائن WebSecurity الأمن والتوثيق لتطبيقات ASP.NET صفحات ويب.
مع الكائن WebSecurity يمكنك إنشاء حسابات المستخدمين، والدخول والخروج للمستخدمين، إعادة تعيين أو تغيير كلمات السر، وأكثر من ذلك.
WebSecurity كائن المرجعي - العقارات
| الخصائص | وصف |
|---|---|
| CurrentUserId | يحصل على ID للمستخدم الحالي |
| CurrentUserName | يحصل على اسم المستخدم الحالي |
| HasUserId | عرض true إذا كان التيار لديه هوية المستخدم |
| IsAuthenticated | يعود صحيحا إذا تم تسجيل دخول المستخدم الحالي في |
WebSecurity كائن المرجعي - طرق
| طريقة | وصف |
|---|---|
| ChangePassword() | تغيير كلمة المرور للمستخدم |
| ConfirmAccount() | يؤكد حساب باستخدام رمز التأكيد |
| CreateAccount() | يخلق حساب مستخدم جديد |
| CreateUserAndAccount() | يخلق حساب مستخدم جديد |
| GeneratePasswordResetToken() | يولد عربون التي يمكن إرسالها إلى كمستخدم عن طريق البريد الإلكتروني |
| GetCreateDate() | يحصل على الوقت الذي تم إنشاؤه عضوية محددة |
| GetPasswordChangeDate() | يحصل التاريخ والوقت عندما تم تغيير كلمة السر |
| GetUserId() | يحصل على هوية المستخدم من اسم المستخدم |
| InitializeDatabaseConnection() | تهيئة نظام WebSecurity (database) |
| IsConfirmed() | الشيكات إذا تأكد المستخدم |
| IsCurrentUser() | الشيكات إذا كان المستخدم الحالي يطابق اسم المستخدم |
| Login() | خروج المستخدم من قبل في وضع رمز في ملف تعريف الارتباط |
| Logout() | خروج المستخدم من خلال إزالة الكعكة رمزية |
| RequireAuthenticatedUser() | يخرج من الصفحة إذا كان المستخدم غير مستخدم الموثق |
| RequireRoles() | يخرج من الصفحة إذا كان المستخدم ليس جزءا من أدوار محددة |
| RequireUser() | يخرج من الصفحة إذا كان المستخدم لا المستخدم المحدد |
| ResetPassword() | تغيير كلمة مرور المستخدم باستخدام رمز |
| UserExists() | الشيكات في حالة وجود مستخدم معين |
معلومات تقنية
| اسم | القيمة |
|---|---|
| صف دراسي | WebMatrix.WebData.WebSecurity |
| مساحة الاسم | WebMatrix.WebData |
| المجسم | WebMatrix.WebData.dll |
تهيئة قاعدة البيانات WebSecurity
يجب عليك إنشاء أو تهيئة قاعدة بيانات WebSecurity قبل أن تتمكن من استخدام الكائن WebSecurity في التعليمات البرمجية.
في جذر الويب الخاص بك، قم بإنشاء صفحة (or edit the page ) اسمه _AppStart.cshtml.
ضع التعليمات البرمجية التالية داخل الملف:
_AppStart.cshtml
@{
WebSecurity.InitializeDatabaseConnection("Users", "UserProfile",
"UserId", "Email", true);
}
رمز أعلاه سيتم تشغيل كل مرة موقع على شبكة الإنترنت (application) يبدأ. ومن تهيئة قاعدة البيانات WebSecurity.
"المستخدمون" هو اسم قاعدة البيانات WebSecurity (Users.sdf) .
"التشكيل الجانبي للمستخدم" هو اسم جدول قاعدة البيانات الذي يحتوي على معلومات ملف تعريف المستخدم.
"معرف المستخدم" هو اسم العمود الذي يحتوي على هوية المستخدم (primary key) .
"البريد الإلكتروني" هو اسم العمود الذي يحتوي على أسماء المستخدمين.
المعلمة الأخيرة الحقيقية هي قيمة منطقية تشير إلى أن ملف تعريف المستخدم والجداول عضوية ينبغي إنشاء تلقائيا إذا لم تكن موجودة، كاذبة خلاف ذلك.
وعلى الرغم من صحيح يدل على خلق التلقائي للجداول قاعدة البيانات، لن يتم إنشاء قاعدة البيانات نفسها تلقائيا. يجب أن يكون موجودا.
قاعدة بيانات WebSecurity
يحتوي الجدول التشكيل الجانبي للمستخدم سجل واحد لكل مستخدم، مع هوية المستخدم (primary key) واسم المستخدم (email) :
| معرف المستخدم | البريد الإلكتروني |
|---|---|
| 1 | [email protected] |
| 2 | [email protected] |
| 3 | [email protected] |
وسيتضمن الجدول العضوية معلومات العضوية حول متى تم إنشاء المستخدم وإذا (and when) تم تأكيد العضوية.
مثل الكثير من هذا (some columns are not shown) :
| المستعمل هوية شخصية | خلق تاريخ | التأكيد رمز | هو تم تأكيد | الاخير كلمه السر بالفشل | كلمه السر | كلمه السر يتغيرون |
|---|---|---|---|---|---|---|
| 1 | 12.04.2012 16:12:17 | لا شيء | صحيح | لا شيء | AFNQhWfy .... | 12.04.2012 16:12:17 |
ملاحظة: إذا كنت تريد أن ترى كافة الأعمدة وجميع المحتويات، فتح قاعدة البيانات مع WebMatrix والبحث داخل كل جدول.
تكوين عضوية بسيط
قد تحصل أخطاء استخدام الكائن WebSecurity، إذا لم يتم تكوين الموقع الخاص بك لاستخدام نظام العضوية صفحات ASP.NET الويب SimpleMembership.
يمكن أن يحدث هذا إذا تم تكوين ملقم مزود استضافة بشكل مختلف من الملقم المحلي الخاص بك. لحل هذه المشكلة، إضافة العنصر التالي إلى ملف Web.config الموقع:
<appSettings>
<add key="enableSimpleMembership" value="true" />
</appSettings>