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 zur Authentifizierung des Servers und optional auch des Clients aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang.
Überlädt
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Wird von Servern aufgerufen, um den Server und optional den Client in einer Client/Server-Verbindung mithilfe der angegebenen Zertifikate, Anforderungen und des Sicherheitsprotokolls als asynchronen Vorgang zu authentifizieren. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Wird von Servern aufgerufen, um den Server und optional den Client in einer Client/Server-Verbindung mithilfe der angegebenen Zertifikate, Anforderungen und des Sicherheitsprotokolls als asynchronen Vorgang zu authentifizieren. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Wird von Servern zur Authentifizierung des Servers und optional auch des Clients aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Der Authentifizierungsprozess verwendet Informationen, die in der |
| AuthenticateAsServerAsync(X509Certificate) |
Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Servers und optional auch des Clients mit dem angegebenen Zertifikat als asynchroner Vorgang aufgerufen. |
| AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken) |
Wird von Servern zur Authentifizierung des Servers und optional auch des Clients aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Der Authentifizierungsprozess verwendet Informationen, die von |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Servern aufgerufen, um den Server und optional den Client in einer Client/Server-Verbindung mithilfe der angegebenen Zertifikate, Anforderungen und des Sicherheitsprotokolls 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 nach einem Zertifikat für die Authentifizierung gefragt wird. Beachten Sie, dass dies nur eine Anforderung ist – wenn kein Zertifikat bereitgestellt wird, akzeptiert der Server weiterhin die Verbindungsanforderung.
- 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
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
serverCertificate ist null.
Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.
Die Authentifizierung ist bereits erfolgt.
- oder -
Eine Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.
- oder -
Die Authentifizierung läuft bereits.
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 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 AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Gilt für:
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Servern aufgerufen, um den Server und optional den Client in einer Client/Server-Verbindung mithilfe der angegebenen Zertifikate, Anforderungen und des Sicherheitsprotokolls 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 nach einem Zertifikat für die Authentifizierung 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 Zertifikatssperrliste während der Authentifizierung überprüft wird.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
serverCertificate ist null.
Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.
Die Authentifizierung ist bereits erfolgt.
- oder -
Eine Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.
- oder -
Die Authentifizierung läuft bereits.
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 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 AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Gilt für:
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Servern zur Authentifizierung des Servers und optional auch des Clients aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Der Authentifizierungsprozess verwendet Informationen, die in der sslClientAuthenticationOptions-Eigenschaftensammlung 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 = default);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, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParameter
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
Die Eigenschaftensammlung für die SSL-Verbindung.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
ServerCertificateSelectionCallback oder ServerCertificate oder ServerCertificateContext ist null, und LocalCertificateSelectionCallback ist nicht im SslStream-Konstruktor festgelegt.
sslServerAuthenticationOptions ist null.
Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.
Die Authentifizierung ist bereits erfolgt.
- oder -
Eine Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.
- oder -
Die Authentifizierung läuft bereits.
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 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 AuthenticateAsServer(SslServerAuthenticationOptions).
Gilt für:
AuthenticateAsServerAsync(X509Certificate)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Servers und optional auch des Clients mit dem angegebenen Zertifikat als asynchroner Vorgang aufgerufen.
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 zum Authentifizieren des Servers verwendete Zertifikat.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
serverCertificate ist null.
Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.
Die Authentifizierung ist bereits erfolgt.
- oder -
Eine Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.
- oder -
Die Authentifizierung läuft bereits.
Dieses Objekt wurde geschlossen.
Die AuthenticateAsServerAsync-Methode wird unter Windows 95, Windows 98 bzw. Windows Millennium nicht unterstützt.
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).
Diese Methode authentifiziert sich mit Default. Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der Client muss kein Zertifikat für die Authentifizierung bereitstellen.
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 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 AuthenticateAsServer(X509Certificate)Ausnahmen.
Gilt für:
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Servern zur Authentifizierung des Servers und optional auch des Clients aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Der Authentifizierungsprozess verwendet Informationen, die von optionsCallback zurückgegeben werden.
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- optionsCallback
- ServerOptionsSelectionCallback
Der Rückrufdelegat.
- state
- Object
Das Zustandsobjekt, das an optionsCallback übergeben wird, wenn der Rückruf aufgerufen wird.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
ServerCertificateSelectionCallback oder ServerCertificate oder ServerCertificateContext ist null, und LocalCertificateSelectionCallback ist nicht im SslStream-Konstruktor festgelegt.
Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.
Die Authentifizierung ist bereits erfolgt.
- oder -
Eine Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.
- oder -
Die Authentifizierung läuft bereits.
Dieses Objekt wurde geschlossen.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
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.
