مشاركة عبر

عنصر الأضافة لموفري للعضوية (مخطط إعدادات ASP.NET)

  • مقالة

إضافة مثيل موفر عضوية إلى مجموعة موفر العضوية.

يعتبر هذا العنصر جديدا في ‏‫NET Framework. الإصدار 2.0.

<configuration>العنصر
  النظام.ويب عنصر (مخطط إعدادات ASP.NET)
    عنصر العضوية (مخطط إعدادات ASP.NET)
      عنصر الموفرين من اجل العضويه (مخطط إعدادات ASP.NET)
        عنصر الأضافة لموفري للعضوية (مخطط إعدادات ASP.NET)

<!-- SqlMembershipProvider syntax -->
<add name="string" 
     type="string" 
     connectionStringName="string"
     applicationName="MyApplication"
     commandTimeout
     description
     enablePasswordRetrieval="false"
     enablePasswordReset="true"
     requiresQuestionAndAnswer="true"
     requiresUniqueEmail="false"
     passwordFormat="Hashed"
     maxInvalidPasswordAttempts="5"
     passwordAttemptWindow="10"
     minRequiredPasswordLength
     minRequiredNonalphanumericCharacters
     passwordStrengthRegularExpression
/>
<!-- ActiveDirectoryMembershipProvider syntax -->
<add 
    name="string" 
    type="string" 
    applicationName
    attributeMapUsername="string" 
    attrbuteMapEmail="string" 
    attributeMapPasswordQuestion="string" 
    attributeMapPasswordAnswer="string" 
    attributeMapFailedPasswordAnswerCount="number" 
    attributeMapFailedPasswordAnswerTime="interval" 
    attributeMapFailedPasswordAnswerLockoutTime="interval" 
    clientSearchTimeout="interval"   
    serverSearchTimeout
    connectionUsername="string" 
    connectionPassword="string" 
    connectionProtection="string" 
    connectionStringName="connection string identifier" 
    enablePasswordReset="true|false" 
    enablePasswordRetrieval="true|false" 
    enableSearchMethods="true|false" 
    requiresQuestionAndAnswer="true|false" 
    maxInvalidPasswordAttempts="number" 
    passwordAttemptWindow="number" 
    commandTimeout="number" 
    description="string" 
    passwordAnswerAttemptLockoutDuration="interval" 
    minRequiredPasswordLength
    minRequiredNonalphanumericCharacters
    passwordStregnthRegularExpression="string" 
    passwordAnswerAttemptLockoutDuration="number" 
    requiresUniqueEmail="true|false" 
/>

السمات والعناصر

تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.

السمات

السمة

الوصف

applicationName

سمة String اختيارية.

تعيّن اسم التطبيق الذي يتم تخزين بيانات عضوية في المصدر البيانات. اسم التطبيق على تمكين تطبيقات ASP.NET متعددة إلى استخدام نفس قاعدة بيانات بدون مواجهتها اسماء المستخدمين مكررة تطبيقات مختلفة. بدلاً من ذلك، يمكن استخدام عدة تطبيقات ASP.NET معلومات العضوية نفس بواسطة تحديد اسم التطبيق نفسه.

موفري العضوية المضمنة صواب .NET Framework استخدام ApplicationVirtualPath القيمة الخاصة ApplicationName الخاصية إذا لم applicationName تحديد سمة.

على الرغم من أنه يمكن أن يتم تعيين هذه السمة الموفر لموفر نشط Directory ، يتجاهل الموفر القيمة.

attributeMapUsername

ينطبق فقط على ActiveDirectoryMembershipProvider صواب.

سمة String اختيارية.

يستخدم في تعريف التعيين من UserName الخاصية على MembershipUser الكائن إلى UserName صواب ضمن الدليل.

الافتراضي هو userPrincipalName.

attributeMapEmail

ينطبق فقط على ActiveDirectoryMembershipProvider صواب.

سمة String اختيارية.

يستخدم في تعريف التعيين من Email الخاصية على MembershipUser الكائن إلى Email صواب ضمن الدليل.

الافتراضي هو "البريد".

attributeMapPasswordQuestion

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة String اختيارية.

يستخدم في تعريف التعيين من PasswordQuestion الخاصية على MembershipUser الكائن إلى صواب ضمن الدليل.

الافتراضي غير معرّف. وبالتالي، يجب أن المسؤول بتكوين هذه السمة في لها بوضوح ترتيب منك استخدام كلمة المرور السؤال والإجابة وظيفة.

attributeMapPasswordAnswer

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة String اختيارية.

يستخدم لتعريف التعيين من الإجابة كلمة المرور المستخدم على سمة ضمن الدليل.

الافتراضي غير معرّف. وبالتالي، يجب أن المسؤول بتكوين هذه السمة في لها بوضوح ترتيب منك استخدام كلمة المرور السؤال والإجابة وظيفة.

attributeMapFailedPasswordAnswerCount

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة Int32 اختيارية.

المستخدمة في تعريف السمة في الدليل الذي بتتبع محاولات الإجابات كلمة المرور الفاشلة.

الافتراضي غير معرّف. وبالتالي، يجب أن المسؤول بتكوين هذه السمة في لها بوضوح ترتيب منك استخدام كلمة المرور السؤال والإجابة وظيفة.

attributeMapFailedPasswordAnswerTime

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة Interval اختيارية.

يستخدم في تعريف التعيين من MembershipUser الخاصية على الكائن إلى صواب ضمن الدليل.

الافتراضي غير معرّف. وهكذا، إذا لا على المسؤول يعيّن السمة إلى خاصية فئة بوضوح ، فسيحاول الوظائف المقترنة بهذه الخاصية غير لتعيين أو الحصول على القيمة. في هذه الحالة، يتم تطبيق السلوك الافتراضي في الموفر.

attributeMapFailedPasswordAnswerLockoutTime

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة Interval اختيارية.

استخدام تعريف السمة في الدليل الذي يخزن عندما تم مؤمّن حساب المستخدم لوقوع كثيرة جداً إجابات كلمة مرور غير صالحة.

الافتراضي غير معرّف. وبالتالي، يجب أن المسؤول بتكوين هذه السمة في لها بوضوح ترتيب منك استخدام كلمة المرور السؤال والإجابة وظيفة.

clientSearchTimeout

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة Int32 اختيارية.

تسمح للمسؤولين بتعيين مهلة استعلام LDAP تشغيل جانب العميل. للحصول على معلومات حول كيفية العميل والخادم البحث المهلات العمل مع الاستعلام ترحيل الصفحات في الدليل راجع وثائق الموفر طرق البحث نشط Directory.

serverSearchTimeout

تسمح للمسؤولين بتعيين مهلة استعلام LDAP تشغيل جانب العميل. للحصول على معلومات حول كيفية العميل والخادم البحث المهلات العمل مع الاستعلام ترحيل الصفحات في الدليل راجع وثائق الموفر طرق البحث نشط Directory.

commandTimeout

ينطبق على موفر SQL فقط.

سمة Int32 اختيارية.

يحدد عدد الثواني قبل نهاية مهلة أمر صدر الي "مصدر بيانات العضوية". يتم استخدام موفر SQL هذه المهلة عند إنشاء SqlCommandالكائنات. ليست معينة هذه السمة افتراضياً في تكوين ASP.NET. ونتيجة لذلك، يتم استخدام الافتراضي ADO.NET 30 ثانية. إذا تم تعيين هذه السمة يستخدم موفر SQL القيمة المهلة المكونة مع الكل الأوامر SQL التي تم إصدارها إلى قاعدة بيانات.

الافتراضي هو 30(الافتراضي ADO.NET).

connectionStringName

سمة String مطلوبة.

تعيّن الاسم سلسلة الاتصال الذي يتم تعريفه في العنصر < connectionStrings >. سلسلة الاتصال المحددة بواسطة موفر أنه تتم تمت الإضافة.

connectionUsername

ينطبق على ActiveDirectoryMembershipProvider فقط سمة.

سمة String اختيارية.

يعرّف اسم المستخدم الذي قام المستخدم لأغراض المصادقة عند الاتصال إلى الدليل. إذا كان هذا صواب محدد، connectionPassword صواب يجب تحديد أيضاً.

استخدام بدلاً من بيانات عملية الحساب أو تطبيق الانتحال الاعتماد والتي ضمن حيّز تأثير عندما يتصل الموفر إلى الدليل.

connectionPassword

ينطبق على ActiveDirectoryMembershipProvider فقط سمة.

سمة String اختيارية.

يعرّف اسم المستخدم الذي قام المستخدم لأغراض المصادقة عند الاتصال إلى الدليل. إذا كان هذا صواب محدد، connectionUsername صواب يجب تحديد أيضاً.

استخدام بدلاً من بيانات عملية الحساب أو تطبيق الانتحال الاعتماد والتي ضمن حيّز تأثير عندما يتصل الموفر إلى الدليل.

connectionProtection

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة String اختيارية.

تعريف خيارات بروتوكول أمان طبقة النقل لاستخدامه عند فتح الاتصالات إلى الدليل. هذا صواب يمكن Secure أو None.

إذا كان Secure ، يحاول الموفر تلقائياً حدد المستوى الأعلى من الأمان الاتصال غير متوفرة استناداً إلى النوع صواب يتصل الموفر. يتم تحديد الحماية في الطريقة التالية وترتيب:

  1. SSL.

    لأن يعمل SSL صواب وضع كل من Active Directory و تطبيق الدليل Active Directory ( Ssl القيمة).

  2. إذا كان SSL غير متوفر ولا الاتصال الموفر إما نشط الدليل أو إلى مثيل بمجال الوضع نشط الدليل التطبيقات, يتم استخدام مانع يشفّر - Sign-و - تسرب (القيمة SignAndSeal).

  3. إذا لم يكن أي من SSL أو مانع تشفير - Sign-تسرب متوفراً، الموفر يطرح ProviderException ‏‏ استثناء مشيراً إلى أنه قد لا تلقائياً تحديد قناة إلى الدليل الذي تم تكوينه.

إذا كان None ، صريحة صواب مطلوبة. إذا كان connectionUsername و connectionPassword لا يتم توفير سمات ، ProviderException طرح استثناء توضح التي صواب لـ يتم اعتماد استخدام بيانات اعتماد العملية عند استخدام None الحماية الاتصال.

description

سمة String اختيارية.

تعيّن وصفاً مثيل موفر العضوية.

enablePasswordRetrieval

سمة Boolean اختيارية.

تحديد ما إذا كان يعتمد مثيل موفر العضوية استرداد كلمة المرور. إذا كان true ، تظهر صواب مثيل موفر يدعم استرداد كلمة المرور

الافتراضي هو false SQL و نشط صواب موفري.

لا يمكنك تعيين enablePasswordRetrieval صواب true في ملف التكوين ActiveDirectoryMembershipProvider. لا يسمح الموفر استرداد كلمات المرور.

enablePasswordReset

سمة Boolean اختيارية.

تحديد ما إذا كان يعتمد مثيل موفر العضوية استرداد كلمة المرور. إذا كان true ، تظهر صواب مثيل موفر يدعم استرداد كلمة المرور

الافتراضي هو true SQL و نشط صواب موفريfalse.

enableSearchMethods

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة Boolean اختيارية.

تحديد ما إذا كان صواب-مهيأ ActiveDirectoryMembershipProvider تتوفر أساليب. إذا كان true ، موجهة إلى البحث ActiveDirectoryMembershipProvider تتوفر أساليب.

يكون الإعداد الافتراضي هو false.

maxInvalidPasswordAttempts

سمة Int32 اختيارية.

تحدد رقم المسموح بها كلمة المرور أو محاولات الإجابات كلمة المرور غير صحيحة. عضوية مستخدم مؤمّناً عندما يكون عدد المحاولات غير صالح القيمة المكوّن.

يكون الإعداد الافتراضي هو 5. .

لاحظ أن الموفر لـ نشط الدليل ، تتحكم هذه السمة فقط عدد محاولات الإجابات كلمة المرور غير صحيحة. معالجة مشغل الدليل نفسه lockouts كلمة المرور.

minRequiredNonalphanumericCharacters

سمة Int32 اختيارية.

تعيّن الحد الأدنى لعدد الأحرف الخاصة التي يجب أن تكون موجودة في صالح كلمة المرور. هذا صواب لا يمكن تعيين قيمة أقل من 0 أكبر من 128 أو أكبر من القيمة minRequiredPasswordLength.

يكون الإعداد الافتراضي هو 1.

minRequiredPasswordLength

سمة Int32 اختيارية.

تعيّن الحد الأدنى لعدد الأحرف المطلوبة في كلمة المرور. لا يمكن تعيين هذه السمة على القيمة أقل من الصفر أو أكبر من ١٢٨, وهو الحد الأقصى لالطول unencoded كلمة المرور لموفر SQL.

يكون الإعداد الافتراضي هو 7.

name

سمة String مطلوبة.

تعيين اسم الموفر. هذه هي القيمة التي تستخدم defaultProvider سمة عنصر عضوية صواب تحديد مثيل موفر كـ موفر العضوية الافتراضي. nameكما يتم استخدام موفر إلى الموفر في الفهرس Providersمجموعة.

passwordAnswerAttemptLockoutDuration

يتم تطبيق هذا على ActiveDirectoryMembershipProvider فقط.

سمة Int32 اختيارية.

تحديد الطول الوقت بالدقائق التي حساب مستخدم مؤمّناً بعد توفير تالفة كثيرة جداً كلمة المرور إجابات.

القيمة الافتراضية هي 30 دقائق.

passwordAttemptWindow

سمة Int32 اختيارية.

رقم دقائق يتم تعقب المحاولات الفاشلة من خلالها. إعادة النافذة تعيين حدوث فشل آخر كل مرة. إذا كان الحد الأقصى رقم محاولات الإجابات كلمة المرور غير موجودة أو كلمة مرور صالحة حدوث صالح الاستخدام، المستخدم عضوية مؤمّناً.

يكون الإعداد الافتراضي هو 10.

passwordFormat

ينطبق على موفر SQL فقط.

سمة String اختيارية.

أحد MembershipPasswordFormat القيم التي تشير إلى التنسيق لتخزين كلمات المرور في صواب مخزن البيانات.

يكون الإعداد الافتراضي هو Hashed.

passwordStrengthRegularExpression

يتم تطبيق هذا على SqlMembershipProvider فقط.

سمة String اختيارية.

يحدد تعبير عادي المستخدمة في تقييم كلمة المرور. يجب أن تكون السمة هذا تعبير عادي يعمل صواب Regex class.

الافتراضي عبارة عن سلسلة فارغة.

requiresQuestionAndAnswer

سمة Boolean اختيارية.

تحديد ما إذا كان يتطلب مثيل موفر العضوية كلمة المرور الإجابة عن كلمة المرور استرداد ثم يعيد تعيين المعاملة. إذا كان true ، تظهر صواب موفر يتطلب إجابات كلمة مرور إعادة تعيين كلمة مرور استرداد.

trueالافتراضي هو false SQL و نشط صواب موفري.

requiresUniqueEmail

سمة Boolean اختيارية.

تحديد ما إذا كان عنوان البريد إلكتروني التي يتم تخزين تشغيل خادم يستخدم نشط الدليل يجب أن تكون فريدة. إذا كان true ، تظهر صواب يتطلب موفر المثيل على عنوان بريد إلكتروني فريد.

الافتراضي هو true SQL و نشط صواب موفريfalse.

type

سمة String مطلوبة.

تعيّن اسم نوع مخصص صواب موفر أن الذي يرث MembershipProvider class. قاعدة مجردة للحصول على مزيد من المعلومات حول العمل مع مخصص صواب موفر ، راجع تطبيق موفر العضوية.

العناصر التابعة

لا يوجد.

العناصر الأصلية

العنصر

الوصف

configuration

تحديد العنصر الجذر المطلوب في كل ملف تكوين مستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات .NET Framework.

system.web

تحدّد جذر العنصر لمقطع التكوين ASP.NET .

membership

تكوين تطبيق ASP.NET العضوية.

providers

تعريف مجموعة من موفري العضوية للعضوية ASP.NET.

ملاحظات

لمزيد من المعلومات حول تكوين موفر عضوية "Active Directory" راجع ActiveDirectoryMembershipProvider.

التكوين الافتراضي

لعنصر الافتراضي التالي add مكون في ملف Web.config الجذر في الإصدار2.0 من .NET Framework

  <providers>
    <add name="AspNetSqlMembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" connectionStringName="LocalSqlServer" enablePasswordRetrieval="false" enablePasswordReset="true" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="false" passwordFormat="Hashed" maxInvalidPasswordAttempts="5" minRequiredPasswordLength="7" minRequiredNonalphanumericCharacters="1" passwordAttemptWindow="10" passwordStrengthRegularExpression="" />
  </providers>

مثال

يلي تعليمات برمجية الأمثلة شرح كيفية تكوين أحد تطبيقات ASP.NET لتخزين معلومات المستخدم واستردادها. يظهر المثال الأول أحد تطبيقات ASP.NET التي تم تكوينها صواب استخدام SQLMembershipProvider.

<membership defaultProvider="SqlProvider"
            userIsOnlineTimeWindow="20">
    <providers>
        <add name="SqlProvider"
             type="System.Web.Security.SqlMembershipProvider"
             connectionStringName="SqlServices"
             enablePasswordRetrieval="false"
             enablePasswordReset="true"
             requiresQuestionAndAnswer="true"
             passwordFormat="Hashed"
             applicationName="/" />
    </providers>
</membership>

معلومات العنصر

معالج مقطع التكوين

System.Web.Configuration.MembershipSection

عضو التكوين

MembershipSection.Providers

مواقع للتكوين

Machine.config

مستوى جذر ويب.config

مستوى تطبيق ويب.config

المتطلبات

Microsoft Internet Information Services (IIS) الإصدار 5.0 أو 5.1 أو 6.0.

.NET Framework، الإصدار 2.0

Microsoft Visual Studio 2005

راجع أيضًا:

المهام

كيفية: تأمين إعدادات التكوين ASP.NET

المرجع

عنصر الموفرين من اجل العضويه (مخطط إعدادات ASP.NET)

النظام.ويب عنصر (مخطط إعدادات ASP.NET)

<configuration>العنصر

مسح عنصر للموفرين للعضوية (مخطط إعدادات ASP.NET)

عنصر المسح لموفري للعضوية (مخطط إعدادات ASP.NET)

ActiveDirectoryMembershipProvider

System.Configuration

System.Web.Configuration

المبادئ

نظرة عامة حول تكوين ASP.NET

عناصر تحكم ملقم ويب ASP.NET و قدرات المستعرض

تأمين تكوين ASP.NET

وحدات سيناريو التكوين ASP.NET

موارد أخرى

إدارة المستخدمين باستخدام عضوية

ملفات التكوين ASP.NET

إعدادات تكوين الـ ASP.NET

إعدادات التكوين العامة (ASP.NET)

تكوين ASP.NET API