SslStream.AuthenticateAsClientAsync Methode

Definition

Namespace:

System.Net.Security

Assemblys:

netstandard.dll, System.Net.Security.dll

Authentifizieren Sie die Clientseite einer Clientserververbindung als asynchronen Vorgang.

Überlädt

Name	Beschreibung
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	Wird von Clients aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das SSL-Protokoll.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	Wird von Clients aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das standardmäßige SSL-Protokoll des Systems.
AuthenticateAsClientAsync(String)	Wird von Clients aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	Wird von Clients aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet Informationen, die sslClientAuthenticationOptions im Eigenschaftenbehälter angegeben sind.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Quelle:

SslStream.cs

Wird von Clients aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das SSL-Protokoll.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Parameter

targetHost

String

Der Name des Servers, der diesen SslStreamServer teilt.

clientCertificates

X509CertificateCollection

Das X509CertificateCollection Zertifikat, das Clientzertifikate enthält.

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.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

AuthenticationException

Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.

InvalidOperationException

Die Authentifizierung ist bereits aufgetreten.

- oder -

Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.

- oder -

Die Authentifizierung wird bereits ausgeführt.

ObjectDisposedException

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

Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der SslStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu ermitteln, ob die gegenseitige Authentifizierung aufgetreten ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie einen AuthenticationException, und dies SslStream ist 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 Version 2-Protokoll nicht unterstützt.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Quelle:

SslStream.cs

Wird von Clients aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das standardmäßige SSL-Protokoll des Systems.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

Parameter

targetHost

String

Der Name des Servers, der diesen SslStreamServer teilt.

clientCertificates

X509CertificateCollection

Das X509CertificateCollection Zertifikat, das Clientzertifikate enthält.

checkCertificateRevocation

Boolean

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

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

AuthenticationException

Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.

InvalidOperationException

Die Authentifizierung ist bereits aufgetreten.

- oder -

Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.

- oder -

Die Authentifizierung wird bereits ausgeführt.

ObjectDisposedException

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

Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der SslStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu ermitteln, ob die gegenseitige Authentifizierung aufgetreten ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie einen AuthenticationException, und dies SslStream ist 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 Version 2-Protokoll nicht unterstützt.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AuthenticateAsClient(String, X509CertificateCollection, Boolean).

AuthenticateAsClientAsync(String)

Quelle:

SslStream.cs

Wird von Clients aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost);

abstract member AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

Parameter

targetHost

String

Der Name des Servers, der diesen SslStreamServer teilt.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentNullException

targetHost ist null.

AuthenticationException

Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.

InvalidOperationException

Die Authentifizierung ist bereits aufgetreten.

- oder -

Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.

- oder -

Die Authentifizierung wird bereits ausgeführt.

ObjectDisposedException

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.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der SslStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu ermitteln, ob die gegenseitige Authentifizierung aufgetreten ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie einen AuthenticationException, und dies SslStream ist nicht mehr verwendbar. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit es vom Garbage Collector erfasst werden kann.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AuthenticateAsClient(String).

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Quelle:

SslStream.cs

Wird von Clients aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet Informationen, die sslClientAuthenticationOptions im Eigenschaftenbehälter angegeben sind.

public:
 System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

sslClientAuthenticationOptions

SslClientAuthenticationOptions

Der Eigenschaftenbehälter für die SSL-Verbindung.

cancellationToken

CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentNullException

sslClientAuthenticationOptions ist null.

AuthenticationException

Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.

InvalidOperationException

Die Authentifizierung ist bereits aufgetreten.

- oder -

Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.

- oder -

Die Authentifizierung wird bereits ausgeführt.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der SslStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu ermitteln, ob die gegenseitige Authentifizierung aufgetreten ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie einen AuthenticationException, und dies SslStream ist nicht mehr verwendbar. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit es vom Garbage Collector erfasst werden kann.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AuthenticateAsClient(SslClientAuthenticationOptions).