دعم الإصدارات الافتراضية لنظام TLS المضمنة في .NET Framework 3.5 على Windows Server 2012

الحل

إرشادات المطور

يوجد تعريف الملحقات الجديدة في الملفات التالية:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  باستخدام System.Security.Authentication؛
  SecurityProtocolTypeExtensions للفئة الثابتة العامة
  {
  const SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;
  const SecurityProtocolType Tls11 = (SecurityProtocolType)SslProtocolsExtensions.Tls11;
  const SecurityProtocolType SystemDefault = (SecurityProtocolType)0;
  }
  }

• SslProtocolsExtensions.csnamespace System.Security.Authentication
  {
  SslProtocolsExtensions للفئة الثابتة العامة
  {
  const العامة SslProtocols Tls12 = (SslProtocols)0x00000C00;
  const العامة SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

لتضمين دعم TLS v1.2، قم بتضمين الملفات المصدر في المشروع، ثم قم بتعيين إصدار البروتوكول باستخدام الأساليب التالية:
 

• يمكن للتطبيقات التي تستخدم واجهات برمجة التطبيقات المستندة إلى ServicePointManager تعيين البروتوكول باستخدام ما يلي:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• يمكن للتطبيقات التي تستخدم التحميل الزائد SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) تعيين قيمة SslProtocols ك SslProtocolsExtensions.Tls12.

إذا تم تعيين إعداد التسجيل المذكور في الفقرة الأولى، وقيمة SslProtocols في التطبيق ك SslProtocols.None، سيعتمد السلوك الافتراضي للنظام الذي يتم اختياره على إصدار Windows.

أيضا، عند تغيير رمز التطبيق لتمكين دعم TLS v1.2 مع .NET Framework 3.5 SP1، يجب التأكد من معالجة الاستثناءات التالية على أجهزة الكمبيوتر التي لم يتم نشر هذا التصحيح عليها:
 

1. إذا لم يتم تثبيت hotfix، فإن واجهات برمجة التطبيقات المستندة إلى ServicePointManager (HTTP، FTP، SMTP) ستلقي "System.NotSupportedException: بروتوكول الأمان المطلوب غير معتمد" عندما يتصل التطبيق ب ServicePointManager.SecurityProtocol لتعيين القيمة الجديدة.

2. إذا لم يتم تثبيت hotfix، فإن واجهات برمجة التطبيقات المستندة إلى SslStream ست طرح استثناءات عند استدعاء أي من واجهات برمجة التطبيقات AuthenticateAs* :

   System.ArgumentException: القيمة المحددة غير صالحة في تعداد 'SslProtocolType'.
   اسم المعلمة: sslProtocolType

ملاحظة ل SslStream فقط، مجموعة من Tls12، Tls11 مع أي من Tls الموجودة، Ssl3، Ssl2 (على سبيل المثال: Tls12 | Tls11 | سيتم تخفيض درجات Tls بصمت إلى البروتوكولات الموجودة (على سبيل المثال: Tls) على نظام بدون التصحيح. سيتم الاتصال ب Tls دون طرح الاستثناء.
 

مزيد من المعلومات

لتمكين TLS v1.1 أو v1.2 كافتراضيات لنظام التشغيل، اتبع الإرشادات الموجودة في https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

ملاحظة TLS v1.1 وv1.2 غير متوفرين في Windows Vista أو Windows Server 2008.

إذا كان عليك تعطيل الإعدادات الافتراضية لنظام التشغيل التي تم تعيينها بواسطة مفتاح التسجيل المذكور في المقطع "الدقة" للتطبيقات المحددة، يمكنك القيام بذلك عن طريق إضافة مفتاح التسجيل التالي:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<المسار الكامل ل .exe للملف>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

لمزيد من المعلومات حول TLS v1.2، راجع تقديم TLS v1.2.

بعد تمكين مفتاح تسجيل SystemDefaultTlsVersions .NET، يحدث سلوك مختلف لكل إصدار من إصدارات Windows، كما هو موضح في الجدول التالي.