SslStream.AuthenticateAsClient SslStream.AuthenticateAsClient SslStream.AuthenticateAsClient SslStream.AuthenticateAsClient Method

Definition

Authentifiziert die Clientseite einer Client-/Server-Verbindung.Authenticate the client side of a client-server connection.

Überlädt

AuthenticateAsClient(String) AuthenticateAsClient(String) AuthenticateAsClient(String) AuthenticateAsClient(String)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.Called by clients to authenticate the server and optionally the client in a client-server connection.

AuthenticateAsClient(String, X509CertificateCollection, Boolean) AuthenticateAsClient(String, X509CertificateCollection, Boolean) AuthenticateAsClient(String, X509CertificateCollection, Boolean) AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.Called by clients to authenticate the server and optionally the client in a client-server connection. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das SSL-Standardprotokoll des Systems.The authentication process uses the specified certificate collection, and the system default SSL protocol.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.Called by clients to authenticate the server and optionally the client in a client-server connection. Beim Authentifizierungsvorgang werden die angegebene Zertifikatsauflistung und das SSL-Protokoll verwendet.The authentication process uses the specified certificate collection and SSL protocol.

AuthenticateAsClient(String) AuthenticateAsClient(String) AuthenticateAsClient(String) AuthenticateAsClient(String)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.Called by clients to authenticate the server and optionally the client in a client-server connection.

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

Der Name des Servers, der diesen SslStream freigibt.The name of the server that shares this SslStream.

Ausnahmen

Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.The authentication failed and left this object in an unusable state.

Die Authentifizierung ist bereits erfolgt.Authentication has already occurred.

- oder --or- Eine Serverauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.Server authentication using this SslStream was tried previously.

- oder --or- Die Authentifizierung läuft bereits.Authentication is already in progress.

Dieses Objekt wurde geschlossen.This object has been closed.

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.Starting with .NET Framework 4.7, this method authenticates using None, which allows the operating system to choose the best protocol to use, and to block protocols that are not secure. 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).In .NET Framework 4.6 (and .NET Framework 4.5 with the latest security patches installed), the allowed TLS/SSL protocols versions are 1.2, 1.1, and 1.0 (unless you disable strong cryptography by editing the Windows Registry). Keine Clientzertifikate werden in die Authentifizierung verwendet.No client certificates are used in the authentication. Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft werden.The certificate revocation list is not checked during authentication. Der angegebene Wert für targetHost muss den Namen des Serverzertifikats übereinstimmen.The value specified for targetHost must match the name on the server's certificate.

Bei erfolgreicher Authentifizierung müssen Sie überprüfen, die IsEncrypted und IsSigned Eigenschaften fest, welche Sicherheitsdienste von verwendet werden, um die SslStream.When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the SslStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu bestimmen, ob die gegenseitige Authentifizierung erfolgt ist.Check the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und dies SslStream ist nicht mehr funktionsfähig.If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. Sie dieses Objekt schließen, und entfernen alle Verweise darauf, sodass es vom Garbage Collector gesammelt werden kann.You should close this object and remove all references to it so that it can be collected by the garbage collector.

AuthenticateAsClient(String, X509CertificateCollection, Boolean) AuthenticateAsClient(String, X509CertificateCollection, Boolean) AuthenticateAsClient(String, X509CertificateCollection, Boolean) AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.Called by clients to authenticate the server and optionally the client in a client-server connection. Der Authentifizierungsprozess verwendet die angegebene Zertifikatsammlung und das SSL-Standardprotokoll des Systems.The authentication process uses the specified certificate collection, and the system default SSL protocol.

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);
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 String String String

Der Name des Servers, der diesen SslStream freigibt.The name of the server that will share this SslStream.

checkCertificateRevocation
Boolean Boolean Boolean Boolean

Ein Boolean-Wert, der angibt, ob die Zertifikatssperrliste während der Authentifizierung überprüft wird.A Boolean value that specifies whether the certificate revocation list is checked during authentication.

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.Starting with .NET Framework 4.7, this method authenticates using None, which allows the operating system to choose the best protocol to use, and to block protocols that are not secure. 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).In .NET Framework 4.6 (and .NET Framework 4.5 with the latest security patches installed), the allowed TLS/SSL protocols versions are 1.2, 1.1, and 1.0 (unless you disable strong cryptography by editing the Windows Registry).

Bei erfolgreicher Authentifizierung müssen Sie überprüfen, die IsEncrypted und IsSigned Eigenschaften fest, welche Sicherheitsdienste von verwendet werden, um die SslStream.When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the SslStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu bestimmen, ob die gegenseitige Authentifizierung erfolgt ist.Check the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und dies SslStream ist nicht mehr funktionsfähig.If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. Sie dieses Objekt schließen, und entfernen alle Verweise darauf, sodass es vom Garbage Collector gesammelt werden kann.You should close this object and remove all references to it so that it can be collected by the garbage collector.

Hinweis

Clientzertifikate werden in das SSL-Protokoll für 2-Version nicht unterstützt.Client certificates are not supported in the SSL version 2 protocol.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Wird von Clients zur Authentifizierung des Servers und optional des Clients in einer Client-Server-Verbindung verwendet.Called by clients to authenticate the server and optionally the client in a client-server connection. Beim Authentifizierungsvorgang werden die angegebene Zertifikatsauflistung und das SSL-Protokoll verwendet.The authentication process uses the specified certificate collection and SSL protocol.

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);
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 String String String

Der Name des Servers, der diesen SslStream freigibt.The name of the server that will share this SslStream.

enabledSslProtocols
SslProtocols SslProtocols SslProtocols SslProtocols

Der SslProtocols-Wert, der das Protokoll für die Authentifizierung darstellt.The SslProtocols value that represents the protocol used for authentication.

checkCertificateRevocation
Boolean Boolean Boolean Boolean

Ein Boolean-Wert, der angibt, ob die Zertifikatssperrliste während der Authentifizierung überprüft wird.A Boolean value that specifies whether the certificate revocation list is checked during authentication.

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.Starting with .NET Framework 4.7, this method authenticates using None, which allows the operating system to choose the best protocol to use, and to block protocols that are not secure. 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).In .NET Framework 4.6 (and .NET Framework 4.5 with the latest security patches installed), the allowed TLS/SSL protocols versions are 1.2, 1.1, and 1.0 (unless you disable strong cryptography by editing the Windows Registry).

Bei erfolgreicher Authentifizierung müssen Sie überprüfen, die IsEncrypted und IsSigned Eigenschaften fest, welche Sicherheitsdienste von verwendet werden, um die SslStream.When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the SslStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu bestimmen, ob die gegenseitige Authentifizierung erfolgt ist.Check the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und dies SslStream ist nicht mehr funktionsfähig.If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. Sie dieses Objekt schließen, und entfernen alle Verweise darauf, sodass es vom Garbage Collector gesammelt werden kann.You should close this object and remove all references to it so that it can be collected by the garbage collector.

Hinweis

Clientzertifikate werden in das SSL-Protokoll für 2-Version nicht unterstützt.Client certificates are not supported in the SSL version 2 protocol.

Gilt für: