SslStream.BeginAuthenticateAsServer 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.
Startet einen asynchronen Vorgang, um die Serverseite der Authentifizierung einer Clientserververbindung zu verarbeiten.
Überlädt
| Name | Beschreibung |
|---|---|
| BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object) |
Wird von Servern aufgerufen, um einen asynchronen Vorgang zu starten, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object) |
Wird von Servern aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional den Client mithilfe der angegebenen Zertifikate und Anforderungen und des Systemstandardsicherheitsprotokolls zu starten. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object) |
Wird von Servern aufgerufen, um einen asynchronen Vorgang zu starten, um den Server und optional den Client mit den angegebenen Zertifikaten, Anforderungen und Sicherheitsprotokollen zu authentifizieren. |
Hinweise
Die Überladungen dieser Methode blockieren nicht, während die Authentifizierung ausgeführt wird. Wenn Sie während des Wartens auf den Abschluss der Authentifizierung blockieren möchten, verwenden Sie eine der AuthenticateAsServer Methoden.
BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Servern aufgerufen, um einen asynchronen Vorgang zu starten, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Parameter
- serverCertificate
- X509Certificate
Das zum Authentifizieren des Servers verwendete X509Certificate.
- asyncCallback
- AsyncCallback
Ein AsyncCallback Delegat, der auf die Methode verweist, die aufgerufen werden soll, wenn die Authentifizierung abgeschlossen ist.
- asyncState
- Object
Ein benutzerdefiniertes Objekt, das Informationen zum Vorgang enthält. Dieses Objekt wird an den asyncCallback Delegaten übergeben, wenn der Vorgang abgeschlossen ist.
Gibt zurück
Ein IAsyncResult Objekt, das den Status des asynchronen Vorgangs angibt.
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 BeginAuthenticateAsServer 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). Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der Client ist nicht erforderlich, um ein Zertifikat für die Authentifizierung bereitzustellen.
Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsClient Methode abgeschlossen werden. In der asyncCallback Regel wird die Methode vom Delegaten aufgerufen.
Diese Methode blockiert nicht, 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 asynchrones Aufrufen synchroner Methoden
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.
Gilt für:
BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Servern aufgerufen, um einen asynchronen Vorgang zur Authentifizierung des Servers und optional den Client mithilfe der angegebenen Zertifikate und Anforderungen und des Systemstandardsicherheitsprotokolls zu starten.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Parameter
- 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.
- asyncCallback
- AsyncCallback
Ein AsyncCallback Delegat, der auf die Methode verweist, die aufgerufen werden soll, wenn die Authentifizierung abgeschlossen ist.
- asyncState
- Object
Ein benutzerdefiniertes Objekt, das Informationen zum Vorgang enthält. Dieses Objekt wird an den asyncCallback Delegaten übergeben, wenn der Vorgang abgeschlossen ist.
Gibt zurück
Ein IAsyncResult Objekt, das den Status des asynchronen Vorgangs angibt.
Ausnahmen
serverCertificate ist null.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.
-oder-
Die Authentifizierung wird bereits ausgeführt.
Dieses Objekt wurde geschlossen.
Die methode BeginAuthenticateAsServer 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).
Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsServer Methode abgeschlossen werden. In der asyncCallback Regel wird die Methode vom Delegaten aufgerufen.
Diese Methode blockiert nicht, während der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie eine der AuthenticateAsServer Methodenüberladungen.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter asynchrones Aufrufen synchroner Methoden
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.
Gilt für:
BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Wird von Servern aufgerufen, um einen asynchronen Vorgang zu starten, um den Server und optional den Client mit den angegebenen Zertifikaten, Anforderungen und Sicherheitsprotokollen zu authentifizieren.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Parameter
- 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.
- asyncCallback
- AsyncCallback
Ein AsyncCallback Delegat, der auf die Methode verweist, die aufgerufen werden soll, wenn die Authentifizierung abgeschlossen ist.
- asyncState
- Object
Ein benutzerdefiniertes Objekt, das Informationen zum Vorgang enthält. Dieses Objekt wird an den asyncCallback Delegaten übergeben, wenn der Vorgang abgeschlossen ist.
Gibt zurück
Ein IAsyncResult Objekt, das den Status des asynchronen Vorgangs angibt.
Ausnahmen
serverCertificate ist null.
enabledSslProtocols ist kein gültiger SslProtocols Wert.
Fehler bei der Authentifizierung und verlassen dieses Objekt in einem nicht verwendbaren Zustand.
Die Authentifizierung ist bereits aufgetreten.
-oder-
Die Serverauthentifizierung mithilfe dieses SslStream Vorgangs wurde zuvor ausprobiert.
-oder-
Die Authentifizierung wird bereits ausgeführt.
Dieses Objekt wurde geschlossen.
Die methode BeginAuthenticateAsServer 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).
Der asynchrone Authentifizierungsvorgang muss durch Aufrufen der EndAuthenticateAsServer Methode abgeschlossen werden. In der asyncCallback Regel wird die Methode vom Delegaten aufgerufen.
Diese Methode blockiert nicht, während der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie eine der AuthenticateAsServer Methodenüberladungen.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter asynchrones Aufrufen synchroner Methoden
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.