SslStream.AuthenticateAsClientAsync Yöntem

Tanım

Ad Alanı:

System.Net.Security

Bütünleştirilmiş Kod:

System.Net.Security.dll

Zaman uyumsuz bir işlem olarak istemci-sunucu bağlantısının istemci tarafında kimlik doğrulaması yapın.

Aşırı Yüklemeler

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için çağrılır. Kimlik doğrulama işlemi, belirtilen sertifika koleksiyonunu ve SSL protokollerini kullanır.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için çağrılır. Kimlik doğrulama işlemi, belirtilen sertifika koleksiyonunu ve sistem varsayılan SSL protokollerini kullanır.
AuthenticateAsClientAsync(String)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için çağrılır.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için çağrılır. Kimlik doğrulama işlemi, özellik paketinde sslClientAuthenticationOptions belirtilen bilgileri kullanır.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Kaynak:

SslStream.cs

İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için çağrılır. Kimlik doğrulama işlemi, belirtilen sertifika koleksiyonunu ve SSL protokollerini kullanır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Parametreler

targetHost

String

Bunu SslStreampaylaşacak sunucunun adı.

clientCertificates

X509CertificateCollection

X509CertificateCollection İstemci sertifikalarını içeren.

enabledSslProtocols

SslProtocols

SslProtocols Kimlik doğrulaması için kullanılan protokolleri temsil eden değer.

checkCertificateRevocation

Boolean

Boolean Kimlik doğrulaması sırasında sertifika iptal listesinin denetlenip denetlenmeyeceğini belirten bir değer.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan sunucu kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

Açıklamalar

.NET Framework 4.7'den başlayarak, bu yöntem işletim sisteminin kullanılacak en iyi protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak Nonekimlik doğrulaması yapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme ekleri yüklü .NET Framework 4.5'te), izin verilen TLS/SSL protokol sürümleri 1.2, 1.1 ve 1.0'dır (Windows Kayıt Defteri'ni düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız sürece).

Kimlik doğrulaması başarılı olduğunda, tarafından hangi güvenlik hizmetlerinin IsEncrypted kullanıldığını SslStreambelirlemek için ve IsSigned özelliklerini denetlemeniz gerekir. Karşılıklı kimlik doğrulamasının IsMutuallyAuthenticated gerçekleşip gerçekleşmediğini belirlemek için özelliğini denetleyin.

Kimlik doğrulaması başarısız olursa, bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve atık toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Not

İstemci sertifikaları SSL sürüm 2 protokolünde desteklenmez.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)özel durumlara bakın.

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Kaynak:

SslStream.cs

İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için çağrılır. Kimlik doğrulama işlemi, belirtilen sertifika koleksiyonunu ve sistem varsayılan SSL protokollerini kullanır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

Parametreler

targetHost

String

Bunu SslStreampaylaşacak sunucunun adı.

clientCertificates

X509CertificateCollection

X509CertificateCollection İstemci sertifikalarını içeren.

checkCertificateRevocation

Boolean

Boolean Kimlik doğrulaması sırasında sertifika iptal listesinin denetlenip denetlenmeyeceğini belirten bir değer.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan sunucu kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

Açıklamalar

.NET Framework 4.7'den başlayarak, bu yöntem işletim sisteminin kullanılacak en iyi protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak Nonekimlik doğrulaması yapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme ekleri yüklü .NET Framework 4.5'te), izin verilen TLS/SSL protokol sürümleri 1.2, 1.1 ve 1.0'dır (Windows Kayıt Defteri'ni düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız sürece).

Kimlik doğrulaması başarılı olduğunda, tarafından hangi güvenlik hizmetlerinin IsEncrypted kullanıldığını SslStreambelirlemek için ve IsSigned özelliklerini denetlemeniz gerekir. Karşılıklı kimlik doğrulamasının IsMutuallyAuthenticated gerçekleşip gerçekleşmediğini belirlemek için özelliğini denetleyin.

Kimlik doğrulaması başarısız olursa, bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve atık toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Not

İstemci sertifikaları SSL sürüm 2 protokolünde desteklenmez.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan AuthenticateAsClient(String, X509CertificateCollection, Boolean)özel durumlara bakın.

AuthenticateAsClientAsync(String)

Kaynak:

SslStream.cs

İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için çağrılır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost);

abstract member AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

Parametreler

targetHost

String

Bunu SslStreampaylaşan sunucunun adı.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

targetHost, null değeridir.

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan sunucu kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

Açıklamalar

.NET Framework 4.7'den başlayarak, bu yöntem işletim sisteminin kullanılacak en iyi protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak Nonekimlik doğrulaması yapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme ekleri yüklü .NET Framework 4.5'te), izin verilen TLS/SSL protokol sürümleri 1.2, 1.1 ve 1.0'dır (Windows Kayıt Defteri'ni düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız sürece). Kimlik doğrulamasında hiçbir istemci sertifikası kullanılmaz. Kimlik doğrulaması sırasında sertifika iptal listesi denetlenmiyor. için targetHost belirtilen değerin sunucunun sertifikasındaki adla eşleşmesi gerekir.

Kimlik doğrulaması başarılı olduğunda, tarafından hangi güvenlik hizmetlerinin IsEncrypted kullanıldığını SslStreambelirlemek için ve IsSigned özelliklerini denetlemeniz gerekir. Karşılıklı kimlik doğrulamasının IsMutuallyAuthenticated gerçekleşip gerçekleşmediğini belirlemek için özelliğini denetleyin.

Kimlik doğrulaması başarısız olursa, bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve atık toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan AuthenticateAsClient(String)özel durumlara bakın.

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Kaynak:

SslStream.cs

İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için çağrılır. Kimlik doğrulama işlemi, özellik paketinde sslClientAuthenticationOptions belirtilen bilgileri kullanır.

public:
 System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sslClientAuthenticationOptions

SslClientAuthenticationOptions

SSL bağlantısı için özellik paketi.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

sslClientAuthenticationOptions, null değeridir.

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan sunucu kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Kimlik doğrulaması başarılı olduğunda, tarafından hangi güvenlik hizmetlerinin IsEncrypted kullanıldığını SslStreambelirlemek için ve IsSigned özelliklerini denetlemeniz gerekir. Karşılıklı kimlik doğrulamasının IsMutuallyAuthenticated gerçekleşip gerçekleşmediğini belirlemek için özelliğini denetleyin.

Kimlik doğrulaması başarısız olursa, bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve atık toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan AuthenticateAsClient(SslClientAuthenticationOptions)özel durumlara bakın.