支援 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
  {
  公用 const SslProtocols Tls12 = (SslProtocols) 0x00000C00;
  公用 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 版本而決定。

此外，當您變更應用程式代碼以啟用 tLS v1.2 與 .NET Framework 3.5 SP1 的支援時，您應該確定解決未部署此修補程式的電腦上下列例外情形：
 

1. 如果未安裝 hotfix，當應用程式打電話給 ServicePointManager.SecurityProtocol 以設定新值時，ServicePointManager 型 API (HTTP、FTP、SMTP) 會傳出「System.NotSupportedException：不支援要求的安全性通訊協定」。

2. 如果未安裝 hotfix，當 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的指示。

請注意，Vista 或 Windows Server 2008 中Windows TLS v1.1 和 v1.2。

如果您必須停用由特定應用程式的 「解決」區段提及的登錄機碼所設定的作業系統預設值，您可以為檔案>> DWORD 0
新增下列登錄機碼：HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<.exe 完整路徑>> C:\MyApp\MyApp.exe DWORD 0

有關 TLS v1.2 的資訊，請參閱 介紹 TLS v1.2。

啟用 SystemDefaultTlsVersions .NET 登錄機碼之後，每個版本的 Windows 會發生不同的行為，如下表所示。