SslStream.AuthenticateAsClientAsync Yöntem

Başvuru

Tanım

Ad Alanı:: System.Net.Security

Bütünleştirilmiş Kod:: System.Net.Security.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Kaynak:: SslStream.cs

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);

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

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.

Şunlara uygulanır

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Kaynak:: SslStream.cs

Kaynak:: SslStream.cs

Kaynak:: SslStream.cs

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);

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

Not

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

Şunlara uygulanır

AuthenticateAsClientAsync(String)

Kaynak:: SslStream.cs

Kaynak:: SslStream.cs

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.

Şunlara uygulanır

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Kaynak:: SslStream.cs

Kaynak:: SslStream.cs

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);

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

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

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) 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

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.

Şunlara uygulanır

Aracılığıyla paylaş

SslStream.AuthenticateAsClientAsync Yöntem

Tanım

Aşırı Yüklemeler

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

AuthenticateAsClientAsync(String)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar