Suporte para versões padrão do sistema TLS incluídas no .NET Framework 3.5 no Windows Server 2012

Resolução

Diretrizes do desenvolvedor

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

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  usando 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
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

Para incluir o suporte para TLS v1.2, inclua os arquivos de origem em seu projeto e defina a versão do protocolo usando os seguintes métodos:
 

• Aplicativos que estão usando APIs baseadas em ServicePointManager podem definir o protocolo usando o seguinte:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• Aplicativos que estão usando a sobrecarga SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) podem definir o valor SslProtocols como SslProtocolsExtensions.Tls12.

Se a configuração do Registro mencionada no primeiro parágrafo estiver definida e o valor SslProtocols for definido no aplicativo como SslProtocols.None, o comportamento padrão do sistema escolhido dependerá da versão Windows.

Além disso, quando você alterar o código do aplicativo para habilitar o suporte para TLS v1.2 com o .NET Framework 3.5 SP1, certifique-se de abordar as seguintes exceções em computadores nos quais esse patch não está implantado:
 

1. Se o hotfix não estiver instalado, as APIs baseadas em ServicePointManager (HTTP, FTP, SMTP) lançarão "System.NotSupportedException: O protocolo de segurança solicitado não é suportado" quando o aplicativo chama ServicePointManager.SecurityProtocol para definir o novo valor.

2. Se o hotfix não estiver instalado, as APIs baseadas em SslStream lançarão exceções quando chamarem uma das APIs AuthenticateAs*:

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

Observação Somente para SslStream, uma combinação de Tls12, Tls11 com qualquer um dos Tls existentes, Ssl3, Ssl2 (por exemplo: Tls12 | Tls11 | Tls) será rebaixado silenciosamente para os protocolos existentes (por exemplo: Tls) em um sistema sem o patch. Ele se conectará a Tls sem lançar a exceção.
 

Informações adicionais

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

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

Se você tiver que desabilitar os padrões do sistema operacional definidos pela chave do Registro mencionada na seção "Resolução" para aplicativos específicos, você poderá fazer isso adicionando a
seguinte chave de registro:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions <<Caminho completo do .exe para o arquivo>> DWORD 0
C:\MyApp\MyApp.exe DWORD 0

Para obter mais informações sobre o TLS v1.2, consulte Apresentando o TLS v1.2.

Depois de habilitar a chave de registro SystemDefaultTlsVersions .NET, ocorrerá um comportamento diferente para cada versão do Windows, conforme mostrado na tabela a seguir.