Поддръжка за TLS версии по подразбиране на системата, включени в .NET Framework (платформа) 3.5 на Windows Server 2012

Решение

Указания за разработчици

Дефиницията на новите разширения е в следните файлове:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  използване на System.Security.Authentication;
  публичен статичен клас SecurityProtocolTypeExtensions
  {
  публичен конст SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;
  публичен конст SecurityProtocolType Tls11 = (SecurityProtocolType)SslProtocolsExtensions.Tls11;
  публичен конст SecurityProtocolType SystemDefault = (SecurityProtocolType)0;
  }
  }

• SslProtocolsExtensions.csnamespace System.Security.Authentication
  {
  публичен статичен клас SslProtocolsExtensions
  {
  публичен конст SslProtocols Tls12 = (SslProtocols)0x00000C00;
  публичен конст SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

За да включите поддръжката за TLS v1.2, включете файловете източник във вашия проект и след това задайте версията на протокола с помощта на следните методи:
 

• Приложенията, които използват API на 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. Ако актуалната корекция не е инсталирана, базираните на ServicePointManager API (HTTP, FTP, SMTP) ще хвърлят "System.NotSupportedException: Исканият протокол за защита не се поддържа", когато приложението извине ServicePointManager.SecurityProtocol, за да зададете новата стойност.

2. Ако актуалната корекция не е инсталирана, базираните на SslStream API ще хвърлят изключения, когато извикват някоя от API на 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, както е показано в таблицата по-долу.