SslStream.AuthenticateAsClient Yöntem

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

İstemci-sunucu bağlantısının istemci tarafında kimlik doğrulaması.

Aşırı Yüklemeler

AuthenticateAsClient(SslClientAuthenticationOptions)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısında istemcinin kimliğini doğrulamak için çağrılır.
AuthenticateAsClient(String)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısında istemcinin kimliğini doğrulamak için çağrılır.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısında istemcinin kimliğini doğrulamak için çağrılır. Kimlik doğrulama işlemi, belirtilen sertifika koleksiyonunu ve sistem varsayılan SSL protokollerini kullanır.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısında istemcinin kimliğini doğrulamak için çağrılır. Kimlik doğrulama işlemi, belirtilen sertifika koleksiyonunu ve SSL protokollerini kullanır.

AuthenticateAsClient(SslClientAuthenticationOptions)

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

public:
 void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);

public void AuthenticateAsClient (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);

member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unit

Public Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)

Parametreler

sslClientAuthenticationOptions

SslClientAuthenticationOptions

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

Ö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 itibaren, bu yöntem, None işletim sisteminin kullanılacak en iyi Protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak kimliğini doğrular. .NET Framework 4,6 ' de (ve en son güvenlik düzeltme eklerinin yüklü olduğu .NET Framework 4,5), izin verilen TLS/SSL protokolleri sürümleri 1,2, 1,1 ve 1,0 (Windows kayıt defterini düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız müddetçe). 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 sunucu sertifikasındaki adla eşleşmesi gerekir.

Kimlik doğrulaması başarılı olduğunda, tarafından SslStreamhangi güvenlik hizmetlerinin IsEncrypted kullanıldığını belirlemek 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 çöp toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

AuthenticateAsClient(String)

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

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost);

public virtual void AuthenticateAsClient (string targetHost);

abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String)

Parametreler

targetHost

String

Bunu SslStreampaylaşan sunucunun adı.

Ö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 itibaren, bu yöntem, None işletim sisteminin kullanılacak en iyi Protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak kimliğini doğrular. .NET Framework 4,6 ' de (ve en son güvenlik düzeltme eklerinin yüklü olduğu .NET Framework 4,5), izin verilen TLS/SSL protokolleri sürümleri 1,2, 1,1 ve 1,0 (Windows kayıt defterini düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız müddetçe). 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 sunucu sertifikasındaki adla eşleşmesi gerekir.

Kimlik doğrulaması başarılı olduğunda, tarafından SslStreamhangi güvenlik hizmetlerinin IsEncrypted kullanıldığını belirlemek 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 çöp toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısında istemcinin kimliğini 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 void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)

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.

Açıklamalar

.NET Framework 4,7 ' den itibaren, bu yöntem, None işletim sisteminin kullanılacak en iyi Protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak kimliğini doğrular. .NET Framework 4,6 ' de (ve en son güvenlik düzeltme eklerinin yüklü olduğu .NET Framework 4,5), izin verilen TLS/SSL protokolleri sürümleri 1,2, 1,1 ve 1,0 (Windows kayıt defterini düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız müddetçe).

Kimlik doğrulaması başarılı olduğunda, tarafından SslStreamhangi güvenlik hizmetlerinin IsEncrypted kullanıldığını belirlemek 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 çöp 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.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

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

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

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.

Açıklamalar

.NET Framework 4,7 ' den itibaren, bu yöntem, None işletim sisteminin kullanılacak en iyi Protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak kimliğini doğrular. .NET Framework 4,6 ' de (ve en son güvenlik düzeltme eklerinin yüklü olduğu .NET Framework 4,5), izin verilen TLS/SSL protokolleri sürümleri 1,2, 1,1 ve 1,0 (Windows kayıt defterini düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız müddetçe).

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.