SslStream.AuthenticateAsClientAsync Metoda

Definice

Obor názvů:

System.Net.Security

Sestavení:

System.Net.Security.dll

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

Přetížení

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

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Zdroj:

SslStream.cs

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

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

Návraty

Task

Objekt úlohy představující asynchronní operaci.

Výjimky

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

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.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Zdroj:

SslStream.cs

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

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

Návraty

Task

Objekt úlohy představující asynchronní operaci.

Výjimky

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

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.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient(String, X509CertificateCollection, Boolean).

AuthenticateAsClientAsync(String)

Zdroj:

SslStream.cs

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost);

abstract member AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

Parametry

targetHost

String

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

Návraty

Task

Objekt úlohy představující asynchronní operaci.

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.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient(String).

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Zdroj:

SslStream.cs

Volali klienti k ověření serveru a volitelně klienta v připojení klient-server jako asynchronní operace. Proces ověřování používá informace zadané v kontejneru sslClientAuthenticationOptions vlastností.

public:
 System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

sslClientAuthenticationOptions

SslClientAuthenticationOptions

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

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

Task

Objekt úlohy představující asynchronní operaci.

Výjimky

ArgumentNullException

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

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

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.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient(SslClientAuthenticationOptions).