SslStream.AuthenticateAsServerAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 |
| 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 |
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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParametry
- 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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As TaskParametry
- 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.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
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
Albo ServerCertificateSelectionCallback lub ServerCertificateServerCertificateContext jest i LocalCertificateSelectionCallback nie jest null ustawiony w konstruktorzeSslStream.
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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As TaskParametry
- 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.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- 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
Element ServerCertificateSelectionCallback lub ServerCertificateServerCertificateContext lub nie nullLocalCertificateSelectionCallback jest ustawiony w konstruktorze SslStream .
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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla