Støtte for TLS systemet standard versjoner inkludert i .NET Framework 3.5.1-funksjoner på Windows 7 SP1 og Server 2008 R2 SP1

Løsning

Veiledning for utviklere

Definisjonen av de nye utvidelsene er i følgende filer:

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  using System.Security.Authentication;
  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;
  }
  }

Hvis du vil ha støtte for TLS v1.2, inkludere kildefilene i prosjektet, og angi deretter protokollversjonen ved hjelp av følgende metoder:

• Programmer som bruker ServicePointManager-baserte APIer kan angi protokollen ved hjelp av følgende:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Programmer som bruker SslStream AuthenticateAsClient (streng, X509CertificateCollection, SslProtocols, boolsk) -overlasten kan angi verdien SslProtocols som SslProtocolsExtensions. Tls12.

Hvis registerinnstillingen som er nevnt i det første avsnittet er angitt, og SslProtocols -verdi er angitt i programmet som SslProtocols.None, systemet standardvirkemåte som velges, avhenger av Windows-versjonen.

Også, når du endrer programmet koden å aktivere støtte for TLS v1.2 med .NET Framework 3.5 SP1, må du kontrollere at du løser følgende unntak på datamaskiner som denne oppdateringen ikke er distribuert:

1. Hvis hurtigreparasjonen ikke er installert, ServicePointManager-baserte APIer (HTTP, FTP, SMTP) vil iverksette "System.NotSupportedException: den forespurte sikkerhetsprotokollen støttes ikke" når programmet kaller ServicePointManager.SecurityProtocol til å angi den nye verdien.

2. Hvis hurtigreparasjonen ikke er installert, SslStream-baserte APIer kvitter unntak når de kaller opp en av APIene AuthenticateAs *:

   System.ArgumentException: Den angitte verdien er ikke gyldig i 'SslProtocolType'-opplistingen.
   Parameternavn: sslProtocolType

Obs! For SslStream , en kombinasjon av Tls12, Tls11 med noen av de eksisterende Tls, Ssl3, Ssl2 (for eksempel: Tls12 | Tls11 | TLS) vil nedgraderer i eksisterende protokollene (for eksempel: Tls) på et system uten oppdateringen. Kobler den til Tls uten forårsaket unntaket.

Hvis du vil ha mer informasjon

Hvis du vil aktivere TLS v1.1 eller v1.2 som standard operativsystem, følg instruksjonene i https://technet.microsoft.com/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Obs! TLS-v1.1 og v1.2 er ikke tilgjengelig i Windows Vista eller Windows Server 2008.

Hvis du må deaktivere standardverdiene for operativsystemet som er angitt av registernøkkelen som er nevnt i delen "Løsning" for bestemte programmer, kan du gjøre dette ved å legge til følgende registernøkkel:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Full path of the .exe for the file>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Hvis du vil ha mer informasjon om TLS v1.2, se Innføring i TLS v1.2.

Når du aktiverer registernøkkelen SystemDefaultTlsVersions .NET, skjer en annen for hver versjon av Windows, som vist i følgende tabell.