Az .NET-keretrendszer 3.5-ös, Windows 8.1-es és R2-es verziójában szereplő TLS-rendszer Windows Server 2012 verziók támogatása

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 protokollverziót az alábbi módszerek egyikével:
 

• A ServicePointManager-alapú API-kat használó alkalmazások a következőképpen á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ék be van állítva, és az alkalmazásban az SslProtocols értéke SslProtocols.None, akkor a rendszer alapértelmezett viselkedése az Windows operációs rendszer verziójától függ.

Ha az alkalmazáskódot úgy módosítja, hogy az .NET-keretrendszer 3.5 SP1-es TLS 1.2-es vLS támogatását engedélyezze, győződjön meg arról, hogy a javítást nem támogató számítógépeken kezeli az alábbi kivételeket:
 

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 szolgáltatót az új érték beállításához.

2. Ha nincs telepítve a gyorsjavítás, az SslStream-alapú API-k a AuthenticateAs* API-k hívásakor a következőt fogja használni:

   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ásokhoz korábban említett beállításkulcs által beállított operációs rendszer-alapértelmezéseket, azt a következő beállításkulcs hozzáadásával tudja beállítani:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<A fájl .exe teljes elérési útja>> 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.