SslStream.AuthenticateAsServerAsync 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í.
Volá se servery k ověření serveru a volitelně klienta v připojení klient-server jako asynchronní operace.
Přetížení
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Volali servery k ověření serveru a volitelně klienta v připojení klient-server pomocí zadaných certifikátů, požadavků a protokolu zabezpečení jako asynchronní operace. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Volali servery k ověření serveru a volitelně klienta v připojení klient-server pomocí zadaných certifikátů, požadavků a protokolu zabezpečení jako asynchronní operace. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Volá se servery 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 |
| AuthenticateAsServerAsync(X509Certificate) |
Volali servery k ověření serveru a volitelně klienta v připojení klient-server pomocí zadaného certifikátu jako asynchronní operace. |
| AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken) |
Volá se servery k ověření serveru a volitelně klienta v připojení klient-server jako asynchronní operace. Proces ověřování používá informace vrácené nástrojem |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
Volali servery k ověření serveru a volitelně klienta v připojení klient-server pomocí zadaných certifikátů, požadavků a protokolu zabezpečení jako asynchronní operace.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParametry
- serverCertificate
- X509Certificate
X509Certificate použitý k ověření serveru.
- clientCertificateRequired
- Boolean
Hodnota Boolean , která určuje, jestli je klient požádán o certifikát pro ověřování. Všimněte si, že se jedná pouze o požadavek – pokud není poskytnut žádný certifikát, server stále přijímá žádost o připojení.
- 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
serverCertificate 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ěřování klienta s tímto SslStream použitím 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 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 AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Platí pro
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
Volali servery k ověření serveru a volitelně klienta v připojení klient-server pomocí zadaných certifikátů, požadavků a protokolu zabezpečení jako asynchronní operace.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As TaskParametry
- serverCertificate
- X509Certificate
X509Certificate použitý k ověření serveru.
- clientCertificateRequired
- Boolean
Hodnota Boolean , která určuje, jestli je klient požádán o certifikát pro ověřování. Všimněte si, že se jedná pouze o požadavek – pokud není poskytnut žádný certifikát, server stále přijímá žádost o připojení.
- 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
serverCertificate 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ěřování klienta s tímto SslStream použitím 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 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 AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Platí pro
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
Volá se servery 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 ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParametry
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
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
Buď ServerCertificateSelectionCallback nebo ServerCertificate nebo ServerCertificateContext je null a LocalCertificateSelectionCallback není nastaven v konstruktoru SslStream .
sslServerAuthenticationOptions 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ěřování klienta s tímto SslStream použitím 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 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 AuthenticateAsServer(SslServerAuthenticationOptions).
Platí pro
AuthenticateAsServerAsync(X509Certificate)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
Volali servery k ověření serveru a volitelně klienta v připojení klient-server pomocí zadaného certifikátu jako asynchronní operace.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As TaskParametry
- serverCertificate
- X509Certificate
Certifikát použitý k ověření serveru.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
serverCertificate 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ěřování klienta s tímto SslStream použitím bylo vyzkoušeno dříve.
-nebo-
Ověřování už probíhá.
Tento objekt byl uzavřen.
Metoda AuthenticateAsServerAsync není podporována ve Windows 95, Windows 98 ani Windows Millennium.
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).
Tato metoda se ověřuje pomocí .Default Seznam odvolaných certifikátů se během ověřování nekontroluje. Klient nemusí poskytovat certifikát pro 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 AuthenticateAsServer(X509Certificate).
Platí pro
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
- Zdroj:
- SslStream.cs
Volá se servery k ověření serveru a volitelně klienta v připojení klient-server jako asynchronní operace. Proces ověřování používá informace vrácené nástrojem optionsCallback.
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- optionsCallback
- ServerOptionsSelectionCallback
Delegát zpětného volání.
- state
- Object
Objekt stavu, do optionsCallback který se má předat při vyvolání zpětného volání.
- cancellationToken
- CancellationToken
Token, který se má monitorovat pro žádosti o zrušení.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Buď ServerCertificateSelectionCallback nebo ServerCertificate nebo ServerCertificateContext je null a LocalCertificateSelectionCallback není nastaven v konstruktoru SslStream .
Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.
Ověřování již proběhlo.
-nebo-
Ověřování klienta s tímto SslStream použitím 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 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.
