SslStream.AuthenticateAsServerAsync Metoda

Definice

Obor názvů:

System.Net.Security

Sestavení:

netstandard.dll, System.Net.Security.dll

Volal servery pro ověření serveru a volitelně klienta v připojení klient-server jako asynchronní operace.

Přetížení

Name	Description
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)	Volal servery pro 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)	Volal servery pro 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(ServerOptionsSelectionCallback, Object, CancellationToken)	Volal servery pro ověření serveru a volitelně klienta v připojení klient-server jako asynchronní operace. Proces ověřování používá informace vrácené metodou optionsCallback.
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)	Ověří server a volitelně klienta v připojení klienta-server jako asynchronní operaci. Proces ověřování používá informace zadané v kontejneru sslServerAuthenticationOptions vlastností.
AuthenticateAsServerAsync(X509Certificate)	Volali servery pro ověření serveru a volitelně klienta v připojení klient-server pomocí zadaného certifikátu jako asynchronní operace.

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

Zdroj:

SslStream.cs

Volal servery pro 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.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Parametry

serverCertificate

X509Certificate

Certifikát X509Certificate použitý k ověření serveru.

clientCertificateRequired

Boolean

Hodnota Boolean , která určuje, jestli je klient požádán o ověření certifikátu. Upozorňujeme, že se jedná pouze o požadavek – pokud není k dispozici žádný certifikát, server stále přijímá žádost o připojení.

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

ArgumentNullException

serverCertificate 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í klienta 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 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é AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

Zdroj:

SslStream.cs

Volal servery pro 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.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

Parametry

serverCertificate

X509Certificate

Certifikát X509Certificate použitý k ověření serveru.

clientCertificateRequired

Boolean

Hodnota Boolean , která určuje, jestli je klient požádán o ověření certifikátu. Upozorňujeme, že se jedná pouze o požadavek – pokud není k dispozici žádný certifikát, server stále přijímá žádost o připojení.

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

ArgumentNullException

serverCertificate 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í klienta 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 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é AuthenticateAsServer(X509Certificate, Boolean, Boolean).

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

Zdroj:

SslStream.cs

Volal servery pro ověření serveru a volitelně klienta v připojení klient-server jako asynchronní operace. Proces ověřování používá informace vrácené metodou 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.Task

Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

optionsCallback

ServerOptionsSelectionCallback

Delegát zpětného volání.

state

Object

Stavový objekt, který optionsCallback se má předat při vyvolání zpětného volání.

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení.

Návraty

Task

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

Výjimky

ArgumentNullException

Buď ServerCertificateSelectionCallback nebo ServerCertificate je ServerCertificateContextnull a LocalCertificateSelectionCallback není nastaven v konstruktoru SslStream .

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

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

Zdroj:

SslStream.cs

Ověří server a volitelně klienta v připojení klienta-server jako asynchronní operaci. Proces ověřování používá informace zadané v kontejneru sslServerAuthenticationOptions 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);

member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

sslServerAuthenticationOptions

SslServerAuthenticationOptions

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

Buď ServerCertificateSelectionCallback nebo ServerCertificate je ServerCertificateContextnull a LocalCertificateSelectionCallback není nastaven v konstruktoru SslStream .

ArgumentNullException

sslServerAuthenticationOptions 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í klienta 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 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é AuthenticateAsServer(SslServerAuthenticationOptions).

AuthenticateAsServerAsync(X509Certificate)

Zdroj:

SslStream.cs

Volali servery pro 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.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

Parametry

serverCertificate

X509Certificate

Certifikát použitý k ověření serveru.

Návraty

Task

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

Výjimky

ArgumentNullException

serverCertificate 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í klienta pomocí tohoto SslStream pokusu bylo dříve vyzkoušeno.

nebo

Ověřování už probíhá.

ObjectDisposedException

Tento objekt byl uzavřen.

PlatformNotSupportedException

Metoda AuthenticateAsServerAsync není podporována v Windows 95, Windows 98 nebo 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í Defaultmetody . Seznam odvolaných certifikátů se během ověřování nekontroluje. Klient nemusí zadávat certifikát pro 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é AuthenticateAsServer(X509Certificate).