SslStream.AuthenticateAsServerAsync 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.
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren.
Überlädt
| Name | Beschreibung |
|---|---|
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mithilfe der angegebenen Zertifikate, Anforderungen und Sicherheitsprotokolle als asynchronen Vorgang zu authentifizieren. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mithilfe der angegebenen Zertifikate, Anforderungen und Sicherheitsprotokolle als asynchronen Vorgang zu authentifizieren. |
| AuthenticateAsServerAsync(X509Certificate) |
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mithilfe des angegebenen Zertifikats als asynchronen Vorgang zu authentifizieren. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Authentifiziert den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang. Der Authentifizierungsprozess verwendet Informationen, die |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mithilfe der angegebenen Zertifikate, Anforderungen und Sicherheitsprotokolle als asynchronen Vorgang zu authentifizieren.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParameter
- serverCertificate
- X509Certificate
Das zum Authentifizieren des Servers verwendete X509Certificate.
- clientCertificateRequired
- Boolean
Ein Boolean Wert, der angibt, ob der Client zur Authentifizierung nach einem Zertifikat gefragt wird. Beachten Sie, dass dies nur eine Anforderung ist – wenn kein Zertifikat bereitgestellt wird, akzeptiert der Server weiterhin die Verbindungsanforderung.
- 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
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
serverCertificate ist null.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Clientauthentifizierung mit dieser SslStream Vorgehensweise 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).
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 AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Gilt für:
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mithilfe der angegebenen Zertifikate, Anforderungen und Sicherheitsprotokolle als asynchronen Vorgang zu authentifizieren.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As TaskParameter
- serverCertificate
- X509Certificate
Das zum Authentifizieren des Servers verwendete X509Certificate.
- clientCertificateRequired
- Boolean
Ein Boolean Wert, der angibt, ob der Client zur Authentifizierung nach einem Zertifikat gefragt wird. Beachten Sie, dass dies nur eine Anforderung ist – wenn kein Zertifikat bereitgestellt wird, akzeptiert der Server weiterhin die Verbindungsanforderung.
- checkCertificateRevocation
- Boolean
Ein Boolean Wert, der angibt, ob die Zertifikatsperrliste während der Authentifizierung überprüft wird.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
serverCertificate ist null.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Clientauthentifizierung mit dieser SslStream Vorgehensweise 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).
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 AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Gilt für:
AuthenticateAsServerAsync(X509Certificate)
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mithilfe des angegebenen Zertifikats als asynchronen Vorgang zu authentifizieren.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As TaskParameter
- serverCertificate
- X509Certificate
Das Zertifikat, das zum Authentifizieren des Servers verwendet wird.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
serverCertificate ist null.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Clientauthentifizierung mit dieser SslStream Vorgehensweise wurde zuvor ausprobiert.
-oder-
Die Authentifizierung wird bereits ausgeführt.
Dieses Objekt wurde geschlossen.
Die methode AuthenticateAsServerAsync wird für Windows 95, Windows 98 oder Windows Millennium nicht unterstützt.
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).
Diese Methode authentifiziert sich mithilfe Defaultvon . Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der Client ist nicht erforderlich, um ein Zertifikat für die Authentifizierung bereitzustellen.
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 AuthenticateAsServer(X509Certificate).
Gilt für:
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
Authentifiziert den Server und optional den Client in einer Clientserververbindung als asynchronen Vorgang. Der Authentifizierungsprozess verwendet Informationen, die sslServerAuthenticationOptions im Eigenschaftenbehälter angegeben sind.
public:
System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParameter
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
Der Eigenschaftenbehälter für die SSL-Verbindung.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Entweder ServerCertificateSelectionCallback oder ist oder ServerCertificateServerCertificateContext ist null und LocalCertificateSelectionCallback nicht im SslStream Konstruktor festgelegt ist.
sslServerAuthenticationOptions ist null.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Clientauthentifizierung mit dieser SslStream Vorgehensweise wurde zuvor ausprobiert.
-oder-
Die Authentifizierung wird bereits ausgeführt.
Dieses Objekt wurde geschlossen.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
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 AuthenticateAsServer(SslServerAuthenticationOptions).