Udostępnij za pośrednictwem


SslStream.AuthenticateAsServerAsync Metoda

Definicja

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
Źródło:
SslStream.cs
Ź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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

serverCertificate to null.

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

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.

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

Dotyczy

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Ź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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

serverCertificate to null.

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

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.

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

Dotyczy

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Ź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);
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.Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As Task

Parametry

sslServerAuthenticationOptions
SslServerAuthenticationOptions

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

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

sslServerAuthenticationOptions to null.

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

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.

Ten obiekt został zamknięty.

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

Dotyczy

AuthenticateAsServerAsync(X509Certificate)

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Ź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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

serverCertificate to null.

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

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.

Ten obiekt został zamknięty.

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

Dotyczy

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Ź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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

Uwierzytelnianie już wystąpiło.

-lub-

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

-lub-

Uwierzytelnianie jest już w toku.

Ten obiekt został zamknięty.

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.

Dotyczy