SslStream.AuthenticateAsClient Metódus

Definíció

Névtér:

System.Net.Security

Szerelvény:

System.dll

Hitelesítse az ügyfél-kiszolgáló kapcsolat ügyféloldalát.

Túlterhelések

Name	Description
AuthenticateAsClient(String)	Az ügyfelek a kiszolgáló és opcionálisan az ügyfél-kiszolgáló kapcsolat hitelesítésére kérik.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	Az ügyfelek a kiszolgáló és opcionálisan az ügyfél-kiszolgáló kapcsolat hitelesítésére kérik. A hitelesítési folyamat a megadott tanúsítványgyűjteményt és a rendszer alapértelmezett SSL protokollját használja.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	Az ügyfelek a kiszolgáló és opcionálisan az ügyfél-kiszolgáló kapcsolat hitelesítésére kérik. A hitelesítési folyamat a megadott tanúsítványgyűjteményt és SSL-protokollt használja.

AuthenticateAsClient(String)

Az ügyfelek a kiszolgáló és opcionálisan az ügyfél-kiszolgáló kapcsolat hitelesítésére kérik.

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)

Paraméterek

targetHost

String

Az ezt SslStreammegosztó kiszolgáló neve.

Kivételek

ArgumentNullException

targetHost az null.

AuthenticationException

A hitelesítés sikertelen volt, és ezt az objektumot használhatatlan állapotban hagyta.

InvalidOperationException

A hitelesítés már megtörtént.

-vagy-

Az ezzel SslStream a kiszolgálóhitelesítéssel korábban próbálkoztak.

-vagy-

A hitelesítés már folyamatban van.

ObjectDisposedException

Ezt az objektumot bezárták.

Megjegyzések

A .NET Framework 4.7-től kezdve ez a módszer a None használatával hitelesít, így az operációs rendszer kiválaszthatja a legjobban használható protokollt, és letilthatja a nem biztonságos protokollokat. A .NET Framework 4.6 -ban (és .NET Framework 4.5-ben a legújabb biztonsági javítások telepítve vannak), az engedélyezett TLS/SSL protokollok verziója az 1.2, 1.1 és 1.0 (hacsak nem tiltja le az erős titkosítást a Windows beállításjegyzékének szerkesztésével). A hitelesítés nem használ ügyféltanúsítványokat. A rendszer nem ellenőrzi a visszavont tanúsítványok listáját a hitelesítés során. A megadott értéknek targetHost meg kell egyeznie a kiszolgáló tanúsítványában szereplő névvel.

Ha a hitelesítés sikeres, ellenőriznie kell a IsEncrypted tulajdonságokat, és IsSigned meg kell állapítania, hogy a rendszer milyen biztonsági szolgáltatásokat használ SslStream. Ellenőrizze a IsMutuallyAuthenticated tulajdonságot annak megállapításához, hogy történt-e kölcsönös hitelesítés.

Ha a hitelesítés sikertelen, kap egy AuthenticationException, és ez SslStream már nem használható. Zárja be ezt az objektumot, és távolítsa el az összes rá mutató hivatkozást, hogy a szemétgyűjtő összegyűjthesse.

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Az ügyfelek a kiszolgáló és opcionálisan az ügyfél-kiszolgáló kapcsolat hitelesítésére kérik. A hitelesítési folyamat a megadott tanúsítványgyűjteményt és a rendszer alapértelmezett SSL protokollját használja.

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)

Paraméterek

targetHost

String

Az ezt SslStreammegosztó kiszolgáló neve.

clientCertificates

X509CertificateCollection

Az X509CertificateCollection ügyféltanúsítványokat tartalmazó.

checkCertificateRevocation

Boolean

Egy Boolean érték, amely meghatározza, hogy a rendszer ellenőrzi-e a visszavont tanúsítványok listáját a hitelesítés során.

Megjegyzések

A .NET Framework 4.7-től kezdve ez a módszer a None használatával hitelesít, így az operációs rendszer kiválaszthatja a legjobban használható protokollt, és letilthatja a nem biztonságos protokollokat. A .NET Framework 4.6 -ban (és .NET Framework 4.5-ben a legújabb biztonsági javítások telepítve vannak), az engedélyezett TLS/SSL protokollok verziója az 1.2, 1.1 és 1.0 (hacsak nem tiltja le az erős titkosítást a Windows beállításjegyzékének szerkesztésével).

Ha a hitelesítés sikeres, ellenőriznie kell a IsEncrypted tulajdonságokat, és IsSigned meg kell állapítania, hogy a rendszer milyen biztonsági szolgáltatásokat használ SslStream. Ellenőrizze a IsMutuallyAuthenticated tulajdonságot annak megállapításához, hogy történt-e kölcsönös hitelesítés.

Ha a hitelesítés sikertelen, kap egy AuthenticationException, és ez SslStream már nem használható. Zárja be ezt az objektumot, és távolítsa el az összes rá mutató hivatkozást, hogy a szemétgyűjtő összegyűjthesse.

Note

Az SSL 2-es verziójának protokollja nem támogatja az ügyféltanúsítványokat.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Az ügyfelek a kiszolgáló és opcionálisan az ügyfél-kiszolgáló kapcsolat hitelesítésére kérik. A hitelesítési folyamat a megadott tanúsítványgyűjteményt és SSL-protokollt használja.

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)

Paraméterek

targetHost

String

Az ezt SslStreammegosztó kiszolgáló neve.

clientCertificates

X509CertificateCollection

Az X509CertificateCollection ügyféltanúsítványokat tartalmazó.

enabledSslProtocols

SslProtocols

A SslProtocols hitelesítéshez használt protokollokat képviselő érték.

checkCertificateRevocation

Boolean

Egy Boolean érték, amely meghatározza, hogy a rendszer ellenőrzi-e a visszavont tanúsítványok listáját a hitelesítés során.

Megjegyzések

A .NET Framework 4.7-től kezdve ez a módszer a None használatával hitelesít, így az operációs rendszer kiválaszthatja a legjobban használható protokollt, és letilthatja a nem biztonságos protokollokat. A .NET Framework 4.6 -ban (és .NET Framework 4.5-ben a legújabb biztonsági javítások telepítve vannak), az engedélyezett TLS/SSL protokollok verziója az 1.2, 1.1 és 1.0 (hacsak nem tiltja le az erős titkosítást a Windows beállításjegyzékének szerkesztésével).

Ha a hitelesítés sikeres, ellenőriznie kell a IsEncrypted tulajdonságokat, és IsSigned meg kell állapítania, hogy a rendszer milyen biztonsági szolgáltatásokat használ SslStream. Ellenőrizze a IsMutuallyAuthenticated tulajdonságot annak megállapításához, hogy történt-e kölcsönös hitelesítés.

Ha a hitelesítés sikertelen, kap egy AuthenticationException, és ez SslStream már nem használható. Zárja be ezt az objektumot, és távolítsa el az összes rá mutató hivatkozást, hogy a szemétgyűjtő összegyűjthesse.

Note

Az SSL 2-es verziójának protokollja nem támogatja az ügyféltanúsítványokat.