NegotiateStream.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.
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren.
Überlädt
| Name | Beschreibung |
|---|---|
| AuthenticateAsClient() |
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. |
| AuthenticateAsClient(NetworkCredential, String) |
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Clientanmeldeinformationen. |
| AuthenticateAsClient(NetworkCredential, ChannelBinding, String) |
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Clientanmeldeinformationen und die Kanalbindung. |
| AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel) |
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Anmeldeinformationen und Authentifizierungsoptionen. |
| AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel) |
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Anmeldeinformationen, Authentifizierungsoptionen und Kanalbindung. |
AuthenticateAsClient()
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren.
public:
virtual void AuthenticateAsClient();
public virtual void AuthenticateAsClient();
abstract member AuthenticateAsClient : unit -> unit
override this.AuthenticateAsClient : unit -> unit
Public Overridable Sub AuthenticateAsClient ()
Ausnahmen
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Dieses Objekt wurde geschlossen.
Die Authentifizierung ist bereits aufgetreten.
- oder -
Dieser Datenstrom wurde zuvor verwendet, um die Authentifizierung als Server zu versuchen. Sie können den Datenstrom nicht verwenden, um die Authentifizierung als Client erneut zu versuchen.
Hinweise
Die Authentifizierung verwendet die Client.DefaultCredentials Für den Server wird kein Dienstprinzipalname (Service Principal Name, SPN) angegeben. Die Identitätswechselebene lautet Identification, die Sicherheitsstufe ist EncryptAndSign, und die gegenseitige Authentifizierung wird angefordert. Die NegotiateStream Klasse erstellt den SPN, der für die gegenseitige Authentifizierung verwendet wird.
Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu ermitteln, ob die gegenseitige Authentifizierung aufgetreten ist.
Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException oder eine InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit anderen Anmeldeinformationen wiederholen.
Gilt für:
AuthenticateAsClient(NetworkCredential, String)
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Clientanmeldeinformationen.
public:
virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::String ^ targetName);
public virtual void AuthenticateAsClient(System.Net.NetworkCredential credential, string targetName);
abstract member AuthenticateAsClient : System.Net.NetworkCredential * string -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * string -> unit
Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, targetName As String)
Parameter
- credential
- NetworkCredential
Dies NetworkCredential wird verwendet, um die Identität des Clients einzurichten.
- targetName
- String
Der Dienstprinzipalname (Service Principal Name, SPN), der den zu authentifizierden Server eindeutig identifiziert.
Ausnahmen
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Dieses Objekt wurde geschlossen.
Die Authentifizierung ist bereits aufgetreten.
- oder -
Dieser Datenstrom wurde zuvor verwendet, um die Authentifizierung als Server zu versuchen. Sie können den Datenstrom nicht verwenden, um die Authentifizierung als Client erneut zu versuchen.
targetName ist null.
Hinweise
Die Identitätswechselebene lautet Identification, die Sicherheitsstufe ist EncryptAndSign, und die gegenseitige Authentifizierung wird angefordert. Die NegotiateStream Klasse erstellt den SPN, der für die gegenseitige Authentifizierung verwendet wird.
Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu ermitteln, ob die gegenseitige Authentifizierung aufgetreten ist.
Gilt für:
AuthenticateAsClient(NetworkCredential, ChannelBinding, String)
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Clientanmeldeinformationen und die Kanalbindung.
public:
virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);
public virtual void AuthenticateAsClient(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);
public virtual void AuthenticateAsClient(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName);
abstract member AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> unit
Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, binding As ChannelBinding, targetName As String)
Parameter
- credential
- NetworkCredential
Dies NetworkCredential wird verwendet, um die Identität des Clients einzurichten.
- binding
- ChannelBinding
Dies ChannelBinding wird zum erweiterten Schutz verwendet.
- targetName
- String
Der Dienstprinzipalname (Service Principal Name, SPN), der den zu authentifizierden Server eindeutig identifiziert.
Ausnahmen
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Die Authentifizierung ist bereits aufgetreten.
- oder -
Dieser Datenstrom wurde zuvor verwendet, um die Authentifizierung als Server zu versuchen. Sie können den Datenstrom nicht verwenden, um die Authentifizierung als Client erneut zu versuchen.
Dieses Objekt wurde geschlossen.
Hinweise
Die Identitätswechselebene lautet Identification, die Sicherheitsstufe ist EncryptAndSign, und die gegenseitige Authentifizierung wird angefordert. Die NegotiateStream Klasse erstellt den SPN, der für die gegenseitige Authentifizierung verwendet wird.
Der ChannelBinding für den erweiterten Schutz verwendete Schutz, der binding an diese Methode im Parameter übergeben wird, würde von einer Anwendung aus TransportContext der Eigenschaft des zugeordneten SslStreamabgerufen werden.
Wenn die Authentifizierung erfolgreich ist, müssen Sie die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um zu ermitteln, ob die gegenseitige Authentifizierung aufgetreten ist.
Weitere Informationen
- ChannelBinding
- Integrierte Windows-Authentifizierung unter Verwendung von "Erweiterter Schutz" (möglicherweise auf Englisch)
Gilt für:
AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Anmeldeinformationen und Authentifizierungsoptionen.
public:
virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);
public virtual void AuthenticateAsClient(System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);
abstract member AuthenticateAsClient : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel)
Parameter
- credential
- NetworkCredential
Dies NetworkCredential wird verwendet, um die Identität des Clients einzurichten.
- targetName
- String
Der Dienstprinzipalname (Service Principal Name, SPN), der den zu authentifizierden Server eindeutig identifiziert.
- requiredProtectionLevel
- ProtectionLevel
Einer der ProtectionLevel Werte, der die Sicherheitsdienste für den Datenstrom angibt.
- allowedImpersonationLevel
- TokenImpersonationLevel
Einer der TokenImpersonationLevel Werte, der angibt, wie der Server die Anmeldeinformationen des Clients für den Zugriff auf Ressourcen verwenden kann.
Ausnahmen
allowedImpersonationLevel ist kein gültiger Wert.
targetName ist NULL.
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Dieses Objekt wurde geschlossen.
Die Authentifizierung ist bereits aufgetreten.
- oder -
Dieser Datenstrom wurde zuvor verwendet, um die Authentifizierung als Server zu versuchen. Sie können den Datenstrom nicht verwenden, um die Authentifizierung als Client erneut zu versuchen.
Hinweise
Verwenden Sie den requiredProtectionLevel Parameter, um Sicherheitsdienste für daten anzufordern, die mithilfe des authentifizierten Datenstroms übertragen werden. Um beispielsweise die Daten verschlüsselt und signiert zu haben, geben Sie den EncryptAndSign Wert an. Die erfolgreiche Authentifizierung garantiert nicht, dass die angeforderte ProtectionLevel Authentifizierung gewährt wurde. Sie müssen die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der NegotiateStream.
Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException oder eine InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit anderen Anmeldeinformationen wiederholen.
Gilt für:
AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
Wird von Clients aufgerufen, um den Client und optional den Server in einer Clientserververbindung zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Anmeldeinformationen, Authentifizierungsoptionen und Kanalbindung.
public:
virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);
public virtual void AuthenticateAsClient(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);
public virtual void AuthenticateAsClient(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);
abstract member AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel)
Parameter
- credential
- NetworkCredential
Dies NetworkCredential wird verwendet, um die Identität des Clients einzurichten.
- binding
- ChannelBinding
Dies ChannelBinding wird zum erweiterten Schutz verwendet.
- targetName
- String
Der Dienstprinzipalname (Service Principal Name, SPN), der den zu authentifizierden Server eindeutig identifiziert.
- requiredProtectionLevel
- ProtectionLevel
Einer der ProtectionLevel Werte, der die Sicherheitsdienste für den Datenstrom angibt.
- allowedImpersonationLevel
- TokenImpersonationLevel
Einer der TokenImpersonationLevel Werte, der angibt, wie der Server die Anmeldeinformationen des Clients für den Zugriff auf Ressourcen verwenden kann.
Ausnahmen
allowedImpersonationLevel ist kein gültiger Wert.
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.
Die Authentifizierung ist bereits aufgetreten.
- oder -
Dieser Datenstrom wurde zuvor verwendet, um die Authentifizierung als Server zu versuchen. Sie können den Datenstrom nicht verwenden, um die Authentifizierung als Client erneut zu versuchen.
Dieses Objekt wurde geschlossen.
Hinweise
Verwenden Sie den requiredProtectionLevel Parameter, um Sicherheitsdienste für daten anzufordern, die mithilfe des authentifizierten Datenstroms übertragen werden. Um beispielsweise die Daten verschlüsselt und signiert zu haben, geben Sie den EncryptAndSign Wert an. Die erfolgreiche Authentifizierung garantiert nicht, dass die angeforderte ProtectionLevel Authentifizierung gewährt wurde. Sie müssen die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu bestimmen, welche Sicherheitsdienste von der NegotiateStream.
Der ChannelBinding für den erweiterten Schutz verwendete Schutz, der binding an diese Methode im Parameter übergeben wird, würde von einer Anwendung aus TransportContext der Eigenschaft des zugeordneten SslStreamabgerufen werden.
Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException oder eine InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit anderen Anmeldeinformationen wiederholen.
Weitere Informationen
- ChannelBinding
- Integrierte Windows-Authentifizierung unter Verwendung von "Erweiterter Schutz" (möglicherweise auf Englisch)