SslStream.AuthenticateAsClient Metoda

Definice

Obor názvů:

System.Net.Security

Sestavení:

netstandard.dll, System.Net.Security.dll

Ověřte stranu klienta připojení klienta-serveru.

Přetížení

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

AuthenticateAsClient(SslClientAuthenticationOptions)

Zdroj:

SslStream.cs

Ověřuje server a volitelně klienta v připojení klienta-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

sslClientAuthenticationOptions je null.

AuthenticationException

Ověření se nezdařilo a tento objekt opustil v nepoužitelném stavu.

InvalidOperationException

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

nebo

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

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). V 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 certifikátu serveru.

Pokud ověřování proběhne úspěšně, je nutné zkontrolovat IsEncrypted vlastnosti a IsSigned určit, jaké služby zabezpečení služba používá SslStream. IsMutuallyAuthenticated Zkontrolujte vlastnost a určete, jestli došlo k vzájemnému ověřování.

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

AuthenticateAsClient(String)

Zdroj:

SslStream.cs

Volali klienti pro ověření serveru a volitelně klienta v připojení klienta-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ý tento SslStreamserver sdílí .

Výjimky

ArgumentNullException

targetHost je null.

AuthenticationException

Ověření se nezdařilo a tento objekt opustil v nepoužitelném stavu.

InvalidOperationException

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

nebo

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

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). V 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 certifikátu serveru.

Pokud ověřování proběhne úspěšně, je nutné zkontrolovat IsEncrypted vlastnosti a IsSigned určit, jaké služby zabezpečení služba používá SslStream. IsMutuallyAuthenticated Zkontrolujte vlastnost a určete, jestli došlo k vzájemnému ověřování.

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

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Zdroj:

SslStream.cs

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

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 tuto SslStreamsložku sdílet .

clientCertificates

X509CertificateCollection

Obsahuje X509CertificateCollection klientské certifikáty.

checkCertificateRevocation

Boolean

Hodnota Boolean , která určuje, zda je seznam odvolaných certifikátů při ověřování kontrolován.

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 ověřování proběhne úspěšně, je nutné zkontrolovat IsEncrypted vlastnosti a IsSigned určit, jaké služby zabezpečení služba používá SslStream. IsMutuallyAuthenticated Zkontrolujte vlastnost a určete, jestli došlo k vzájemnému ověřování.

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

Poznámka:

Klientské certifikáty nejsou podporovány v protokolu SSL verze 2.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Zdroj:

SslStream.cs

Volali klienti pro ověření serveru a volitelně klienta v připojení klienta-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 tuto SslStreamsložku sdílet .

clientCertificates

X509CertificateCollection

Obsahuje X509CertificateCollection klientské certifikáty.

enabledSslProtocols

SslProtocols

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

checkCertificateRevocation

Boolean

Hodnota Boolean , která určuje, zda je seznam odvolaných certifikátů při ověřování kontrolován.

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 ověřování proběhne úspěšně, je nutné zkontrolovat IsEncrypted vlastnosti a IsSigned určit, jaké služby zabezpečení služba používá SslStream. IsMutuallyAuthenticated Zkontrolujte vlastnost a určete, jestli došlo k vzájemnému ověřování.

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

Poznámka:

Klientské certifikáty nejsou podporovány v protokolu SSL verze 2.