Støtte for standardversjoner av TLS-systemet som er inkludert i .NET Framework 3.5 på Windows Server 2012

Løsning

Veiledning for utviklere

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

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  ved hjelp av System.Security.Authentication;
  offentlig statisk klasse SecurityProtocolTypeExtensions
  {
  public const SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;
  public const SecurityProtocolType Tls11 = (SecurityProtocolType)SslProtocolsExtensions.Tls11;
  offentlig konst SecurityProtocolType SystemDefault = (SecurityProtocolType)0;
  }
  }

• SslProtocolsExtensions.csnamespace System.Security.Authentication
  {
  offentlig statisk klasse SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

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

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

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

Hvis registerinnstillingen som er nevnt i det første avsnittet, er angitt, og SslProtocols-verdien er angitt i programmet som SslProtocols.None, vil standard virkemåte for systemet som velges, avhenge av Windows versjonen.

Når du endrer programkoden for å aktivere støtte for TLS v1.2 med .NET Framework 3.5 SP1, må du også kontrollere at du løser følgende unntak på datamaskiner der denne oppdateringen ikke er distribuert:
 

1. Hvis hurtigreparasjonen ikke er installert, vil ServicePointManager-baserte API-er (HTTP, FTP, SMTP) kaste «System.NotSupportedException: Den forespurte sikkerhetsprotokollen støttes ikke» når programmet kaller ServicePointManager.SecurityProtocol for å angi den nye verdien.

2. Hvis hurtigreparasjonen ikke er installert, vil SslStream-baserte API-er gi unntak når de kaller en av Api-ene for AuthenticateAs*:

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

Obs! Bare for SslStream, en kombinasjon av Tls12, Tls11 med noen av de eksisterende Tls- og Ssl3-, Ssl2-, (for eksempel: Tls12 | Tls11 | Tls) nedgraderes stille til de eksisterende protokollene (for eksempel Tls) på et system uten oppdateringen. Den kobler til Tls uten å kaste unntaket.
 

Mer informasjon

Hvis du vil aktivere TLS v1.1 eller v1.2 som standard operativsystemstandarder, følger du instruksjonene på https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

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

Hvis du må deaktivere standardene for operativsystemet som er angitt av registernøkkelen som er nevnt i Løsning-delen 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
<<Fullstendig bane for .exe for filen>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

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

Når du har aktivert SystemDefaultTlsVersions .NET-registernøkkelen, oppstår det en annen virkemåte for hver versjon av Windows, som vist i tabellen nedenfor.