SslStream.AuthenticateAsClient Yöntem

Tanım

Ad Alanı:

System.Net.Security

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Security.dll

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

Aşırı Yüklemeler

Name	Description
AuthenticateAsClient(SslClientAuthenticationOptions)	Sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısında istemcinin kimliğini doğrular.
AuthenticateAsClient(String)	İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki 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ındaki 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ındaki 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)

Kaynak:

SslStream.cs

Sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısında istemcinin kimliğini doğrular.

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

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ı.

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.

AuthenticateAsClient(String)

Kaynak:

SslStream.cs

İstemciler tarafından sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki 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'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.

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

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 denetlenmediğini belirten bir değer.

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.

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

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 denetlenmediğini belirten bir değer.

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.