SslStream.AuthenticateAsClientAsync Methode

Definition

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Authentifiziert die Clientseite einer Client-/Serververbindung als einen asynchronen Vorgang.

Überlädt

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	Wird von Clients zur asynchronen Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Beim Authentifizierungsvorgang werden die angegebene Zertifikatsauflistung und das SSL-Protokoll verwendet.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	Wird von Clients zur asynchronen Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das SSL-Standardprotokoll des Systems.
AuthenticateAsClientAsync(String)	Wird von Clients zur asynchronen Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	Wird von Clients zur asynchronen Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Der Authentifizierungsprozess verwendet Informationen, die in der sslClientAuthenticationOptions-Eigenschaftensammlung angegeben sind.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Quelle:

SslStream.cs

Wird von Clients zur asynchronen Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Beim Authentifizierungsvorgang werden die angegebene Zertifikatsauflistung und das SSL-Protokoll verwendet.

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

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

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

Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von SslStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um zu ermitteln, ob eine gegenseitige Authentifizierung erfolgt ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie ein AuthenticationException, und dieser SslStream kann nicht mehr verwendet werden. 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 Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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 wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Quelle:

SslStream.cs

Wird von Clients zur asynchronen Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das SSL-Standardprotokoll 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 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.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

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

Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von SslStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um zu ermitteln, ob eine gegenseitige Authentifizierung erfolgt ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie ein AuthenticationException, und dieser SslStream kann nicht mehr verwendet werden. 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 Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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 wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden AuthenticateAsClient(String, X509CertificateCollection, Boolean).

AuthenticateAsClientAsync(String)

Quelle:

SslStream.cs

Wird von Clients zur asynchronen Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.

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 SslStream freigibt.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

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 Serverzertifikat übereinstimmen.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von SslStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um zu ermitteln, ob eine gegenseitige Authentifizierung erfolgt ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie ein AuthenticationException, und dieser SslStream kann nicht mehr verwendet werden. 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 Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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 wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden AuthenticateAsClient(String).

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Quelle:

SslStream.cs

Wird von Clients zur asynchronen Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Der Authentifizierungsprozess verwendet Informationen, die in der sslClientAuthenticationOptions-Eigenschaftensammlung 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

Die Eigenschaftensammlung für die SSL-Verbindung.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentNullException

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

OperationCanceledException

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

Hinweise

Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von SslStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.

Wenn bei der Authentifizierung ein Fehler auftritt, erhalten Sie einen AuthenticationException, und dieser SslStream kann nicht mehr verwendet werden. 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 sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten AuthenticateAsClient(SslClientAuthenticationOptions)Ausnahmen.