SslStream.AuthenticateAsClient Methode

Definition

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Authentifiziert die Clientseite einer Client-/Server-Verbindung.

Überlädt

AuthenticateAsClient(SslClientAuthenticationOptions)	Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.
AuthenticateAsClient(String)	Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das SSL-Standardprotokoll des Systems.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Beim Authentifizierungsvorgang werden die angegebene Zertifikatsauflistung und das SSL-Protokoll verwendet.

AuthenticateAsClient(SslClientAuthenticationOptions)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.

public:
 void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);

public void AuthenticateAsClient (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);

member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unit

Public Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)

Parameter

sslClientAuthenticationOptions

SslClientAuthenticationOptions

Die Eigenschaftensammlung für die SSL-Verbindung.

Ausnahmen

ArgumentNullException

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

• oder -

Die Authentifizierung läuft bereits.

ObjectDisposedException

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). Es werden keine Clientzertifikate in der Authentifizierung verwendet. Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der für die Angabe angegebene targetHost Wert muss dem Namen im Zertifikat des Servers entsprechen.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu ermitteln, welche Sicherheitsdienste von dem SslStreamverwendet werden. Überprüfen Sie die Eigenschaft, um festzustellen, ob die IsMutuallyAuthenticated gegenseitige Authentifizierung aufgetreten ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und dies SslStream ist nicht mehr nutzbar. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit sie vom Müllsammler gesammelt werden kann.

AuthenticateAsClient(String)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost);

public virtual void AuthenticateAsClient (string targetHost);

abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String)

Parameter

targetHost

String

Der Name des Servers, der diesen SslStream freigibt.

Ausnahmen

ArgumentNullException

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

• oder - Die Authentifizierung läuft bereits.

ObjectDisposedException

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). Es werden keine Clientzertifikate in der Authentifizierung verwendet. Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der für die Angabe angegebene targetHost Wert muss dem Namen im Zertifikat des Servers entsprechen.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu ermitteln, welche Sicherheitsdienste von dem SslStreamverwendet werden. Überprüfen Sie die Eigenschaft, um festzustellen, ob die IsMutuallyAuthenticated gegenseitige Authentifizierung aufgetreten ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und dies SslStream ist nicht mehr nutzbar. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit sie vom Müllsammler gesammelt werden kann.

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das SSL-Standardprotokoll des Systems.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)

Parameter

targetHost

String

Der Name des Servers, der diesen SslStream freigibt.

clientCertificates

X509CertificateCollection

Die X509CertificateCollection mit den Clientzertifikaten.

checkCertificateRevocation

Boolean

Ein Boolean-Wert, der angibt, ob die Zertifikatssperrliste während der Authentifizierung überprüft wird.

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 erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu ermitteln, welche Sicherheitsdienste von dem SslStreamverwendet werden. Überprüfen Sie die Eigenschaft, um festzustellen, ob die IsMutuallyAuthenticated gegenseitige Authentifizierung aufgetreten ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und dies SslStream ist nicht mehr nutzbar. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit sie vom Müllsammler gesammelt werden kann.

Hinweis

Clientzertifikate werden im SSL Version 2-Protokoll nicht unterstützt.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet. Beim Authentifizierungsvorgang werden die angegebene Zertifikatsauflistung und das SSL-Protokoll verwendet.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

Parameter

targetHost

String

Der Name des Servers, der diesen SslStream freigibt.

clientCertificates

X509CertificateCollection

Die X509CertificateCollection mit den Clientzertifikaten.

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.

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 erfolgreich ist, müssen Sie die IsEncrypted Und-Eigenschaften IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von der SslStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung aufgetreten ist.

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 sie vom Garbage Collector gesammelt werden kann.

Hinweis

Clientzertifikate werden im SSL Version 2-Protokoll nicht unterstützt.