عنصر anonymousIdentification (مخطط إعدادات ASP.NET)

مقالة
11/01/2010

تكوين تعريف مجهول للتخويل التطبيق. هذا مطلوب لتعريف الوحدات التي يتم مصادقتها عندما يكون التخويل مطلوباً.

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

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

<anonymousIdentification  
   enabled="[true | false]"
   cookieless="[UseUri | UseCookies | AutoDetect | UseDeviceProfile]"
   cookieName=""
   cookiePath=""
   cookieProtection="[None | Validation | Encryption | All]"
   cookieRequireSSL="[true | false]"
   cookieSlidingExpiration="[true | false]"
   cookieTimeout="[DD.HH:MM:SS]"
   domain="cookie domain"
/>

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

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

السمات

السمة	الوصف
cookieless	تحديد ما إذا سيتم استخدام ملفات تعريف الارتباط الخاصة بتطبيق ويب. HttpCookieModeاستخدام قائمة التعداد لتعيين القيمة لهذه السمة في مقطع تكوين. يتم استخدامه من قبل الكل الميزات التي تعتمد المصادقة الخالية من أي ملفات تعريف ارتباط. عند AutoDetectتحديد القيمة, يستعلم ASP.NET المستعرض أو الجهاز لتحديد ما إذا كان يعتمد ملفات تعريف الارتباط. إذا كان المستعرض أو الجهاز يدعم ملفات تعريف الارتباط، يتم استخدام ملفات تعريف الارتباط لاستمرار بيانات المستخدم; وإلا, يتم استخدام معرّف في سلسلة الاستعلام. ملاحظة عند تكوين أحد مواقع ويب ASP.NET التي تدعم AJAX استخدم القيمة الافتراضية فقط من UseCookiesللحصول cookielessالسمة.الإعدادات التي تستخدم ملفات تعريف الارتباط التي تم ترميزها في محدد موقع المعلومات (URL) غير معتمدة من قبل مكتبات النص البرمجي للكمبيوتر العميل AJAX ASP.NET. يمكن أن تكون هذه السمة إحدى القيم الممكنة التالية. Valueالوصف AutoDetect تحديد ASP.NET يحدد ما إذا كان المستعرض أو جهاز الطالب يدعم ملفات تعريف الارتباط.إذا كان المستعرض أو الجهاز الطالب يدعم ملفات تعريف الارتباط، AutoDetectيتم استخدام ملفات تعريف الارتباط لاستمرار بيانات المستخدم; وإلا, يتم استخدام معرّف في سلسلة الاستعلام.إذا كان المستعرض أو جهاز يدعم ملفات تعريف الارتباط لكن ملفات تعريف الارتباط معطلة حالياً سيستمر استخدام ملفات تعريف الارتباط بواسطة الميزة الطالبة. UseCookies يحدد استخدام ملفات تعريف الارتباط في استمرار بيانات المستخدم بغض النظر عن ما إذا كان المستعرض أو الجهاز يدعم ملفات تعريف الارتباط.هذا هو الإعداد الافتراضي. UseDeviceProfile تحديد ASP.NET يحدد ما إذا كان سيتم استخدام ملفات تعريف الارتباط استناداً إلى HttpBrowserCapabilitiesالإعداد.إذا كان الإعداد يشير إلى أن المستعرض أو الجهاز يدعم ملفات تعريف الارتباط, يتم استخدام ملفات تعريف الارتباط; وإلا, يتم استخدام معرّف في سلسلة الاستعلام. UseUri تعيين استخدام ميزة الاتصال سلسلة الاستعلام لتخزين معرّف ما بغض النظر عن ما إذا كان المستعرض أو الجهاز يدعم ملفات تعريف الارتباط. يكون الإعداد الافتراضي هو "UseCookies".
cookieName	تحديد الاسم الذي تم تعيينه لملف تعريف ارتباط. القيمة الافتراضية هي ".ASPXANONYMOUS".
cookiePath	يقوم بتعيين المسار إلى الدليل حيث يتم تخزين ملف تعريف ارتباط. المسار حساس لحالة الأحرف. الافتراضي هو الدليل الجذري المحدد بواسطة "/".
cookieProtection	تعيّن نظام حماية ملف تعريف الارتباط. يمكن أن تكون هذه السمة إحدى القيم الممكنة التالية. Valueالوصف All تعيّن كلا القيمتين Validationو Encryptionيتم استخدامهما لحماية المعلومات في ملف تعريف الارتباط. Encryption تشفير المعلومات في ملف تعريف الارتباط. None تحديد معلومات ملف تعريف الارتباط غير محمية.المعلومات في ملف تعريف الارتباط مخزنة في نص واضح و لم يتم التحقق من صحتها عند إعادة المعلومات إلى الخادم. Validation تضمن أن المعلومات الموجودة في ملف تعريف الارتباط لم يتم تغييرها قبل إعادة المعلومات إلى الخادم. يكون الإعداد الافتراضي هو "Validation".
cookieRequireSSL	تحديد ما إذا كان ملف تعريف الارتباط يتطلب اتصال طبقة مآخذ توصيل آمنة (SSL) عند نقلها إلى العميل. نظرًا لتعييت ASP.NET لخاصية مصاقة ملف تعريف الارتباط Secure، لا يقوم العميل بإرجاع ملف تعريف الارتباط إلا إذا كان اتصال SSL مستخدم. يكون الإعداد الافتراضي هو false.
cookieSlidingExpiration	سمة Boolean مطلوبة. تحديد ما إذا كانت تتم يعيد تعيين المعاملة مهلة ملف تعريف ارتباط في كل طلب أو في فاصل زمني محدد معرّف مسبقاً. اذاtrueمهلة ملف تعريف ارتباط يحدث عندما يتبقى أقل من 50% من قيمة مدة الحياة (TTL) اذاfalseملف تعريف الارتباط ينتهي بعدcookieTimeout انقضاء المدة يكون الإعداد الافتراضي هو true.
cookieTimeout	سمة TimeSpan مطلوبة. تعيّن الفاصل الزمني لانتهاء صلاحية ملف تعريف ارتباط بالدقائق. الافتراضي هو 100000دقائق (69 أيام, 10 ساعات, و 40 دقيقة). تبلغ القيمة القصوى سنتين
domain	تعيّن مجال ملف تعريف الارتباط. تسمح هذه السمة لملف تعريف الارتباط المعرف المجهول بالمشاركة عبر المجالات التي لها مساحة اسم DNS شائعة (على سبيل المثال، كافة المواقع التي تنتهي بـ contoso.com). لكي تجعل ملفات تعريف الارتباط المعرّفة و المجهولة مشتركة, يجب أن تشترك المواقع الشائعة بمفاتيح فك التشفير والتحقق من صحة. سمات التكوين المعرفة المجهولة الأخرى مثل cookiePathوcookieName يجب أن تكون هي نفسها لكل المواقع لمزيد من المعلومات، راجع HttpCookie. الافتراضي عبارة عن سلسلة فارغة.
enabled	سمة Boolean اختيارية. تحدد ما إذا تم تمكين تعريف مجهول. إذا كان true, ملف تعريف الارتباط (أو قيمة خالية من ملفات تعريف الارتباط) يتم استخدامه لإدارة المستخدم المجهول المعرّف. يكون الإعداد الافتراضي هو false.

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

لا يوجد.

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

العنصر	الوصف
configuration	تحديد جذر العنصر المطلوب في كل ملف تكوين مستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات NET Framework.
system.web	تحديد العنصر الجذر لإعدادات تكوين ASP.NET في ملف تكوين واحتواء على عناصر تكون تطبيقات ويب ASP.NET وتتحكم بسلوك التطبيقات.

ملاحظات

<anonymousIdentification>العنصر يقوم بتكوين تعريف مجهول لتطبيق التخويل. هذا مطلوب لتعريف الوحدات التي يتم مصادقتها عند استخدام ميزة التحليل.

يمكنك أن تتجاوز الحد الأقصى لحجم URI عندما ترسل بطاقة تعريف مجهولة في URI. في حال كانت تركيبة بطاقة تعريف مجهول و تذكرة المصادقة المعرّفة و جلسة عمل المعرف و بيانات المستخدم أكبر من الطول الأقصى المسموح به لـ URI سيفشل الطلب مع طلب خاطئ 400 سيئة.

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

The following default <anonymousIdentification> element is not explicitly configured in the Machine.config file or in the root Web.config file. ومع ذلك، هو التكوين الافتراضي الذي يتم إرجاعه من قبل التطبيق.

<anonymousIdentification 
   enabled="false" 
   cookieName=".ASPXANONYMOUS" 
   cookieTimeout="100000"    
   cookiePath="/" 
   cookieRequireSSL="false" 
   cookieSlidingExpiration="true" 
   cookieProtection="Validation"    
   cookieless="UseCookies" 
   domain="" 
/>

مثال

يوضح الرمز التالي كيفية تكوين موقع لتعريف مجهول.

<configuration>
    <system.web>
      <anonymousIdentification 
        enabled="true"
        cookieless="UseCookies"
        cookieName=".ASPXANONYMOUS"
        cookieTimeout="30"
        cookiePath="/"
        cookieRequireSSL="false"
        cookieSlidingExpiration = "true"
        cookieProtection="Clear"
      />
    </system.web>
</configuration>

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

معالج مقطع التكوين	AnonymousIdentificationSection
عضو التكوين	AnonymousIdentification
مواقع للتكوين	Machine.config مستوى جذر ويب.config مستوى تطبيق ويب.config
المتطلبات	Microsoft Internet Information Services (IIS) الإصدار 5.0 أو 5.1 أو 6.0. .NET Framework، الإصدار 2.0 Microsoft Visual Studio 2003 أو Visual Studio 2005

راجع أيضًا:

مشاركة عبر

عنصر anonymousIdentification (مخطط إعدادات ASP.NET)

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

السمات

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

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

ملاحظات

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

مثال

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

راجع أيضًا:

المهام

المرجع

المبادئ

موارد أخرى

الموارد الإضافية