A TLS rendszer alapértelmezett verzióinak támogatása a .NET-keretrendszer 3.5-ös verziójában Windows Server 2012

Megoldás

Fejlesztői útmutató

Az új bővítmények definíciója az alábbi fájlokban található:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  a System.Security.Authentication használatával;
  public static class 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
  {
  public static class SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

A TLS 1.2-es verziójának támogatásához foglalja bele a forrásfájlokat a projektbe, majd állítsa be a protokoll verzióját az alábbi módokon:
 

• A ServicePointManager-alapú API-kat használó alkalmazások az alábbiak szerint állíthatják be a protokollt:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Az SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) túlterhelést használó alkalmazások az SslProtocols értéket SslProtocolsExtensions.Tls12 értékre állíthatják.

Ha az első bekezdésben említett beállításjegyzékbeli beállítás, és az SslProtocols értéke SslProtocols.None, a rendszer alapértelmezett viselkedése a választott Windows-verziótól függ.

Ha módosítja az alkalmazáskódot úgy, hogy az .NET-keretrendszer 3.5 SP1-es TLS 1.2-es vLS támogatását engedélyezze, az alábbi kivételeket is meg kell tennie minden olyan számítógépen, amelyen nincs telepítve a javítás:
 

1. Ha nincs telepítve a gyorsjavítás, a ServicePointManager-alapú API-k (HTTP, FTP, SMTP) a "System.NotSupportedException: A kért biztonsági protokoll nem támogatott" értéket adja vissza, amikor az alkalmazás hívja a ServicePointManager.SecurityProtocol értéket az új érték beállításához.

2. Ha nincs telepítve a gyorsjavítás, az SslStream-alapú API-k kivételeket fognak tenni, amikor a AuthenticateAs* API-k valamelyikét hívják:

   System.ArgumentException: A megadott érték nem érvényes az SslProtocolType felsorolásában.
   Paraméter neve: sslProtocolType

Megjegyzés: Csak az SslStream esetén, a Tls12 és a Tls11 kombinációja a meglévő Tls, Ssl3 és Ssl2 bármelyik meglévővel (például: Tls12 | Tls11 | A Tls csendesen visszalépést fog a meglévő protokollokra (például: Tls) egy javítás nélküli rendszeren. Anélkül csatlakozik a Tls-hez, hogy kivételt képeznek.
 

További információ

A TLS 1.1-es vagy 1.2-es alapértelmezett operációs rendszerként való engedélyezéséhez kövesse a https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Megjegyzés: A TLS 1.1-es és 1.2-es verziójához nem érhető el Windows Vista vagy Windows Server 2008.

Ha le kell tiltania az egyes alkalmazások "Megoldás" szakaszában említett beállításkulcs által beállított alapértelmezett operációs rendszereket, ezt a következő beállításkulcs hozzáadásával tudja megtenni:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<A .exe teljes elérési útvonala a fájlhoz>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

A TLS 1.2-esről további információt A TLS 1.2-es vLsz.

A SystemDefaultTlsVersions .NET beállításkulcs engedélyezése után az Windows minden verziójában más viselkedés történik, az alábbi táblázatban látható módon.