Podpora výchozích verzí systému TLS zahrnutých v .NET Framework 3.5 v Windows Server 2012

Řešení

Pokyny pro vývojáře

Definice nových rozšíření je v následujících souborech:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  pomocí system.security.authentication;
  Veřejná statická třída 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
  {
  veřejná statická třída SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Pokud chcete zahrnout podporu protokolu TLS verze 1.2, zahrnovat zdrojové soubory do projektu a pak nastavte verzi protokolu pomocí následujících metod:
 

• Aplikace, které používají rozhraní API založená na servicepointové aplikaci ServicePointManager, mohou protokol nastavit pomocí následujících možností:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Aplikace, které používají přetížení SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean), mohou nastavit hodnotu SslProtocols jako SslProtocolsExtensions.Tls12.

Pokud je nastavené nastavení registru uvedené v prvním odstavci a hodnota SslProtocols je v aplikaci nastavená jako SslProtocols.None, bude výchozí chování systému, které se zvolí, záviset na Windows verzi.

Pokud změníte kód aplikace tak, aby povoloval podporu tls v1.2 s aktualizací .NET Framework 3.5 SP1, měli byste se ujistit, že na počítačích, na kterých není tato oprava nasazená, řešíte následující výjimky:
 

1. Pokud není oprava hotfix nainstalovaná, rozhraní API založená na servicepointovém správci (HTTP, FTP, SMTP) vyvolá "System.NotSupportedException: Požadovaný protokol zabezpečení není podporovaný", když aplikace zavolá ServicePointManager.SecurityProtocol, aby nastavila novou hodnotu.

2. Pokud není oprava hotfix nainstalovaná, rozhraní API založená na protokolu SslStream vyvolají výjimky, když volají na některou z rozhraní API AuthenticateAs*:

   System.ArgumentException: Zadaná hodnota není platná ve výčtu SslProtocolType.
   Název parametru: sslProtocolType

Poznámka: Pouze sslstream je kombinace tls12, tls11 s libovolným existujícím tls, ssl3, ssl2 (například tls12 | Tls11 | Tls) bude bezobslužně downgradovat na stávající protokoly (například Tls) v systému bez opravy. Připojí se k Tls, aniž by došlo k výjimce.
 

Další informace

Pokud chcete jako výchozí operační systém povolit tls verze 1.1 nebo v1.2, postupujte podle pokynů na adrese https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Poznámka: Tls verze 1.1 a v1.2 nejsou dostupné v Windows Vista nebo Windows Server 2008.

Pokud musíte zakázat výchozí nastavení operačního systému, která jsou nastavená klíčem registru uvedeným v části Řešení pro konkrétní aplikace, můžete to udělat přidáním následujícího klíče registru:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Úplná cesta k .exe pro soubor>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Další informace o tls v1.2 najdete v tématu Představení TLS verze 1.2.

Po povolení klíče registru SystemDefaultTlsVersions .NET dojde u každé verze Windows k jinému chování, jak ukazuje následující tabulka.