Ondersteuning voor standaardversies van TLS-systeem die zijn opgenomen in .NET Framework 3.5 op Windows Server 2012

Oplossing

Richtlijnen voor ontwikkelaars

De definitie van de nieuwe extensies staat in de volgende bestanden:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  met 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
  {
  openbare const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  openbare const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Als u de ondersteuning voor TLS v1.2 wilt opnemen, moet u de bronbestanden in uw project opnemen en vervolgens de protocolversie instellen met de volgende methoden:
 

• Toepassingen die op ServicePointManager gebaseerde API's gebruiken, kunnen het protocol als volgt instellen:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Toepassingen die de SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) gebruiken, kunnen de waarde SslProtocols instellen als SslProtocolsExtensions.Tls12.

Als de registerinstelling die in de eerste alinea wordt vermeld, is ingesteld en de waarde SslProtocols in de toepassing is ingesteld als SslProtocols.None, is het gekozen standaardgedrag van het systeem afhankelijk van de Windows versie.

Wanneer u de toepassingscode wijzigt om ondersteuning voor TLS v1.2 met .NET Framework 3.5 SP1 in te stellen, moet u ervoor zorgen dat u de volgende uitzonderingen aanpakt op computers waarop deze patch niet is geïmplementeerd:
 

1. Als de hotfix niet is geïnstalleerd, worden op ServicePointManager gebaseerde API's (HTTP, FTP, SMTP) 'System.NotSupportedException: Het aangevraagde beveiligingsprotocol niet ondersteund' wanneer de toepassing ServicePointManager.SecurityProtocol belt om de nieuwe waarde in te stellen.

2. Als het hotfix niet is geïnstalleerd, worden er op SslStream gebaseerde API's uitzonderingen gemaakt wanneer ze een van de AuthenticAs* API's bellen:

   System.ArgumentException: De opgegeven waarde is niet geldig in de 'SslProtocolType' enumeratie.
   Parameternaam: sslProtocolType

Opmerking Alleen voor SslStream is een combinatie van Tls12, Tls11 met een van de bestaande Tls, Ssl3, Ssl2 (bijvoorbeeld: Tls12 | Tls11 | Tls) wordt geruisloos gedegradeerd naar de bestaande protocollen (bijvoorbeeld Tls) op een systeem zonder de patch. Het maakt verbinding met Tls zonder de uitzondering te geven.
 

Meer informatie

Als u TLS v1.1 of v1.2 als standaardbesturingssysteem wilt inschakelen, volgt u de instructies op https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Opmerking TLS v1.1 en v1.2 zijn niet beschikbaar in Windows Vista of Windows Server 2008.

Als u de standaardinstellingen van het besturingssysteem moet uitschakelen die zijn ingesteld door de registersleutel die wordt vermeld in de sectie 'Resolutie' voor specifieke toepassingen, kunt u dit doen door de volgende registersleutel toe te voegen:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Volledig pad van het .exe voor het bestand>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Zie Inleiding tot TLS v1.2 voor meer informatie over TLS v1.2.

Nadat u de registersleutel SystemDefaultTlsVersions .NET hebt ingeschakeld, treedt er een ander gedrag op voor elke versie van Windows, zoals wordt weergegeven in de volgende tabel.