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

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 nastavovať protokol pomocou tohto:
  
  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 nastavenie databázy Registry uvedené v prvom odseku nastavené a v aplikácii je nastavená hodnota SslProtocols ako SslProtocols.None, predvolené správanie vybratého systému bude závisieť od Windows verzie.

Ak zmeníte kód aplikácie a povolíte podporu protokolu TLS v1.2 so systémom .NET Framework 3.5 SP1, skontrolujte, či sa v počítačoch, v ktorých nie je táto oprava nasadená, zhodovať s nasledujúcimi výnimkami:
 

1. Ak 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 zavolá na položku ServicePointManager.SecurityProtocol a nastaví novú hodnotu.

2. Ak rýchla oprava nie je nainštalovaná, rozhrania API typu SslStream budú pri volení niektorého z rozhraní API AuthenticateAs* vyhodzovať výnimky:

   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. Pripojí sa k 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 potrebujete pre konkrétne aplikácie vypnúť predvolené nastavenia operačného systému nastavené kľúčom databázy Registry, ktorý je uvedený v časti Riešenie, 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 databáze .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.