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

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 het register dat in de eerste alinea wordt vermeld, is ingesteld en in de toepassing de waarde SslProtocols is ingesteld als SslProtocols.None, wordt het standaardgedrag van het systeem gekozen dat afhankelijk is van de versie Windows besturingssysteem.

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

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 op SslStream gebaseerde API's geplaatst wanneer u een van de AuthenticAs* API's belt:

   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 maken.
 

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 eerder is vermeld voor specifieke toepassingen, kan dit worden gedaan door de volgende registersleutel toe te voegen:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Volledig pad van de .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.