Supporto per le versioni predefinite del sistema TLS incluse in .NET Framework 3.5 in Windows 8.1 e Windows Server 2012 R2

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 nel modo seguente:
  
  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 il Registro di sistema menzionato nel primo paragrafo è impostato e nell'applicazione il valore SslProtocols è impostato su SslProtocols.None, viene scelto il comportamento predefinito del sistema che dipenderà dalla versione del sistema operativo Windows.

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

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 generano un'eccezione quando si chiama 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 in precedenza per applicazioni specifiche, è possibile aggiungerla 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.