SslStream.AuthenticateAsServer Methode

Definition

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Servers und optional auch des Clients aufgerufen.

Überlädt

AuthenticateAsServer(SslServerAuthenticationOptions)	Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Servers und optional auch des Clients mit dem angegebenen Zertifikat aufgerufen.
AuthenticateAsServer(X509Certificate)	Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Servers und optional auch des Clients mit dem angegebenen Zertifikat aufgerufen.
AuthenticateAsServer(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 Standardsicherheitsprotokolls des Systems zu authentifizieren.
AuthenticateAsServer(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 zu authentifizieren.

AuthenticateAsServer(SslServerAuthenticationOptions)

Quelle:

SslStream.cs

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Servers und optional auch des Clients mit dem angegebenen Zertifikat aufgerufen.

public:
 void AuthenticateAsServer(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions);

public void AuthenticateAsServer (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions);

member this.AuthenticateAsServer : System.Net.Security.SslServerAuthenticationOptions -> unit

Public Sub AuthenticateAsServer (sslServerAuthenticationOptions As SslServerAuthenticationOptions)

Parameter

sslServerAuthenticationOptions

SslServerAuthenticationOptions

Die Eigenschaftensammlung für die SSL-Verbindung.

Ausnahmen

ArgumentNullException

serverCertificate 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 Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.

- oder -

Die Authentifizierung läuft bereits.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

PlatformNotSupportedException

Die AuthenticateAsServer-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). Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der Client muss kein Zertifikat für die Authentifizierung bereitstellen.

Diese Methode blockiert, bis der Vorgang abgeschlossen ist. Um das Blockieren zu verhindern, bis der Vorgang abgeschlossen ist, verwenden Sie eine der BeginAuthenticateAsServer Methodenüberladungen.

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.

AuthenticateAsServer(X509Certificate)

Quelle:

SslStream.cs

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Servers und optional auch des Clients mit dem angegebenen Zertifikat aufgerufen.

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

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)

Parameter

serverCertificate

X509Certificate

Das zum Authentifizieren des Servers verwendete Zertifikat.

Ausnahmen

ArgumentNullException

serverCertificate 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 Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.

- oder -

Die Authentifizierung läuft bereits.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

PlatformNotSupportedException

Die AuthenticateAsServer-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). Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der Client muss kein Zertifikat für die Authentifizierung bereitstellen.

Diese Methode blockiert, bis der Vorgang abgeschlossen ist. Um das Blockieren zu verhindern, bis der Vorgang abgeschlossen ist, verwenden Sie eine der BeginAuthenticateAsServer Methodenüberladungen.

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.

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

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 Standardsicherheitsprotokolls des Systems zu authentifizieren.

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

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

Ausnahmen

ArgumentNullException

serverCertificate 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 Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.

- oder -

Die Authentifizierung läuft bereits.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

PlatformNotSupportedException

Die AuthenticateAsServer -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 blockiert, bis der Vorgang abgeschlossen ist. Um das Blockieren zu verhindern, bis der Vorgang abgeschlossen ist, verwenden Sie eine der BeginAuthenticateAsServer Methodenüberladungen.

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.

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

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

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

Ausnahmen

ArgumentNullException

serverCertificate ist null.

ArgumentException

enabledSslProtocols ist kein gültiger SslProtocols-Wert.

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 Clientauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.

- oder -

Die Authentifizierung läuft bereits.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

PlatformNotSupportedException

Die AuthenticateAsServer -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 blockiert, bis der Vorgang abgeschlossen ist. Um das Blockieren zu verhindern, bis der Vorgang abgeschlossen ist, verwenden Sie eine der BeginAuthenticateAsServer Methodenüberladungen.

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.