7 SP1 및 Server 2008 R2 SP1의 .NET Framework 3.5.1 Windows TLS 시스템 기본 버전에 대한 지원

해결 방법

개발자 지침

새 확장의 정의는 다음 파일에 있습니다.
 

• SecurityProtocolTypeExtensions.csnamespace
  System.Net {
  System.Security.Authentication 사용;
  공용 정적 클래스 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
  {
  공용 정적 클래스 SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

TLS v1.2에 대한 지원을 포함하려면 프로젝트에 원본 파일을 포함한 다음 다음 메서드를 사용하여 프로토콜 버전을 설정합니다.
 

• ServicePointManager 기반 API를 사용하는 애플리케이션은 다음을 사용하여 프로토콜을 설정할 수 있습니다.
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) 오버로드를 사용하는 애플리케이션은 SslProtocolsExtensions.Tls12로 SslProtocolsExtensions.Tls12를 설정할 수 있습니다.

첫 번째 단락에 언급된 레지스트리 설정이 설정되고 SslProtocols 값이 애플리케이션에서 SslProtocols.None으로 설정되어 있는 경우 선택한 시스템 기본 동작은 Windows 버전에 따라 결정됩니다.

또한 3.5 SP1에서 TLS v1..NET Framework 2에 대한 지원을 사용하도록 애플리케이션 코드를 변경하는 경우 이 패치가 배포되지 않은 컴퓨터에서 다음 예외를 해결해야 합니다.
 

1. 핫픽스가 설치되지 않은 경우 ServicePointManager 기반 API(HTTP, FTP, SMTP)는 애플리케이션에서 ServicePointManager.SecurityProtocol을 호출하여 새 값을 설정하는 경우 "System.NotSupportedException: 요청된 보안 프로토콜이 지원되지 않습니다"를 throw합니다.

2. 핫픽스가 설치되지 않은 경우 SslStream 기반 API는 AuthenticateAs* API 중 하나를 호출할 때 예외를 throw합니다.

   System.ArgumentException: 지정된 값은 'SslProtocolType' 열방에서 유효하지 않습니다.
   매개 변수 이름: sslProtocolType

참고 SslStream만 기존 Tls, Ssl3, Ssl2와 Tls12, Tls11의 조합(예: Tls12 | Tls11 | Tls)는 패치가 없는 시스템의 기존 프로토콜(예: Tls)으로 자동으로 다운그레이드됩니다. 예외를 throw하지 않고 Tls에 연결됩니다.
 

추가 정보

TLS v1.1 또는 v1.2를 운영 체제 기본값으로 사용하도록 설정하려면 https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

참고 TLS v1.1 및 v1.2는 Vista 또는 Windows 서버 2008에서 Windows 없습니다.

특정 애플리케이션에 대한 "해결"
섹션에 언급된 레지스트리 키로 설정된 운영 체제 기본값을 사용하지 않도록 설정해야 하는 경우 DWORD 0의 파일용 HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions <<전체 경로의 .exe 추가하여 이 작업을>> 수 있습니다
. C:\MyApp\MyApp.exe DWORD 0

TLS v1.2에 대한 자세한 내용은 TLS v1.2 소개를 참조하세요.

SystemDefaultTlsVersions .NET 레지스트리 키를 사용하도록 설정한 후 다음 표에 표시된 Windows 각 버전에 대해 다른 동작이 발생합니다.