SslStream.AuthenticateAsClient 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.
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)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
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 -> unitPublic Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)Parameter
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
Die Eigenschaftensammlung für die SSL-Verbindung.
Ausnahmen
targetHost ist null.
Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.
Die Authentifizierung ist bereits erfolgt.
- oder -
Eine Serverauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.
- oder -
Die Authentifizierung läuft bereits.
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). Bei der Authentifizierung werden keine Clientzertifikate verwendet. Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der für targetHost angegebene Wert muss mit dem Namen im Zertifikat des Servers übereinstimmen.
Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von SslStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.
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.
Gilt für:
AuthenticateAsClient(String)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String)Parameter
Ausnahmen
targetHost ist null.
Bei der Authentifizierung ist ein Fehler aufgetreten, und dieses Objekt wurde in einem unbrauchbaren Zustand hinterlassen.
Die Authentifizierung ist bereits erfolgt.
- oder -
Eine Serverauthentifizierung mit diesem SslStream wurde bereits zuvor versucht.
- oder -
Die Authentifizierung läuft bereits.
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). Bei der Authentifizierung werden keine Clientzertifikate verwendet. Die Zertifikatsperrliste wird während der Authentifizierung nicht überprüft. Der für targetHost angegebene Wert muss mit dem Namen im Zertifikat des Servers übereinstimmen.
Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von SslStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.
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.
Gilt für:
AuthenticateAsClient(String, X509CertificateCollection, Boolean)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)Parameter
- 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 IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von SslStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.
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.
Hinweis
Clientzertifikate werden im SSL-Protokoll, Version 2, nicht unterstützt.
Gilt für:
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)Parameter
- 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 Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von SslStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.
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.
Hinweis
Clientzertifikate werden im SSL-Protokoll, Version 2, nicht unterstützt.
