SslStream.AuthenticateAsClientAsync Yöntem

Tanım

Ad Alanı:

System.Net.Security

Bütünleştirilmiş Kodlar:

netstandard.dll, 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

Name	Description
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 protokolunu 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 denetlenmediğ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 oluştu.

-veya-

Bunu SslStream kullanan sunucu kimlik doğrulaması daha önce denenmişti.

-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 kimlik doğrulaması Noneyapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme eklerinin yüklü olduğu .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ı yapılıp IsMutuallyAuthenticated yapılmadığını 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 çöp toplayıcısı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Uyarı

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

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)oluşan ö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 protokolunu 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 denetlenmediğ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 oluştu.

-veya-

Bunu SslStream kullanan sunucu kimlik doğrulaması daha önce denenmişti.

-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 kimlik doğrulaması Noneyapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme eklerinin yüklü olduğu .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ı yapılıp IsMutuallyAuthenticated yapılmadığını 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 çöp toplayıcısı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Uyarı

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

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından AuthenticateAsClient(String, X509CertificateCollection, Boolean)oluşan ö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'e eşittir.

AuthenticationException

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

InvalidOperationException

Kimlik doğrulaması zaten oluştu.

-veya-

Bunu SslStream kullanan sunucu kimlik doğrulaması daha önce denenmişti.

-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 kimlik doğrulaması Noneyapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme eklerinin yüklü olduğu .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. Sertifika iptal listesi kimlik doğrulaması sırasında denetlenmiyor. için targetHost belirtilen değerin sunucu 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ı yapılıp IsMutuallyAuthenticated yapılmadığını 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 çöp toplayıcısı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından AuthenticateAsClient(String)oluşan ö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'e eşittir.

AuthenticationException

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

InvalidOperationException

Kimlik doğrulaması zaten oluştu.

-veya-

Bunu SslStream kullanan sunucu kimlik doğrulaması daha önce denenmişti.

-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ı yapılıp IsMutuallyAuthenticated yapılmadığını 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 çöp toplayıcısı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından AuthenticateAsClient(SslClientAuthenticationOptions)oluşan özel durumlara bakın.