Podpora predvolených verzií systému TLS uvedených v .NET Framework 3.5 v Windows 8.1 a Windows Server 2012 R2

Riešenie

Pokyny pre vývojárov

Definícia nových rozšírení je v týchto súboroch:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  pomocou funkcie System.Security.Authentication;
  public static class SecurityProtocolTypeExtensions
  {
  public const SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;
  public const SecurityProtocolType Tls11 = (SecurityProtocolType)SslProtocolsExtensions.Tls11;
  public 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;
  }
  }

Ak chcete zahrnúť podporu protokolu TLS v1.2, zadajte do projektu zdrojové súbory a potom nastavte verziu protokolu nasledujúcimi spôsobmi:
 

• Aplikácie, ktoré používajú rozhrania API typu ServicePointManager, môžu protokol nastaviť takto:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Aplikácie, ktoré používajú preťaženie SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean), môžu nastaviť hodnotu SslProtocols na hodnotu SslProtocolsExtensions.Tls12.

Ak je databáza Registry uvedená v prvom odseku nastavená a v aplikácii je hodnota SslProtocols nastavená na možnosť SslProtocols.None, vyberie sa predvolené správanie systému, ktoré bude závisieť od verzie operačného Windows systému.

Aj pri zmene kódu aplikácie tak, aby sa technická podpora pre TLS v1.2 so systémom .NET Framework 3.5 SP1 zabezpečilo v počítačoch, v ktorých táto oprava nie je nasadená, by ste mali umožniť použitie týchto výnimiek:
 

1. Ak rýchla oprava nie je nainštalovaná, rozhrania API typu ServicePointManager (HTTP, FTP, SMTP) vyhodí reťazec System.NotSupportedException: Požadovaný protokol zabezpečenia nie je podporovaný. Keď aplikácia volá ServicePointManager.SecurityProtocol a nastaví novú hodnotu.

2. Ak rýchla oprava nie je nainštalovaná, pri volaní rozhrania API AuthenticateAs* sa pri volaní rozhrania API AuthenticateAs* vyhodí protokol SSLStream:

   System.ArgumentException: Zadaná hodnota nie je platná v enumerácii SslProtocolType.
   Názov parametra: sslProtocolType

Poznámka Len pre protokol SslStream je to kombinácia protokolu Tls12, Tls11 s ľubovoľným z existujúcich tls, Ssl3, Ssl2 (napríklad: Tls12 | Tls11 | Tls) potichu pre staršiu verziu na existujúce protokoly (napríklad: Tls) v systéme bez opravy. Spojí sa s Tls bez toho, aby zahodí výnimku.
 

Ďalšie informácie

Ak chcete povoliť protokol TLS v1.1 alebo v1.2 ako predvolený operačný systém, postupujte podľa pokynov v časti https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Poznámka TLS v1.1 a v1.2 nie je k dispozícii vo Windows Vista alebo Windows Serveri 2008.

Ak je potrebné vypnúť predvolené nastavenia operačného systému nastavené kľúčom databázy Registry, ktorý bol pre konkrétne aplikácie uvedený vyššie, môžete to urobiť pridaním nasledujúceho kľúča databázy Registry:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Úplná cesta k súboru .exe pre súbor>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Ďalšie informácie o TLS v1.2 nájdete v téme Úvod do TLS v1.2.

Po zapnutí kľúča databázy Registry SystemDefaultTlsVersions .NET sa pri každej verzii databázy Windows iné správanie, ako je uvedené v nasledujúcej tabuľke.