Stöd för TLS-systemets standardversioner som ingår i .NET Framework 3.5 på Windows Server 2012

Lösning

Utvecklarvägledning

Definitionen av de nya tilläggen finns i följande filer:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  använda System.Security.Authentication;
  offentlig statisk klass 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
  {
  offentlig statisk klass SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Om du vill inkludera stöd för TLS v1.2 tar du med källfilerna i projektet och anger sedan protokollversionen med hjälp av följande metoder:
 

• Program som använder ServicePointManager-baserade API:er kan ange protokollet med hjälp av följande:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Program som använder sslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) kan ange värdet sslProtocols som SslProtocolsExtensions.Tls12.

Om registerinställningen som nämns i det första stycket har angetts och värdet SslProtocols anges som SslProtocols.None i programmet beror det valda systemstandardbeteendet på den Windows versionen.

När du ändrar programkoden för att aktivera stöd för TLS v1.2 med .NET Framework 3.5 SP1 bör du även se till att åtgärda följande undantag på datorer där korrigeringen inte har distribuerats:
 

1. Om snabbkorrigeringen inte är installerad returnerar ServicePointManager-baserade API:er (HTTP, FTP, SMTP) "System.NotSupportedException: Det begärda säkerhetsprotokoll stöds inte" när programmet anropar ServicePointManager.SecurityProtocol för att ange det nya värdet.

2. Om snabbkorrigeringen inte är installerad, ger SSLStream-baserade API:er undantag när de anropar någon av API:erna för AuthenticateAs*:

   System.ArgumentException: Det angivna värdet är inte giltigt i uppräkningen "SslProtocolType".
   Parameternamn: sslProtocolType

Obs! Endast för SslStream, en kombination av Tls12, Tls11 och någon av de befintliga Tlserna, Ssl3, Ssl2 (till exempel: Tls12 | Tls11-| Tls) nedgraderar tyst till befintliga protokoll (till exempel TLS) på ett system utan korrigeringen. Den ansluter till Tls utan undantag.
 

Mer information

Om du vill aktivera TLS v1.1 eller v1.2 som standard operativsystem följer du anvisningarna i https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Obs! TLS v1.1 och v1.2 är inte tillgängliga i Windows Vista eller Windows Server 2008.

Om du måste inaktivera standardinställningarna för operativsystemet som anges av registernyckeln som nämns i avsnittet "Upplösning" för specifika program kan du göra det genom att lägga till följande registernyckel:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Fullständig sökväg till .exe för filen>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Mer information om TLS v1.2 finns i Introduktion till TLS v1.2.

När du har aktiverar registernyckeln SystemDefaultTlsVersions .NET, uppstår ett annat beteende för varje version av Windows, som visas i följande tabell.