Freigeben über


NegotiateStream.AuthenticateAsClient Methode

Definition

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

targetName ist null.

- oder -

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

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

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

targetName ist null.

- oder -

credential ist null.

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

Gilt für: