SslStream.AuthenticateAsServer 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 zu authentifizieren.
Überlädt
| Name | Beschreibung |
|---|---|
| AuthenticateAsServer(X509Certificate) |
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mithilfe des angegebenen Zertifikats zu authentifizieren. |
| AuthenticateAsServer(X509Certificate, Boolean, Boolean) |
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mit den angegebenen Zertifikaten und Anforderungen zu authentifizieren und das Standardsicherheitsprotokoll des Systems zu verwenden. |
| AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean) |
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mit den angegebenen Zertifikaten, Anforderungen und Sicherheitsprotokollen zu authentifizieren. |
AuthenticateAsServer(X509Certificate)
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mithilfe des angegebenen Zertifikats zu authentifizieren.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unitPublic Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)Parameter
- serverCertificate
- X509Certificate
Das Zertifikat, das zum Authentifizieren des Servers verwendet wird.
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 AuthenticateAsServer 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.
Diese Methode blockiert, bis der Vorgang abgeschlossen ist. Um das Blockieren bis zum Abschluss des Vorgangs zu verhindern, verwenden Sie eine der BeginAuthenticateAsServer Methodenüberladungen.
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.
Gilt für:
AuthenticateAsServer(X509Certificate, Boolean, Boolean)
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mit den angegebenen Zertifikaten und Anforderungen zu authentifizieren und das Standardsicherheitsprotokoll des Systems zu verwenden.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unitPublic Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean)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.
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 AuthenticateAsServer 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 blockiert, bis der Vorgang abgeschlossen ist. Um das Blockieren bis zum Abschluss des Vorgangs zu verhindern, verwenden Sie eine der BeginAuthenticateAsServer Methodenüberladungen.
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.
Gilt für:
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)
Wird von Servern aufgerufen, um den Server und optional den Client in einer Clientserververbindung mit den angegebenen Zertifikaten, Anforderungen und Sicherheitsprotokollen zu authentifizieren.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unitPublic Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)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.
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 Clientauthentifizierung mit dieser SslStream Vorgehensweise wurde zuvor ausprobiert.
-oder-
Die Authentifizierung wird bereits ausgeführt.
Dieses Objekt wurde geschlossen.
Die methode AuthenticateAsServer 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 blockiert, bis der Vorgang abgeschlossen ist. Um das Blockieren bis zum Abschluss des Vorgangs zu verhindern, verwenden Sie eine der BeginAuthenticateAsServer Methodenüberladungen.
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.