Підтримка стандартних версій TLS, включених до .NET Framework 3.5 у Windows 8.1 і Windows Server 2012 R2

Спосіб вирішення

Довідник розробника

Визначення нових розширень міститься в таких файлах:
 

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