SslStream.AuthenticateAsClientAsync Metoda

Definice

Obor názvů:

System.Net.Security

Sestavení:

netstandard.dll, System.Net.Security.dll

Ověřte stranu klienta připojení klienta-server jako asynchronní operaci.

Přetížení

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

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Zdroj:

SslStream.cs

Volali klienti pro ověření serveru a volitelně klienta v připojení klienta-server jako asynchronní operaci. 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 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.

Návraty

Task

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

Výjimky

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

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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Zdroj:

SslStream.cs

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

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

Návraty

Task

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

Výjimky

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

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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané AuthenticateAsClient(String, X509CertificateCollection, Boolean).

AuthenticateAsClientAsync(String)

Zdroj:

SslStream.cs

Volali klienti pro ověření serveru a volitelně klienta v připojení klienta-server jako asynchronní operaci.

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ý tento SslStreamserver sdílí .

Návraty

Task

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

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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané AuthenticateAsClient(String).

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Zdroj:

SslStream.cs

Volali klienti pro ověření serveru a volitelně klienta v připojení klienta-server jako asynchronní operaci. 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 pro monitorování žádostí o zrušení.

Návraty

Task

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

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.

OperationCanceledException

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

Poznámky

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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané AuthenticateAsClient(SslClientAuthenticationOptions).