Supporto per le versioni predefinite del sistema TLS incluse in .NET Framework 2.0 SP2 in Windows Vista SP2 e Server 2008 SP2

Risoluzione

Guida per gli sviluppatori

La definizione delle nuove estensioni è nei file seguenti:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  utilizzo di System.Security.Authentication;
  classe statica pubblica 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
  {
  Classe statica pubblica SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Per includere il supporto per TLS v1.2, includere i file di origine nel progetto e quindi impostare la versione del protocollo usando i metodi seguenti:
 

• Le applicazioni che usano API basate su ServicePointManager possono impostare il protocollo usando quanto segue:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Le applicazioni che usano l'overload SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) possono impostare il valore SslProtocols come SslProtocolsExtensions.Tls12.

Se l'impostazione del Registro di sistema menzionata nel primo paragrafo è impostata e il valore SslProtocols nell'applicazione è impostato su SslProtocols.None, il comportamento predefinito del sistema scelto dipenderà dalla versione Windows.

Inoltre, quando si modifica il codice dell'applicazione per abilitare il supporto per TLS v1.2 con .NET Framework 3.5 SP1, assicurarsi di risolvere le eccezioni seguenti nei computer in cui la patch non è distribuita:
 

1. Se l'aggiornamento rapido non è installato, le API basate su ServicePointManager (HTTP, FTP, SMTP) genereranno "System.NotSupportedException: Il protocollo di sicurezza richiesto non è supportato" quando l'applicazione chiama ServicePointManager.SecurityProtocol per impostare il nuovo valore.

2. Se l'aggiornamento rapido non è installato, le API basate su SslStream genereranno eccezioni quando chiamano una delle API AuthenticateAs*:

   System.ArgumentException: il valore specificato non è valido nell'enumerazione 'SslProtocolType'.
   Nome parametro: sslProtocolType

Nota Solo per SslStream, una combinazione di Tls12, Tls11 e uno qualsiasi degli attuali Tls, Ssl3, Ssl2 (ad esempio: Tls12 | Tls11 | Tls) verrà automaticamente declassato ai protocolli esistenti (ad esempio: Tls) in un sistema senza patch. Si connetterà a Tls senza generare l'eccezione.
 

Ulteriori informazioni

Per abilitare TLS v1.1 o v1.2 come impostazioni predefinite del sistema operativo, seguire le istruzioni in https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Nota Tls v1.1 e v1.2 non sono disponibili in Windows Vista o Windows Server 2008.

Se è necessario disabilitare le impostazioni predefinite del sistema operativo impostate dalla chiave del Registro di sistema menzionata nella sezione "Risoluzione" per applicazioni specifiche, è possibile farlo aggiungendo la chiave del Registro di sistema seguente:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Percorso completo del .exe per il file>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Per altre informazioni su TLS v1.2, vedere Introduzione a TLS v1.2.

Dopo aver abilitato la chiave del Registro di sistema SystemDefaultTlsVersions .NET, si verifica un comportamento diverso per ogni versione di Windows, come illustrato nella tabella seguente.