SslStream.AuthenticateAsClient Metoda

Definice

Obor názvů:

System.Net.Security

Sestavení:

System.Net.Security.dll

Ověřte na straně klienta připojení klient-server.

Přetížení

AuthenticateAsClient(SslClientAuthenticationOptions)	Volali klienti k ověření serveru a volitelně klienta v připojení klient-server.
AuthenticateAsClient(String)	Volali klienti k ověření serveru a volitelně klienta v připojení klient-server.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	Volali klienti k ověření serveru a volitelně klienta v připojení klient-server. Proces ověřování používá zadanou kolekci certifikátů a výchozí systémový protokol SSL.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	Volali klienti k ověření serveru a volitelně klienta v připojení klient-server. Proces ověřování používá zadanou kolekci certifikátů a protokol SSL.

AuthenticateAsClient(SslClientAuthenticationOptions)

Zdroj:

SslStream.cs

Volali klienti k ověření serveru a volitelně klienta v připojení klient-server.

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)

Parametry

sslClientAuthenticationOptions

SslClientAuthenticationOptions

Taška vlastností pro připojení SSL.

Výjimky

ArgumentNullException

targetHost je null.

AuthenticationException

Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.

InvalidOperationException

Ověřování již proběhlo.

-nebo-

Ověření serveru pomocí tohoto SslStream ověřování bylo vyzkoušeno dříve.

-nebo-

Ověřování už probíhá.

ObjectDisposedException

Tento objekt byl uzavřen.

Poznámky

Počínaje rozhraním .NET Framework 4.7 se tato metoda ověřuje pomocí None, což operačnímu systému umožňuje zvolit nejlepší protokol, který se má použít, a blokovat protokoly, které nejsou zabezpečené. V rozhraní .NET Framework 4.6 (a .NET Framework 4.5 s nainstalovanými nejnovějšími opravami zabezpečení) jsou povolené verze protokolů TLS/SSL 1.2, 1.1 a 1.0 (pokud nezakážete silnou kryptografii úpravou registru systému Windows). Při ověřování se nepoužívají žádné klientské certifikáty. Seznam odvolaných certifikátů se během ověřování nekontroluje. Hodnota zadaná pro targetHost musí odpovídat názvu v certifikátu serveru.

Pokud je ověření úspěšné, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned a určit, které služby zabezpečení používá SslStream. Zkontrolujte vlastnost a IsMutuallyAuthenticated zjistěte, jestli nedošlo k vzájemnému ověřování.

Pokud se ověřování nezdaří, obdržíte AuthenticationExceptiona tato SslStream hodnota už není použitelná. Tento objekt byste měli zavřít a odebrat všechny odkazy na něj, aby ho mohl systém uvolňování paměti shromáždit.

AuthenticateAsClient(String)

Zdroj:

SslStream.cs

Volali klienti k ověření serveru a volitelně klienta v připojení klient-server.

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)

Parametry

targetHost

String

Název serveru, který sdílí tento SslStreamserver .

Výjimky

ArgumentNullException

targetHost je null.

AuthenticationException

Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.

InvalidOperationException

Ověřování již proběhlo.

-nebo-

Ověření serveru pomocí tohoto SslStream ověřování bylo vyzkoušeno dříve.

-nebo-

Ověřování už probíhá.

ObjectDisposedException

Tento objekt byl uzavřen.

Poznámky

Počínaje rozhraním .NET Framework 4.7 se tato metoda ověřuje pomocí None, což operačnímu systému umožňuje zvolit nejlepší protokol, který se má použít, a blokovat protokoly, které nejsou zabezpečené. V rozhraní .NET Framework 4.6 (a .NET Framework 4.5 s nainstalovanými nejnovějšími opravami zabezpečení) jsou povolené verze protokolů TLS/SSL 1.2, 1.1 a 1.0 (pokud nezakážete silnou kryptografii úpravou registru systému Windows). Při ověřování se nepoužívají žádné klientské certifikáty. Seznam odvolaných certifikátů se během ověřování nekontroluje. Hodnota zadaná pro targetHost musí odpovídat názvu v certifikátu serveru.

Pokud je ověření úspěšné, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned a určit, které služby zabezpečení používá SslStream. Zkontrolujte vlastnost a IsMutuallyAuthenticated zjistěte, jestli nedošlo k vzájemnému ověřování.

Pokud se ověřování nezdaří, obdržíte AuthenticationExceptiona tato SslStream hodnota už není použitelná. Tento objekt byste měli zavřít a odebrat všechny odkazy na něj, aby ho mohl systém uvolňování paměti shromáždit.

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Zdroj:

SslStream.cs

Volali klienti k ověření serveru a volitelně klienta v připojení klient-server. Proces ověřování používá zadanou kolekci certifikátů a výchozí systémový protokol SSL.

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)

Parametry

targetHost

String

Název serveru, který bude sdílet tento SslStreamserver .

clientCertificates

X509CertificateCollection

Obsahuje X509CertificateCollection klientské certifikáty.

checkCertificateRevocation

Boolean

Hodnota Boolean , která určuje, jestli se během ověřování kontroluje seznam odvolaných certifikátů.

Poznámky

Počínaje rozhraním .NET Framework 4.7 se tato metoda ověřuje pomocí None, což operačnímu systému umožňuje zvolit nejlepší protokol, který se má použít, a blokovat protokoly, které nejsou zabezpečené. V rozhraní .NET Framework 4.6 (a .NET Framework 4.5 s nainstalovanými nejnovějšími opravami zabezpečení) jsou povolené verze protokolů TLS/SSL 1.2, 1.1 a 1.0 (pokud nezakážete silnou kryptografii úpravou registru systému Windows).

Pokud je ověření úspěšné, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned a určit, které služby zabezpečení používá SslStream. Zkontrolujte vlastnost a IsMutuallyAuthenticated zjistěte, jestli nedošlo k vzájemnému ověřování.

Pokud se ověřování nezdaří, obdržíte AuthenticationExceptiona tato SslStream hodnota už není použitelná. Tento objekt byste měli zavřít a odebrat všechny odkazy na něj, aby ho mohl systém uvolňování paměti shromáždit.

Poznámka

Protokol SSL verze 2 nepodporuje klientské certifikáty.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Zdroj:

SslStream.cs

Volali klienti k ověření serveru a volitelně klienta v připojení klient-server. Proces ověřování používá zadanou kolekci certifikátů a protokol SSL.

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)

Parametry

targetHost

String

Název serveru, který bude sdílet tento SslStreamserver .

clientCertificates

X509CertificateCollection

Obsahuje X509CertificateCollection klientské certifikáty.

enabledSslProtocols

SslProtocols

Hodnota SslProtocols , která představuje protokoly používané pro ověřování.

checkCertificateRevocation

Boolean

Hodnota Boolean , která určuje, jestli se během ověřování kontroluje seznam odvolaných certifikátů.

Poznámky

Počínaje rozhraním .NET Framework 4.7 se tato metoda ověřuje pomocí None, což operačnímu systému umožňuje zvolit nejlepší protokol, který se má použít, a blokovat protokoly, které nejsou zabezpečené. V rozhraní .NET Framework 4.6 (a .NET Framework 4.5 s nainstalovanými nejnovějšími opravami zabezpečení) jsou povolené verze protokolů TLS/SSL 1.2, 1.1 a 1.0 (pokud nezakážete silnou kryptografii úpravou registru systému Windows).

Pokud je ověření úspěšné, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned a určit, které služby zabezpečení používá SslStream. Zkontrolujte vlastnost a IsMutuallyAuthenticated zjistěte, jestli nedošlo k vzájemnému ověřování.

Pokud se ověřování nezdaří, obdržíte AuthenticationExceptiona tato SslStream hodnota už není použitelná. Tento objekt byste měli zavřít a odebrat všechny odkazy na něj, aby ho mohl systém uvolňování paměti shromáždit.

Poznámka

Protokol SSL verze 2 nepodporuje klientské certifikáty.