Поддержка системных версий TLS по умолчанию, включенных в платформа .NET Framework 2.0 с SP2 в Windows Vista с SP2 и Server 2008 с SP2

Решение

Руководство для разработчиков

Определения новых расширений находятся в следующих файлах:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  с помощью System.Security.Authentication;
  Public static class SecurityProtocolTypeExtensions
  {
  public const const SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;
  public const const SecurityProtocolType Tls11 = (SecurityProtocolType)SslProtocolsExtensions.Tls11;
  public const Const SecurityProtocolType SystemDefault = (SecurityProtocolType)0;
  }
  }

• SslProtocolsExtensions.csnamespace System.Security.Authentication
  {
  public static class SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Чтобы включить поддержку протокола TLS версии 1.2, включите исходные файлы в проект и за установите версию протокола, используя следующие методы:
 

• Приложения, использующие API На основе ServicePointManager, могут настроить протокол следующим образом:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Приложения, использующие перегрузку SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean), могут установить значение SslProtocols как SslProtocolsExtensions.Tls12.

Если параметр реестра, упомянутый в первом абзаце, за установлен, а значение SslProtocols в приложении — SslProtocols.None, то выбранное поведение по умолчанию будет зависеть от Windows версии.

Кроме того, при изменении кода приложения, чтобы включить поддержку TLS 1.2 с платформа .NET Framework 3.5 с SP1, необходимо решить следующие исключения на компьютерах, на которых это исправление не развернуто:
 

1. Если hotfix не установлен, то при вызове приложения ServicePointManager.SecurityProtocol для установки нового значения приложением ServicePointManager выведет "System.NotSupportedException: запрашиваемая система безопасности не поддерживается".

2. Если hotfix не установлен, API на базе SslStream забросят исключения при вызове одного из API AuthenticateAs*:

   System.ArgumentException: указанное значение не является допустимым в аргументе "SslProtocolType".
   Имя параметра: sslProtocolType

Примечание. Только для SslStream — сочетание Tls12, Tls11 с любым из существующих TLS, Ssl3, Ssl2 (например, Tls12 | Tls11 | TLS) без исправления автоматически переводится на существующие протоколы (например, TLS) в системе. Он будет подключаться к TLS без исключения.
 

Дополнительная информация

Чтобы включить TLS 1.1 или 1.2 по умолчанию в операционной системе, следуйте инструкциям на странице https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Примечание. TLS 1.1 и 1.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 1.2 см. в сведениях о TLS 1.2.

После того как вы вжмете systemDefaultTlsVersions .NET registry key, для каждой версии Windows, как показано в таблице ниже.