Windows Vista SP2 ve Server 2008 SP2'de .NET Framework 2.0 SP2'de bulunan TLS Sistemi Varsayılan Sürümleri için destek

Çözüm

Geliştirici Kılavuzu

Yeni uzantıların tanımı aşağıdaki dosyalarda yer almaktadır:
 

• SecurityProtocolTypeExtensions.csnamespace System.Net
  {
  System.Security.Authentication kullanma;
  genel statik sınıf 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
  {
  genel statik sınıf SslProtocolsExtensions
  {
  public const SslProtocols Tls12 = (SslProtocols)0x00000C00;
  public const SslProtocols Tls11 = (SslProtocols)0x00000300;
  }
  }

TLS v1.2 desteğini eklemek için, kaynak dosyaları projenize dahil edin ve sonra aşağıdaki yöntemleri kullanarak protokol sürümünü ayarlayın:
 

• ServicePointManager tabanlı API'leri kullanan uygulamalar, protokolü ayarlamak için aşağıdakini kullanabilir:
  
  System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolTypeExtensions.Tls12;

• SslStream AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) aşırı yükini kullanan uygulamalar SslProtocols değerini SslProtocolsExtensions.Tls12 olarak ayarlanabilir.

İlk paragrafta bahsedilen kayıt defteri ayarı ayarlanmışsa ve sslProtocols değeri de uygulamada SslProtocols.None olarak ayarlanmışsa, seçilen sistem varsayılan davranışı Windows sürümüne bağlıdır.

Ayrıca, .NET Framework 3.5 SP1 ile TLS v1.2 desteğini etkinleştirmek için uygulama kodunu değiştirmiyorsanız, bu düzeltme ekini dağıtmayacak bilgisayarlarda aşağıdaki özel durumlara karşı hazır olun:
 

1. Düzeltme yüklenmezse, uygulama Yeni değeri ayarlamak için ServicePointManager tabanlı API'ler (HTTP, FTP, SMTP) "System.NotSupportedException: İstenen güvenlik protokolü desteklenmez" hata değerini verir.

2. Düzeltme yüklenmezse, SslStream tabanlı API'ler AuthenticateAs* API'lerden birini çağıran özel durumlar oluşturur:

   System.ArgumentException: Belirtilen değer 'SslProtocolType' numaralamasinde geçerli değildir.
   Parametre adı: sslProtocolType

Not Yalnızca SslStream için, var olan TLS, Ssl3, Ssl2 ile TLS12, TLS11 birleşimi (örneğin: TLS12 | Tls11 | TLS) yama olmadan sistemde var olan protokollere (örneğin: TLS) sessizce indir indirer. Bu, tek istisnadan TLs'ye bağlanacak.
 

Ek Bilgi

TLS v1.1 veya v1.2'yi işletim sistemi varsayılanları olarak etkinleştirmek için https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.

Not TLS v1.1 ve v1.2, Windows Vista veya Windows Server 2008'de kullanılamaz.

Belirli uygulamalar için "Çözüm" bölümünde adı geçen kayıt defteri anahtarı tarafından ayarlanmış işletim sistemi varsayılanlarını devre dışı bırakmanız gerekirse, şu kayıt defteri anahtarını ekleyerek bunu yapabilirsiniz:HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions <<
Dosyanın DWORD 0
için .exe Tam yolu>> C:\MyApp\MyApp.exe DWORD 0

TLS v1.2 hakkında daha fazla bilgi için bkz . TLS v1.2 tanıtımı.

SystemDefaultTlsVersions .NET kayıt defteri anahtarını etkinleştirdikten sonra, aşağıdaki tabloda gösterildiği gibi, Windows her sürümde farklı bir davranış oluşur.