Suporte para As Versões Predefinida do Sistema TLS incluídas no .NET Framework 3.5 no Windows 8.1 e Windows Server 2012 R2

Resolução

Orientação para Programadores

A definição das novas extensões está nos seguintes ficheiros:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  utilizar System.Security.Authentication;
  classe estática pública 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 estática pública SslProtocolsExtensions
  {
  massa pública SslProtocols Tls12 = (SslProtocols)0x00000C00;
  massa pública SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Para incluir o suporte para o TLS v1.2, inclua os ficheiros de origem no seu projeto e, em seguida, defina a versão do protocolo através dos seguintes métodos:
 

• As aplicações que utilizam APIs baseadas em ServicePointManager podem definir o protocolo da seguinte forma:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• As aplicações que utilizam a sobrecarga SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) podem definir o valor SslProtocols como SslProtocolsExtensions.Tls12.

Se o registo mencionado no primeiro parágrafo estiver definido e na aplicação o valor SslProtocols estiver definido como SslProtocols.None, é selecionado o comportamento predefinido do sistema que irá depender da versão do sistema operativo Windows.

Além disso, quando estiver a alterar o código da aplicação para ativar o suporte para TLS v1.2 com .NET Framework 3.5 SP1, deve certificar-se de que nos computadores onde esta patch não está implementada lida com as seguintes exceções:
 

1. Se a hotfix não estiver instalada, as APIs baseadas em ServicePointManager (HTTP, FTP, SMTP) irão ativar "System.NotSupportedException: O protocolo de segurança pedido não é suportado". quando a aplicação liga para ServicePointManager.SecurityProtocol para definir o novo valor.

2. Se a hotfix não estiver instalada, as APIs baseadas no SslStream serão atrasadas quando ligar para uma das APIs AutenticarAs*:

   System.ArgumentException: O valor especificado não é válido na enumeração "SslProtocolType".
   Nome do parâmetro: sslProtocolType

Nota Apenas para SslStream, uma combinação de Tls12, Tls11 com qualquer um dos Tls, Ssl3, Ssl2 (por exemplo: Tls12 | Tls11 | Os TLs) serão desatualizados de forma silenciosa para os protocolos existentes (por exemplo: TLs) num sistema sem a patch. A ligação será feita com TLs sem exceção.
 

Mais Informações

Para ativar o TLS v1.1 ou v1.2 como predefinições do sistema operativo, siga as instruções em https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Nota: O TLS v1.1 e o v1.2 não estão disponíveis no Windows Vista ou Windows Server 2008.

Se tiver de desativar as predefinições do sistema operativo definidas pela chave de registo mencionada anteriormente em aplicações específicas, pode fazê-lo ao adicionar a seguinte chave de registo:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions
<<Caminho completo do .exe para o ficheiro>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Para obter mais informações sobre o TLS v1.2, consulte o artigo Introdução ao TLS v1.2.

Depois de ativar a chave de registo SystemDefaultTlsVersions .NET, ocorre um comportamento diferente para cada versão do Windows, conforme apresentado na seguinte tabela.