Unterstützung für TLS-Standardversionen in .NET Framework 3.5 für Windows 8.1 und Windows Server 2012 R2

Lösung

Entwicklerleitfade

Die Definition der neuen Erweiterungen ist in den folgenden Dateien enthalten:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  mithilfe von System.Security.Authentication;
  öffentliche statische Klasse 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
  {
  Öffentliche statische Klasse SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Um die Unterstützung für TLS v1.2 zu nutzen, schließen Sie die Quelldateien in Ihr Projekt ein, und legen Sie dann die Protokollversion mit den folgenden Methoden festgelegt:
 

• Anwendungen, die ServicePointManager-basierte APIs verwenden, können das Protokoll wie folgt festlegen:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Anwendungen, die die SSLStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)-Überladung verwenden, können den SslProtocols-Wert als SslProtocolsExtensions.Tls12 festlegen.

Wenn die im ersten Absatz erwähnte Registrierung festgelegt ist und in der Anwendung der SslProtocols-Wert auf SslProtocols.None festgelegt ist, wird das Standardverhalten des Systems ausgewählt, das von der Version des Windows-Betriebssystems abhängig ist.

Wenn Sie den Anwendungscode ändern, um die Unterstützung für TLS v1.2 mit .NET Framework 3.5 SP1 zu aktivieren, sollten Sie außerdem sicherstellen, dass Sie auf Computern, auf denen dieser Patch nicht bereitgestellt wird, die folgenden Ausnahmen behandeln:
 

1. Wenn der Hotfix nicht installiert ist, wird von ServicePointManager-basierten APIs (HTTP, FTP, SMTP) der Fehler "System.NotSupportedException: Das angeforderte Sicherheitsprotokoll wird nicht unterstützt" ausgelöst, wenn die Anwendung ServicePointManager.SecurityProtocol aufruft, um den neuen Wert festlegen.

2. Wenn der Hotfix nicht installiert ist, werden sslStream-basierte APIs beim Aufrufen einer der AuthenticateAs*-APIs ausgelöst:

   System.ArgumentException: Der angegebene Wert ist in der "SslProtocolType"-Enumeration ungültig.
   Parametername: sslProtocolType

Hinweis: Nur sslStream, eine Kombination von Tls12, Tls11 mit einem der vorhandenen Tls, Ssl3, Ssl2 (z. B.: Tls12 | Tls11 | Tls) wird ohne den Patch ohne den Patch automatisch auf die vorhandenen Protokolle (z. B. Tls) heruntergestuft. Es wird eine Verbindung mit Tls hergestellt, ohne dass die Ausnahme ausgelöst wird.
 

Weitere Informationen

Zum Aktivieren von TLS v1.1 oder v1.2 als Betriebssystem-Standardeinstellungen folgen Sie den Anweisungen unter https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Hinweis TLS v1.1 und v1.2 sind in Windows Vista oder Windows Server 2008 nicht verfügbar.

Wenn Sie die standardwerte des Betriebssystems deaktivieren müssen, die mit dem oben erwähnten Registrierungsschlüssel für bestimmte Anwendungen festgelegt wurden, können Sie den folgenden Registrierungsschlüssel hinzufügen:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Vollständiger Pfad des .exe für die Datei>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Weitere Informationen zu TLS v1.2 finden Sie unter Einführung in TLS v1.2.

Nachdem Sie den Registrierungsschlüssel SystemDefaultTlsVersions .NET aktiviert haben, tritt für jede Version von Windows ein anderes Verhalten auf, wie in der folgenden Tabelle dargestellt.