SslStream.BeginAuthenticateAsClient Methode

Definition

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Startet einen Vorgang, um die Clientseite einer Client-/Serververbindung zu authentifizieren.

Überlädt

BeginAuthenticateAsClient(String, AsyncCallback, Object)	Wird von Clients aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional auch des Clients zu starten.
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)	Wird von Clients aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional des Clients mithilfe der angegebenen Zertifikate und des Standardsicherheitsprotokolls des Systems zu beginnen.
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)	Wird von Clients aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional auch des Clients mit den angegebenen Zertifikaten und dem angegebenen Sicherheitsprotokoll zu starten.

Hinweise

Die Überladungen dieser Methode werden während der Authentifizierung nicht blockiert. Verwenden Sie eine der Methoden, um zu blockieren, während sie auf den Abschluss der AuthenticateAsClient Authentifizierung warten.

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Quelle:

SslStream.cs

Wird von Clients aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional auch des Clients zu starten.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::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 -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parameter

targetHost

String

Der Name des Servers, der diesen SslStream freigibt.

asyncCallback

AsyncCallback

Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss der Authentifizierung aufgerufen werden soll.

asyncState

Object

Ein benutzerdefiniertes Objekt, das Informationen über den Vorgang enthält. Dieses Objekt wird bei Abschluss des Vorgangs an den asyncCallback-Delegaten übergeben.

Gibt zurück

IAsyncResult

Ein IAsyncResult-Objekt, das den Status des asynchronen Vorgangs angibt.

Ausnahmen

ArgumentNullException

targetHost ist null.

AuthenticationException

Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.

InvalidOperationException

Die Authentifizierung ist bereits erfolgt.

- oder -

Eine Serverauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.

- oder -

Die Authentifizierung läuft bereits.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

Hinweise

Ab .NET Framework 4.7 authentifiziert diese Methode sich mithilfe von None, was dem Betriebssystem ermöglicht, das am besten geeignete Protokoll auszuwählen und unsichere Protokolle zu blockieren. In .NET Framework 4.6 (und .NET Framework 4.5 mit den neuesten installierten Sicherheitspatches) sind die zulässigen Versionen der TLS/SSL-Protokolle 1.2, 1.1 und 1.0 (es sei denn, Sie deaktivieren die starke Kryptographie durch Bearbeiten der Windows-Registrierung). Bei der Authentifizierung werden keine Clientzertifikate verwendet. Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft.

Der für targetHost angegebene Wert muss mit dem Namen im Zertifikat des Servers übereinstimmen.

Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsClient -Methode abgeschlossen werden. In der Regel wird die -Methode vom asyncCallback Delegaten aufgerufen.

Diese Methode wird nicht blockiert, 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 Aufrufen synchroner Methoden asynchron.

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.

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

Quelle:

SslStream.cs

Wird von Clients aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional des Clients mithilfe der angegebenen Zertifikate und des Standardsicherheitsprotokolls des Systems zu beginnen.

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);

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 -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parameter

targetHost

String

Der Name des Servers, der diesen SslStream freigibt.

clientCertificates

X509CertificateCollection

Die X509CertificateCollection mit den Clientzertifikaten.

checkCertificateRevocation

Boolean

Ein Boolean-Wert, der angibt, ob die Zertifikatssperrliste während der Authentifizierung überprüft wird.

asyncCallback

AsyncCallback

Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss der Authentifizierung aufgerufen werden soll.

asyncState

Object

Ein benutzerdefiniertes Objekt, das Informationen über den Vorgang enthält. Dieses Objekt wird bei Abschluss des Vorgangs an den asyncCallback-Delegaten übergeben.

Gibt zurück

IAsyncResult

Ein IAsyncResult-Objekt, das den Status des asynchronen Vorgangs angibt.

Ausnahmen

ArgumentNullException

targetHost ist null.

AuthenticationException

Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.

InvalidOperationException

Die Authentifizierung ist bereits erfolgt.

- oder -

Eine Serverauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.

- oder -

Die Authentifizierung läuft bereits.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

Hinweise

Ab .NET Framework 4.7 authentifiziert diese Methode sich mithilfe von None, was dem Betriebssystem ermöglicht, das am besten geeignete Protokoll auszuwählen und unsichere Protokolle zu blockieren. In .NET Framework 4.6 (und .NET Framework 4.5 mit den neuesten installierten Sicherheitspatches) sind die zulässigen Versionen der TLS/SSL-Protokolle 1.2, 1.1 und 1.0 (es sei denn, Sie deaktivieren die starke Kryptographie durch Bearbeiten der Windows-Registrierung).

Der für targetHost angegebene Wert muss mit dem Namen im Zertifikat des Servers übereinstimmen.

Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsClient -Methode abgeschlossen werden. In der Regel wird die -Methode vom asyncCallback Delegaten aufgerufen.

Diese Methode wird nicht blockiert, 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 Aufrufen synchroner Methoden asynchron.

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.

Hinweis

Clientzertifikate werden im SSL-Protokoll, Version 2, nicht unterstützt.

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

Quelle:

SslStream.cs

Wird von Clients aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional auch des Clients mit den angegebenen Zertifikaten und dem angegebenen Sicherheitsprotokoll zu starten.

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);

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 -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parameter

targetHost

String

Der Name des Servers, der diesen SslStream freigibt.

clientCertificates

X509CertificateCollection

Die X509CertificateCollection mit den Clientzertifikaten.

enabledSslProtocols

SslProtocols

Der SslProtocols-Wert, der zur Authentifizierung verwendete Protokolle darstellt.

checkCertificateRevocation

Boolean

Ein Boolean-Wert, der angibt, ob die Zertifikatssperrliste während der Authentifizierung überprüft wird.

asyncCallback

AsyncCallback

Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss der Authentifizierung aufgerufen werden soll.

asyncState

Object

Ein benutzerdefiniertes Objekt, das Informationen über den Vorgang enthält. Dieses Objekt wird bei Abschluss des Vorgangs an den asyncCallback-Delegaten übergeben.

Gibt zurück

IAsyncResult

Ein IAsyncResult-Objekt, das den Status des asynchronen Vorgangs angibt.

Ausnahmen

ArgumentNullException

targetHost ist null.

ArgumentException

enabledSslProtocols ist kein gültiger SslProtocols-Wert.

AuthenticationException

Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.

InvalidOperationException

Die Authentifizierung ist bereits erfolgt.

- oder -

Eine Serverauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.

- oder -

Die Authentifizierung läuft bereits.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

Hinweise

Ab .NET Framework 4.7 authentifiziert diese Methode sich mithilfe von None, was dem Betriebssystem ermöglicht, das am besten geeignete Protokoll auszuwählen und unsichere Protokolle zu blockieren. In .NET Framework 4.6 (und .NET Framework 4.5 mit den neuesten installierten Sicherheitspatches) sind die zulässigen Versionen der TLS/SSL-Protokolle 1.2, 1.1 und 1.0 (es sei denn, Sie deaktivieren die starke Kryptographie durch Bearbeiten der Windows-Registrierung).

Der für targetHost angegebene Wert muss mit dem Namen im Zertifikat des Servers übereinstimmen.

Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsClient -Methode abgeschlossen werden. In der Regel wird die -Methode vom asyncCallback Delegaten aufgerufen.

Diese Methode wird nicht blockiert, 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 Aufrufen synchroner Methoden asynchron.

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.

Hinweis

Clientzertifikate werden im SSL-Protokoll, Version 2, nicht unterstützt.