Stöd för TLS System standard versioner i.NET Framework 2.0 SP2 på Windows Vista SP2 och Server 2008 SP2

Lösning

Vägledning för utvecklare

Definitionen av nya tillägg finns i följande 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;}}

Om du vill inkludera stöd för TLS v1.2 innehåller källfilerna i projektet och ange protocol version med hjälp av följande metoder:

• Program som använder ServicePointManager-baserade API: er anger protokollet genom att använda following:System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Program som använder SslStream AuthenticateAsClient (sträng, X509CertificateCollection, SslProtocols, Boolean) överbelastning kan ange värdet för SslProtocols som SslProtocolsExtensions.Tls12.

Om registerinställningen som nämns i första stycket anges, och värdet för SslProtocols anges i program som SslProtocols.None, beror standardbeteendet för system som väljs på vilken Windows-version. Även när du ändrar programkod för att aktivera stöd för TLS v1.2 med.NET Framework 3.5 SP1, bör du du adresserar på datorer där den här korrigeringsfilen inte distribueras följande undantag:

1. Om snabbkorrigeringen inte är installerad, ServicePointManager-baserat API: er (HTTP, FTP, SMTP) kommer kasta ”System.NotSupportedException: det begärda säkerhetsprotokollet stöds inte” när programmet anropar ServicePointManager.SecurityProtocol att ange det nya värdet.

2. Om snabbkorrigeringen inte är installerad, SslStream-baserat API-gränssnitt kommer kasta undantag när de ringer antingen AuthenticateAs * API:

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

Obs! För SslStream , en kombination av Tls12, Tls11 med någon av de befintliga Tls, Ssl3Ssl2 (till exempel: Tls12 | Tls11 | TLS) utan att nedgradera till befintliga protokoll (till exempel: Tls) på ett system utan korrigeringsfilen. Den ansluter till Tls utan att undantaget.

Mer information

Om du vill aktivera TLS v1.1 och v1.2 som standard i operativsystemet, följ instruktionerna på https://technet.microsoft.com/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.If du måste inaktivera operativsystemet standardvärdena som anges av registernyckeln som nämns i avsnittet ”lösning” för vissa program kan du göra detta genom att lägga till den följande registernyckel:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions<<Full path of the .exe for the file>> DWORD 0C:\MyApp\MyApp.exe DWORD 0

Mer information om TLS v1.2 finns i Introduktion till TLS v1.2. När du aktiverar registernyckeln SystemDefaultTlsVersions .NET inträffar en annan för varje version av Windows, som visas i följande tabell.