SslStream.AuthenticateAsClient Methode

Definition

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

Überlädt

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)

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)

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)

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

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

Implementiert

Mono.Net.Security.IMonoSslStream.AuthenticateAsClient(System.String)

Ausnahmen

targetHost ist null.targetHost is null.

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). in der Authentifizierung werden keine Client Zertifikate verwendet.No client certificates are used in the authentication. Die Zertifikat Sperr Liste wird während der Authentifizierung nicht geprüft.The certificate revocation list is not checked during authentication. Der für targetHost angegebene Wert muss mit dem Namen des Serverzertifikats identisch sein.The value specified for targetHost must match the name on the server's certificate.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die Eigenschaften des IsEncrypted und IsSigned überprüfen, um zu bestimmen, welche Sicherheitsdienste vom SslStreamverwendet werden.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 gegenseitigeCheck the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und diese SslStream ist nicht mehr verwendbar.If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit 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)

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

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

clientCertificates
X509CertificateCollection

Die X509CertificateCollection mit den Clientzertifikaten.The X509CertificateCollection that contains client certificates.

checkCertificateRevocation
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).

Wenn die Authentifizierung erfolgreich ist, müssen Sie die Eigenschaften des IsEncrypted und IsSigned überprüfen, um zu bestimmen, welche Sicherheitsdienste vom SslStreamverwendet werden.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 gegenseitigeCheck the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und diese SslStream ist nicht mehr verwendbar.If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit 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

Client Zertifikate werden im SSL-Protokoll, Version 2, nicht unterstützt.Client certificates are not supported in the SSL version 2 protocol.

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

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

clientCertificates
X509CertificateCollection

Die X509CertificateCollection mit den Clientzertifikaten.The X509CertificateCollection that contains client certificates.

enabledSslProtocols
SslProtocols

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

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

Implementiert

Mono.Net.Security.IMonoSslStream.AuthenticateAsClient(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Security.Authentication.SslProtocols,System.Boolean)

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

Wenn die Authentifizierung erfolgreich ist, müssen Sie die Eigenschaften des IsEncrypted und IsSigned überprüfen, um zu bestimmen, welche Sicherheitsdienste vom SslStreamverwendet werden.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 gegenseitigeCheck the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException, und diese SslStream ist nicht mehr verwendbar.If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. Sie sollten dieses Objekt schließen und alle Verweise darauf entfernen, damit 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

Client Zertifikate werden im SSL-Protokoll, Version 2, nicht unterstützt.Client certificates are not supported in the SSL version 2 protocol.

Gilt für: