Підтримка стандартних версій 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;
  public const SecurityProtocolType SystemDefault = (SecurityProtocolType)0;
  }
  }

• SslProtocolsExtensions.csnamespace System.Security.Authentication
  {
  загальнодоступний статичний клас SslProtocolsExtensions
  {
  загальнодоступний конст SslProtocols Tls12 = (SslProtocols)0x00000C00;
  загальнодоступний конст 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 з пакетом оновлень 1 (SP1) для .NET Framework 3.5, перевірте, чи вирішено такі винятки на комп'ютерах, на яких не розгорнуто це виправлення:
 

1. Якщо виправлення не інстальовано, інтерфейси API на основі ServicePointManager (HTTP, FTP, SMTP) з'являться повідомлення "System.NotSupportedException: запитаний протокол безпеки не підтримується", коли програма викликає ServicePointManager.SecurityProtocol, щоб установити нове значення.

2. Якщо виправлення не інстальовано, API на основі SslStream викликає винятки під час виклику будь-якого з AuthenticateAs* API:

   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 для кожної версії Windows поведінка відбувається по-різному, як показано в таблиці нижче.