SslStream.BeginAuthenticateAsServer 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.
Rozpoczyna operację asynchroniczną w celu obsługi po stronie serwera uwierzytelniania połączenia klient-serwer.
Przeciążenia
| BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object) |
Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object) |
Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia serwera i opcjonalnie klienta przy użyciu określonych certyfikatów i wymagań oraz domyślnego protokołu zabezpieczeń systemu. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object) |
Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia serwera i opcjonalnie klienta przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń. |
Uwagi
Przeciążenia tej metody nie blokują się, gdy uwierzytelnianie jest w toku. Aby zablokować podczas oczekiwania na ukończenie uwierzytelniania, użyj jednej z AuthenticateAsServer metod.
BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametry
- serverCertificate
- X509Certificate
X509Certificate używany do uwierzytelniania serwera.
- asyncCallback
- AsyncCallback
Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.
- asyncState
- Object
Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.
Zwraca
IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.
Wyjątki
serverCertificate to null.
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.
Metoda nie jest obsługiwana BeginAuthenticateAsServer 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 .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łączysz silną kryptografię przez edytowanie rejestru systemu Windows). Lista odwołania certyfikatów nie jest sprawdzana podczas uwierzytelniania. Klient nie jest wymagany do dostarczenia certyfikatu na potrzeby uwierzytelniania.
Operacja uwierzytelniania asynchronicznego musi zostać ukończona przez wywołanie EndAuthenticateAsClient metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .
Ta metoda nie blokuje się po zakończeniu operacji. Aby zablokować operację do czasu zakończenia operacji, użyj jednego z AuthenticateAsClient przeciążeń metody.
Aby uzyskać szczegółowe informacje na temat korzystania z modelu programowania asynchronicznego, zobacz Asynchroniczne wywoływanie metod synchronicznych
Jeśli otrzymasz wartość AuthenticationException, nie będzie to SslStream 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.
Dotyczy
BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia serwera i opcjonalnie klienta przy użyciu określonych certyfikatów i wymagań oraz domyślnego protokołu zabezpieczeń systemu.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametry
- serverCertificate
- X509Certificate
X509Certificate używany do uwierzytelniania serwera.
- clientCertificateRequired
- Boolean
Wartość Boolean 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.
- asyncCallback
- AsyncCallback
Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.
- asyncState
- Object
Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.
Zwraca
IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.
Wyjątki
serverCertificate to null.
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 serwera.
-lub-
Uwierzytelnianie jest już w toku.
Ten obiekt został zamknięty.
Metoda nie jest obsługiwana BeginAuthenticateAsServer 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 .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łączysz silną kryptografię przez edytowanie rejestru systemu Windows).
Operacja uwierzytelniania asynchronicznego musi zostać ukończona przez wywołanie EndAuthenticateAsServer metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .
Ta metoda nie blokuje się po zakończeniu operacji. Aby zablokować operację do czasu zakończenia operacji, użyj jednego z AuthenticateAsServer przeciążeń metody.
Aby uzyskać szczegółowe informacje na temat korzystania z modelu programowania asynchronicznego, zobacz Asynchroniczne wywoływanie metod synchronicznych
Jeśli otrzymasz wartość AuthenticationException, nie będzie to SslStream 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.
Dotyczy
BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia serwera i opcjonalnie klienta przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametry
- serverCertificate
- X509Certificate
X509Certificate używany do uwierzytelniania serwera.
- clientCertificateRequired
- Boolean
Wartość Boolean 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.
- asyncCallback
- AsyncCallback
Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.
- asyncState
- Object
Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.
Zwraca
IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.
Wyjątki
serverCertificate to null.
enabledSslProtocols jest nieprawidłową SslProtocols wartością.
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 serwera.
-lub-
Uwierzytelnianie jest już w toku.
Ten obiekt został zamknięty.
Metoda nie jest obsługiwana BeginAuthenticateAsServer 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 .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łączysz silną kryptografię przez edytowanie rejestru systemu Windows).
Operacja uwierzytelniania asynchronicznego musi zostać ukończona przez wywołanie EndAuthenticateAsServer metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .
Ta metoda nie blokuje się po zakończeniu operacji. Aby zablokować operację do czasu zakończenia operacji, użyj jednego z AuthenticateAsServer przeciążeń metody.
Aby uzyskać szczegółowe informacje na temat korzystania z modelu programowania asynchronicznego, zobacz Asynchroniczne wywoływanie metod synchronicznych
Jeśli otrzymasz wartość AuthenticationException, nie będzie to SslStream 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.
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