SslStream.BeginAuthenticateAsClient Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet einen Vorgang, um die Clientseite einer Clientserververbindung zu authentifizieren.
Überlädt
| Name | Beschreibung |
|---|---|
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Wird von Clients aufgerufen, um einen asynchronen Vorgang zu starten, um den Server und optional den Client zu authentifizieren. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Wird von Clients aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional den Client mithilfe der angegebenen Zertifikate und des Systemstandardsicherheitsprotokolls zu starten. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Wird von Clients aufgerufen, um einen asynchronen Vorgang zu starten, um den Server und optional den Client mithilfe der angegebenen Zertifikate und des Sicherheitsprotokolls zu authentifizieren. |
Hinweise
Die Überladungen dieser Methode blockieren nicht, während die Authentifizierung ausgeführt wird. Wenn Sie während des Wartens auf den Abschluss der Authentifizierung blockieren möchten, verwenden Sie eine der AuthenticateAsClient Methoden.
BeginAuthenticateAsClient(String, AsyncCallback, Object)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Clients aufgerufen, um einen asynchronen Vorgang zu starten, um den Server und optional den Client zu authentifizieren.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParameter
- asyncCallback
- AsyncCallback
Ein AsyncCallback Delegat, der auf die Methode verweist, die aufgerufen werden soll, wenn die Authentifizierung abgeschlossen ist.
- asyncState
- Object
Ein benutzerdefiniertes Objekt, das Informationen zum Vorgang enthält. Dieses Objekt wird an den asyncCallback Delegaten übergeben, wenn der Vorgang abgeschlossen ist.
Gibt zurück
Ein IAsyncResult Objekt, das den Status des asynchronen Vorgangs angibt.
Ausnahmen
targetHost ist null.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.
-oder-
Die Authentifizierung wird bereits ausgeführt.
Dieses Objekt wurde geschlossen.
Hinweise
Ab .NET Framework 4.7 authentifiziert sich diese Methode mit der Verwendung None, wodurch das Betriebssystem das beste zu verwendende Protokoll auswählen und protokolle blockieren kann, die nicht sicher sind. In .NET Framework 4.6 (und .NET Framework 4.5 mit den neuesten Installierten Sicherheitspatches) sind die zulässigen TLS/SSL-Protokollversionen 1.2, 1.1 und 1.0 (es sei denn, Sie deaktivieren eine starke Kryptografie, indem Sie die Windows-Registrierung bearbeiten). In der Authentifizierung werden keine Clientzertifikate verwendet. Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft.
Der angegebene targetHost Wert muss mit dem Namen im Zertifikat des Servers übereinstimmen.
Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsClient Methode abgeschlossen werden. In der asyncCallback Regel wird die Methode vom Delegaten aufgerufen.
Diese Methode blockiert nicht, während der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie eine der AuthenticateAsClient Methodenüberladungen.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter asynchrones Aufrufen synchroner Methoden
Wenn Sie einen AuthenticationExceptionErhalten, ist dies SslStream nicht mehr verwendbar. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit es vom Garbage Collector erfasst werden kann.
Gilt für:
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Clients aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional den Client mithilfe der angegebenen Zertifikate und des Systemstandardsicherheitsprotokolls zu starten.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParameter
- clientCertificates
- X509CertificateCollection
Die X509CertificateCollection enthaltenden Clientzertifikate.
- checkCertificateRevocation
- Boolean
Ein Boolean Wert, der angibt, ob die Zertifikatsperrliste während der Authentifizierung überprüft wird.
- asyncCallback
- AsyncCallback
Ein AsyncCallback Delegat, der auf die Methode verweist, die aufgerufen werden soll, wenn die Authentifizierung abgeschlossen ist.
- asyncState
- Object
Ein benutzerdefiniertes Objekt, das Informationen zum Vorgang enthält. Dieses Objekt wird an den asyncCallback Delegaten übergeben, wenn der Vorgang abgeschlossen ist.
Gibt zurück
Ein IAsyncResult Objekt, das den Status des asynchronen Vorgangs angibt.
Ausnahmen
targetHost ist null.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.
-oder-
Die Authentifizierung wird bereits ausgeführt.
Dieses Objekt wurde geschlossen.
Hinweise
Ab .NET Framework 4.7 authentifiziert sich diese Methode mit der Verwendung None, wodurch das Betriebssystem das beste zu verwendende Protokoll auswählen und protokolle blockieren kann, die nicht sicher sind. In .NET Framework 4.6 (und .NET Framework 4.5 mit den neuesten Installierten Sicherheitspatches) sind die zulässigen TLS/SSL-Protokollversionen 1.2, 1.1 und 1.0 (es sei denn, Sie deaktivieren eine starke Kryptografie, indem Sie die Windows-Registrierung bearbeiten).
Der angegebene targetHost Wert muss mit dem Namen im Zertifikat des Servers übereinstimmen.
Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsClient Methode abgeschlossen werden. In der asyncCallback Regel wird die Methode vom Delegaten aufgerufen.
Diese Methode blockiert nicht, während der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie eine der AuthenticateAsClient Methodenüberladungen.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter asynchrones Aufrufen synchroner Methoden
Wenn Sie einen AuthenticationExceptionErhalten, ist dies SslStream nicht mehr verwendbar. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit es vom Garbage Collector erfasst werden kann.
Note
Clientzertifikate werden im SSL Version 2-Protokoll nicht unterstützt.
Gilt für:
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Clients aufgerufen, um einen asynchronen Vorgang zu starten, um den Server und optional den Client mithilfe der angegebenen Zertifikate und des Sicherheitsprotokolls zu authentifizieren.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParameter
- clientCertificates
- X509CertificateCollection
Die X509CertificateCollection enthaltenden Clientzertifikate.
- enabledSslProtocols
- SslProtocols
Der Wert, der SslProtocols Protokolle darstellt, die für die Authentifizierung verwendet werden.
- checkCertificateRevocation
- Boolean
Ein Boolean Wert, der angibt, ob die Zertifikatsperrliste während der Authentifizierung überprüft wird.
- asyncCallback
- AsyncCallback
Ein AsyncCallback Delegat, der auf die Methode verweist, die aufgerufen werden soll, wenn die Authentifizierung abgeschlossen ist.
- asyncState
- Object
Ein benutzerdefiniertes Objekt, das Informationen zum Vorgang enthält. Dieses Objekt wird an den asyncCallback Delegaten übergeben, wenn der Vorgang abgeschlossen ist.
Gibt zurück
Ein IAsyncResult Objekt, das den Status des asynchronen Vorgangs angibt.
Ausnahmen
targetHost ist null.
enabledSslProtocols ist kein gültiger SslProtocols Wert.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.
-oder-
Die Authentifizierung wird bereits ausgeführt.
Dieses Objekt wurde geschlossen.
Hinweise
Ab .NET Framework 4.7 authentifiziert sich diese Methode mit der Verwendung None, wodurch das Betriebssystem das beste zu verwendende Protokoll auswählen und protokolle blockieren kann, die nicht sicher sind. In .NET Framework 4.6 (und .NET Framework 4.5 mit den neuesten Installierten Sicherheitspatches) sind die zulässigen TLS/SSL-Protokollversionen 1.2, 1.1 und 1.0 (es sei denn, Sie deaktivieren eine starke Kryptografie, indem Sie die Windows-Registrierung bearbeiten).
Der angegebene targetHost Wert muss mit dem Namen im Zertifikat des Servers übereinstimmen.
Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsClient Methode abgeschlossen werden. In der asyncCallback Regel wird die Methode vom Delegaten aufgerufen.
Diese Methode blockiert nicht, während der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie eine der AuthenticateAsClient Methodenüberladungen.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter asynchrones Aufrufen synchroner Methoden
Wenn Sie einen AuthenticationExceptionErhalten, ist dies SslStream nicht mehr verwendbar. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit es vom Garbage Collector erfasst werden kann.
Note
Clientzertifikate werden im SSL Version 2-Protokoll nicht unterstützt.
