支持 TLS 系统默认版本，.NET Framework 3.5 Windows Server 2012

解决方法

开发人员指南

新扩展的定义在下列文件中：
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  使用 System.Security.Authentication;
  公共静态类 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
  {
  公共静态类 SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols) 0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols) 0x00000300;
  }
  }

若要包括对 TLS v1.2 的支持，请包含项目中的源文件，然后使用下列方法设置协议版本：
 

• 使用基于 ServicePointManager 的 API 的应用程序可以使用以下方法设置协议：
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• 使用 SslStream AuthenticateAsClient (String、X509CertificateCollection、SslProtocols、布尔) 重载的应用程序可以将 SslProtocols 值设置为 SslProtocolsExtensions.Tls12。

如果设置了第一个段落中提到的注册表设置，并且应用程序中的 SslProtocols 值设置为 SslProtocols.None，则选择的系统默认行为将取决于 Windows 版本。

此外，更改应用程序代码以启用对 .NET Framework 3.5 SP1 的 TLS v1.2 支持时，应确保在未部署此修补程序的计算机上解决以下异常：
 

1. 如果未安装修补程序，应用程序调用 ServicePointManager.SecurityProtocol 设置新值时，基于 ServicePointManager 的 API (HTTP、FTP、SMTP) 将引发"System.NotSupportedException： 不支持请求的安全协议"。

2. 如果未安装修补程序，则基于 SslStream 的 API 在调用其中一个 AuthenticateAs* API 时会引发异常：

   System.ArgumentException：指定的值无效"SslProtocolType"枚举中指定。
   参数名称：sslProtocolType

注意 仅适用于 SslStream，Tls12、Tls11 与任何现有的 Tls、Ssl3、Ssl2 (组合，例如 Tls12 |Tls11 |Tls) 会以无提示方式降级到现有协议 (例如：Tls) 没有修补程序的系统中。 它将连接到 Tls，而不会引发异常。
 

更多信息

若要启用 TLS v1.1 或 v1.2 作为操作系统默认值，请按照 https://technet.microsoft.com/en-us/library/dn786418 (v=ws.11) .aspx#BKMK_SchannelTR_TLS12 中的说明进行操作。

请注意，TLS v1.1 和 v1.Windows 2 在 Vista 或 Windows Server 2008 中不可用。

如果必须禁用由特定应用程序的"解析"部分中提到的注册表项设置的操作系统默认值，可以通过为文件 .exe>> DWORD 0
添加以下注册表项HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<完整路径来这样做 C:\MyApp\MyApp.exe DWORD 0

有关 TLS v1.2 详细信息，请参阅 TLS v1.2 介绍。

启用 SystemDefaultTlsVersions .NET 注册表项后，每个版本的 Windows 将发生不同的行为，如下表所示。