Podrška za zadane verzije sustava TLS obuhvaćene .NET Framework 3.5 u sustavu Windows 8.1 i Windows Server 2012 R2

Rješenje

Smjernice za razvojne inženjere

Definicija novih proširenja nalaze se u sljedećim datotekama:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  pomoću značajke System.Security.Authentication;
  public static class SecurityProtocolTypeExtensions
  {
  javni const SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;
  javni const SecurityProtocolType Tls11 = (SecurityProtocolType)SslProtocolsExtensions.Tls11;
  javni const SecurityProtocolType SystemDefault = (SecurityProtocolType)0;
  }
  }

• SslProtocolsExtensions.csnamespace System.Security.Authentication
  {
  public static class SslProtocolsExtensions
  {
  javni const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  javni konst SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Da biste uvrstili podršku za TLS v1.2, uvrsti izvorne datoteke u projekt, a zatim postavite verziju protokola na sljedeći način:
 

• Aplikacije koje koriste API-je utemeljene na servisu ServicePointManager mogu protokol postaviti na sljedeći način:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Aplikacije koje koriste SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) mogu postaviti vrijednost SslProtocols kao SslProtocolsExtensions.Tls12.

Ako je registar naveden u prvom odlomku postavljen, a u aplikaciji vrijednost SslProtocols postavljena je kao SslProtocols.None, odabrano je zadano ponašanje sustava koje će ovisiti o verziji Windows operacijskog sustava.

Kada promijenite kod aplikacije da biste omogućili podršku za TLS v1.2 sa sustavom .NET Framework 3.5 SP1, na računalima na kojima se ta zakrpa ne implementira upravljate sljedećim iznimkama:
 

1. Ako hitni popravak nije instaliran, API-jeva utemeljenih na servisu ServicePointManager (HTTP, FTP, SMTP) odbacit će "System.NotSupportedException: zatraženi sigurnosni protokol nije podržan." kada aplikacija nazove ServicePointManager.SecurityProtocol da bi postavili novu vrijednost.

2. Ako hitni popravak nije instaliran, API-jeve utemeljene na SslStreamu odbacit će se prilikom pozivanja bilo koje od API-ja AuthenticateA* :

   System.ArgumentException: navedena vrijednost nije valjana u enumeraciji 'SslProtocolType'.
   Naziv parametra: sslProtocolType

Napomena Samo za SslStream, kombinaciju Tls12, Tls11 s bilo kojim postojećim Tls-om, Ssl3, Ssl2 (na primjer: Tls12 | Tls11 | Tls) tiho će se unazaditi na postojeće protokole (na primjer: Tls) na sustavu bez zakrpe. Povezivati će se s Tls-om bez bacanja iznimke.
 

Dodatne informacije

Da biste TLS v1.1 ili v1.2 omogućili kao zadane postavke operacijskog sustava, slijedite upute u članku https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Napomena TLS v1.1 i v1.2 nisu dostupni u sustavu Windows Vista ili Windows Server 2008.

Ako morate onemogućiti zadane postavke operacijskog sustava postavljene ključem registra koji se ranije spominje za određene aplikacije, to možete učiniti dodavanjem sljedećeg ključa registra:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Cijeli put .exe datoteke za datoteku>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Dodatne informacije o TLS v1.2 potražite u članku Uvod u TLS v1.2.

Kada omogućite ključ registra SystemDefaultTlsVersions .NET, za svaku se verziju sustava Windows, kao što je prikazano u sljedećoj tablici.