SslStream.AuthenticateAsServerAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Security

Zestaw:

System.Net.Security.dll

Wywoływane przez serwery w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer jako operacja asynchroniczna.

Przeciążenia

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)	Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń jako operacji asynchronicznej.
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)	Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń jako operacji asynchronicznej.
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)	Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej. Proces uwierzytelniania używa informacji określonych w torbie sslClientAuthenticationOptions właściwości.
AuthenticateAsServerAsync(X509Certificate)	Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonego certyfikatu jako operacji asynchronicznej.
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)	Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej. Proces uwierzytelniania używa informacji zwracanych przez optionsCallbackprogram .

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

Źródło:

SslStream.cs

Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń jako operacji asynchronicznej.

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

X509Certificate używany do uwierzytelniania serwera.

clientCertificateRequired

Boolean

Boolean Wartość określająca, czy klient jest proszony o certyfikat do uwierzytelniania. Należy pamiętać, że jest to tylko żądanie — jeśli nie podano certyfikatu, serwer nadal akceptuje żądanie połączenia.

enabledSslProtocols

SslProtocols

SslProtocols Wartość reprezentująca protokoły używane do uwierzytelniania.

checkCertificateRevocation

Boolean

Boolean Wartość określająca, czy lista odwołania certyfikatów jest sprawdzana podczas uwierzytelniania.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

serverCertificate to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiło ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub-

Uwierzytelnianie klienta przy użyciu tej SslStream metody zostało wcześniej wypróbowane.

-lub-

Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

Uwagi

Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W wersji .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń) dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączono silną kryptografię przez edytowanie rejestru systemu Windows).

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationException, a to SslStream nie jest już możliwe do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było je zebrać przez moduł odśmieceń pamięci.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)usługę .

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

Źródło:

SslStream.cs

Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń jako operacji asynchronicznej.

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

X509Certificate używany do uwierzytelniania serwera.

clientCertificateRequired

Boolean

Boolean Wartość określająca, czy klient jest proszony o certyfikat do uwierzytelniania. Należy pamiętać, że jest to tylko żądanie — jeśli nie podano certyfikatu, serwer nadal akceptuje żądanie połączenia.

checkCertificateRevocation

Boolean

Boolean Wartość określająca, czy lista odwołania certyfikatów jest sprawdzana podczas uwierzytelniania.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

serverCertificate to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiło ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub-

Uwierzytelnianie klienta przy użyciu tej SslStream metody zostało wcześniej wypróbowane.

-lub-

Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

Uwagi

Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W wersji .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń) dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączono silną kryptografię przez edytowanie rejestru systemu Windows).

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationException, a to SslStream nie jest już możliwe do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było je zebrać przez moduł odśmieceń pamięci.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez AuthenticateAsServer(X509Certificate, Boolean, Boolean)usługę .

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

Źródło:

SslStream.cs

Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej. Proces uwierzytelniania używa informacji określonych w torbie sslClientAuthenticationOptions właściwości.

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

Torba właściwości dla połączenia SSL.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Albo ServerCertificateSelectionCallback lub ServerCertificateServerCertificateContext jest i LocalCertificateSelectionCallback nie jest null ustawiony w konstruktorzeSslStream.

ArgumentNullException

sslServerAuthenticationOptions to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiło ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub-

Uwierzytelnianie klienta przy użyciu tej SslStream metody zostało wcześniej wypróbowane.

-lub-

Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationException, a to SslStream nie jest już możliwe do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było je zebrać przez moduł odśmieceń pamięci.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez AuthenticateAsServer(SslServerAuthenticationOptions)usługę .

AuthenticateAsServerAsync(X509Certificate)

Źródło:

SslStream.cs

Wywoływane przez serwery w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer przy użyciu określonego certyfikatu jako operacji asynchronicznej.

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

Certyfikat używany do uwierzytelniania serwera.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

serverCertificate to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiło ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub-

Uwierzytelnianie klienta przy użyciu tej SslStream metody zostało wcześniej wypróbowane.

-lub-

Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

PlatformNotSupportedException

Metoda nie jest obsługiwana AuthenticateAsServerAsync w systemach Windows 95, Windows 98 lub Windows Millennium.

Uwagi

Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W wersji .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń) dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączono silną kryptografię przez edytowanie rejestru systemu Windows).

Ta metoda uwierzytelnia się przy użyciu polecenia Default. Lista odwołania certyfikatów nie jest sprawdzana podczas uwierzytelniania. Klient nie jest wymagany do dostarczenia certyfikatu do uwierzytelniania.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationException, a to SslStream nie jest już możliwe do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez AuthenticateAsServer(X509Certificate)usługę .

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

Źródło:

SslStream.cs

Wywoływane przez serwery w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer jako operacja asynchroniczna. Proces uwierzytelniania używa informacji zwracanych przez optionsCallbackprogram .

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

Delegat wywołania zwrotnego.

state

Object

Obiekt stanu do przekazania podczas optionsCallback wywoływania wywołania zwrotnego.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Element ServerCertificateSelectionCallback lub ServerCertificateServerCertificateContext lub nie nullLocalCertificateSelectionCallback jest ustawiony w konstruktorze SslStream .

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiono ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie już wystąpiło.

-lub-

Wcześniej próbowano użyć uwierzytelniania SslStream klienta.

-lub-

Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.