Understøttelse af standardversioner af TLS-systemet, der er inkluderet i .NET Framework 3.5 Windows Server 2012

Løsning

Udviklervejledning

Definitionen af de nye udvidelser findes i følgende filer:
 

• SecurityProtoskildpaddeTypeExtensions.csnamespace System.Net
  {
  ved hjælp af System.Security.Authentication;
  offentlig statisk klasse SecurityProtoskildpaddeTypeExtensions
  {
  public const SecurityProtoskildpaddeType Tls12 = (SecurityProtoskildpaddeType)SslProtoskildpaddesExtensions.Tls12;
  public const SecurityProtoskildpaddeType Tls11 = (SecurityProtoskildpaddeType)SslProtoskildpaddesExtensions.Tls11;
  public const SecurityProtoskildpaddeType SystemDefault = (SecurityProtoskildpaddeType)0;
  }
  }

• SslProto prototypesExtensions.csnamespace System.Security.Authentication
  {
  offentlig statisk klasse SslProtoskildpaddesExtensions
  {
  public const SslProtoskildpaddes Tls12 = (SslProtoskildpaddes)0x00000C00;
  public const SslProtoskildpaddes Tls11 = (SslProtoskildpaddes)0x00000300;
  }
  }

Hvis du vil medtage understøttelsen af TLS v1.2, skal du medtage kildefilerne i projektet og derefter angive protokolversionen ved hjælp af følgende metoder:
 

• Programmer, der bruger ServicePointManager-baserede API'er, kan indstille protokollen ved hjælp af følgende:
  
  System.Net.ServicePointManager.SecurityProtoskildpadde = SecurityProtoskildpaddeTypeExtensions.Tls12;

• Programmer, der bruger overbelastning af SslStream-godkendelseAsClient(Streng, X509CertificateCollection, SslProtoskildpaddes, Boolean), kan angive værdien SslProtoskildpaddes som SslProtoectionsExtensions.Tls12.

Hvis den indstilling i registreringsdatabasen, der er nævnt i det første afsnit, er angivet, og SslProto hele værdien er angivet i programmet som SslProtoskildpaddes.Ingen, vil den valgte systemstandardfunktionsmåde afhænge af Windows version.

Når du ændrer programkoden for at aktivere understøttelse af TLS v1.2 med .NET Framework 3.5 SP1, skal du desuden sikre dig, at du adresserer følgende undtagelser på computere, hvor denne programrettelse ikke er installeret:
 

1. Hvis hotfixet ikke er installeret, vises "System.NotSupportedException: The requested security protocol is not supported", når programmet kalder ServicePointManager.SecurityProtoskildpadde for at angive den nye værdi, hvis hotfixet ikke er installeret.

2. Hvis hotfixet ikke er installeret, giver SslStream-baserede API'er undtagelser, når de kalder en af Api'erne*-API'er (AuthenticateAs*):

   System.ArgumentException: Den angivne værdi er ikke gyldig i 'SslProtoskildpaddeType'-enumerationen.
   Parameternavn: sslProto sslType

Bemærk! Kun SslStream, en kombination af Tls12, Tls11 med en af de eksisterende Tls, Ssl3, Ssl2 (for eksempel: Tls12 | Tls11 | Tls) nedgraderer automatisk til de eksisterende protokoller (f.eks.: Tls) på et system uden programrettelsen. Den opretter forbindelse til Tls uden undtagelsen.
 

Flere oplysninger

For at aktivere TLS v1.1 eller v1.2 som standard for operativsystem skal du følge vejledningen på https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Bemærk, at TLS v1.1 og v1.2 ikke er tilgængelige i Windows Vista eller Windows Server 2008.

Hvis du er nødt til at deaktivere standardindstillingerne for operativsystemet, der er angivet af registreringsdatabasenøglen, der er nævnt i afsnittet "Løsning" for bestemte programmer, kan du gøre dette ved at tilføje følgende registreringsdatabasenøgle:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Hele stien til .exe til filen>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Du kan finde flere oplysninger om TLS v1.2 i Introduktion til TLS v1.2.

Når du har aktiveret registreringsdatabasenøglen SystemDefaultTlsVersions .NET, sker der en anden funktionsmåde for hver version af Windows, som vist i følgende tabel.