Unterstützung für TLS-Standardversionen in .NET Framework 3.5.1 für Windows 7 SP1 und Server 2008 R2 SP1

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 verwenden, 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 Registrierungseinstellung und der SslProtocols-Wert in der Anwendung als SslProtocols.None festgelegt ist, hängt das ausgewählte Standardverhalten des Systems von der Windows-Version ab.

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 die folgenden Ausnahmen auf Computern ansprechen, auf denen dieser Patch nicht bereitgestellt wird:
 

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 von sslStream-basierten APIs Ausnahmen ausgelöst, wenn sie eine der AuthenticateAs*-APIs aufrufen:

   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 durch den im Abschnitt "Auflösung" für bestimmte Anwendungen erwähnten Registrierungsschlüssel festgelegt werden, können Sie dazu 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.