SslStream.AuthenticateAsClientAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 |
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- 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);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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParametry
- 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
Objekt úlohy představující asynchronní operaci.
Výjimky
Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.
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á.
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).
Platí pro
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- 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);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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As TaskParametry
- 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
Objekt úlohy představující asynchronní operaci.
Výjimky
Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.
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á.
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).
Platí pro
AuthenticateAsClientAsync(String)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- 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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String) As TaskParametry
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
targetHost je null.
Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.
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á.
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).
Platí pro
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- 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);public System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) As TaskParametry
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
Taška vlastností pro připojení SSL.
- cancellationToken
- CancellationToken
Token, který se má monitorovat pro žádosti o zrušení.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
sslClientAuthenticationOptions je null.
Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.
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á.
Tento objekt byl uzavřen.
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).
Platí pro
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro