Obsługa wersji domyślnych systemu TLS zawartych w .NET Framework 3.5.1 w systemach Windows 7 SP1 i Server 2008 R2 SP1

Rozwiązanie

Wskazówki dla deweloperów

Definicja nowych rozszerzeń znajduje się w następujących plikach:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  za pomocą funkcji System.Security.Authentication;
  public static class SecurityProtocolTypeExtensions
  {
  const SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;
  const SecurityProtocolType Tls11 = (SecurityProtocolType)SslProtocolsExtensions.Tls11;
  const SecurityProtocolType SystemDefault = (SecurityProtocolType)0;
  }
  }

• SslProtocolsExtensions.csnamespace System.Security.Authentication
  {
  publiczna klasa statyczna SslProtocolsExtensions
  {
  const Public SslProtocols Tls12 = (SslProtocols)0x00000C00;
  const Publiczny SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Aby uwzględnić obsługę protokołu TLS w wersji 1.2, uwzględnij pliki źródłowe w projekcie, a następnie ustaw wersję protokołu przy użyciu następujących metod:
 

• Aplikacje korzystające z interfejsów API opartych na usłudze ServicePointManager mogą ustawiać protokół, korzystając z następujących funkcji:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Aplikacje korzystające z nadmiaru SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) można ustawić wartość SslProtocols jako SslProtocolsExtensions.Tls12.

Jeśli ustawienie rejestru, o którym wspomniano w pierwszym akapicie, jest ustawione, a wartość SslProtocols jest ustawiona w aplikacji jako SslProtocols.None, domyślne zachowanie systemu, które zostanie wybrane, zależy od wersji Windows.

Ponadto w przypadku zmiany kodu aplikacji w celu włączenia obsługi TLS 1.2 z dodatkiem .NET Framework 3.5 z dodatkiem SP1 należy się upewnić, że w przypadku komputerów, na których nie wdrożono tej poprawki, należy odłączyć się od następujących wyjątków:
 

1. Jeśli poprawka nie jest zainstalowana, interfejsy API oparte na usłudze ServicePointManager (HTTP, FTP, SMTP) będą zgłaszać błąd "System.NotSupportedException: Żądany protokół zabezpieczeń nie jest obsługiwany", gdy aplikacja wywoła usługę ServicePointManager.SecurityProtocol, aby ustawić nową wartość.

2. Jeśli poprawka nie jest zainstalowana, interfejsy API oparte na technologii SslStream zgłasza wyjątki, gdy wywołują one jeden z interfejsów API uwierzytelniania*:

   System.ArgumentException: Określona wartość jest prawidłowa w wyliczeniu "SslProtocolType".
   Nazwa parametru: sslProtocolType

Uwaga Tylko dla protokołu SslStream: połączenie protokołu Tls12, Tls11 z dowolnym z istniejących Tls, Ssl3, Ssl2 (na przykład: Tls12 | Tls11 | Tls) dyskretnie obniży poziom do istniejących protokołów (na przykład Tls) w systemie bez poprawki. Spowoduje to połączenie z tls bez zgłaszania wyjątku.
 

Więcej informacji

Aby włączyć obsługę standardu TLS w wersji 1.1 lub 1.2 jako domyślnego systemu operacyjnego, postępuj zgodnie z instrukcjami podanymi na stronie https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Uwaga W systemach Windows 1.1 i 1.2 usługi TLS nie są dostępne w systemach Windows Vista Windows Server 2008.

Jeśli musisz wyłączyć ustawienia domyślne systemu operacyjnego ustawiane przez klucz rejestru wymieniony w sekcji "Rozdzielczość" dla określonych aplikacji, możesz to zrobić, dodając następujący klucz rejestru:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Pełna ścieżka pliku .exe pliku>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Aby uzyskać więcej informacji na temat TLS w wersji 1.2, zobacz Wprowadzenie do TLS w wersji 1.2.

Po włączeniu klucza rejestru .NET systemuDefaultTlsVersions dla każdej wersji programu Windows występuje inne zachowanie, jak pokazano w poniższej tabeli.