NegotiateStream.AuthenticateAsClient Methode

Definition

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen.

Überlädt

AuthenticateAsClient()

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen.

AuthenticateAsClient(NetworkCredential, String)

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen. Für den Authentifizierungsprozess werden die angegebenen Clientanmeldeinformationen verwendet.

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen. Für den Authentifizierungsprozess werden die angegebenen Clientanmeldeinformationen und die Channelbindung verwendet.

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen. Beim Authentifizierungsprozess werden die angegebenen Anmeldeinformationen und Authentifizierungsoptionen verwendet.

AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen. Für den Authentifizierungsprozess werden die angegebenen Anmeldeinformationen, Authentifizierungsoptionen und die Channelbindung verwendet.

AuthenticateAsClient()

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen.

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 die Authentifizierung mithilfe dieses Objekts wiederholen.

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Dieses Objekt wurde geschlossen.

Die Authentifizierung ist bereits erfolgt.

  • oder -

Dieser Stream wurde zuvor für einen Authentifizierungsversuch als Server verwendet. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Client zu wiederholen.

Hinweise

Die Authentifizierung verwendet die Client DefaultCredentials. Für den Server wird kein Dienstprinzipalname (SERVICE Principal Name, SPN) angegeben. Die Identitätswechselebene ist Identification, die Sicherheitsstufe ist EncryptAndSign, und die gegenseitige Authentifizierung wird angefordert. Die NegotiateStream Klasse erstellt das SPN, das für die gegenseitige Authentifizierung verwendet wird.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Und-Eigenschaften IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von der NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung aufgetreten ist.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine oder eine AuthenticationException InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit einer anderen Anmeldeinformationen wiederholen.

Gilt für

AuthenticateAsClient(NetworkCredential, String)

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen. Für den Authentifizierungsprozess werden die angegebenen Clientanmeldeinformationen verwendet.

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

Die NetworkCredential zum Feststellen der Clientidentität.

targetName
String

Der SPN, der den zu authentifizierenden Server eindeutig identifiziert.

Ausnahmen

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Dieses Objekt wurde geschlossen.

Die Authentifizierung ist bereits erfolgt.

  • oder -

Dieser Stream wurde zuvor für einen Authentifizierungsversuch als Server verwendet. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Client zu wiederholen.

targetName ist null.

Hinweise

Die Identitätswechselebene ist Identification, die Sicherheitsstufe ist EncryptAndSign, und die gegenseitige Authentifizierung wird angefordert. Die NegotiateStream Klasse erstellt das SPN, das für die gegenseitige Authentifizierung verwendet wird.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Und-Eigenschaften IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von der NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung aufgetreten ist.

Gilt für

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen. Für den Authentifizierungsprozess werden die angegebenen Clientanmeldeinformationen und die Channelbindung verwendet.

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

Die NetworkCredential zum Feststellen der Clientidentität.

binding
ChannelBinding

Das für erweiterten Schutz verwendete ChannelBinding.

targetName
String

Der SPN, der den zu authentifizierenden Server eindeutig identifiziert.

Ausnahmen

targetName ist null.

- oder - credential ist null.

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Die Authentifizierung ist bereits erfolgt.

  • oder -

Dieser Stream wurde zuvor für einen Authentifizierungsversuch als Server verwendet. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Client zu wiederholen.

Dieses Objekt wurde geschlossen.

Hinweise

Die Identitätswechselebene ist Identification, die Sicherheitsstufe ist EncryptAndSign, und die gegenseitige Authentifizierung wird angefordert. Die NegotiateStream Klasse erstellt das SPN, das für die gegenseitige Authentifizierung verwendet wird.

Der ChannelBinding für erweiterten Schutz verwendete, der an diese Methode im binding Parameter übergeben wird, wird von einer Anwendung aus TransportContext der Eigenschaft des zugeordneten SslStreamObjekts abgerufen.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Und-Eigenschaften IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von der NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated Eigenschaft, um festzustellen, ob die gegenseitige Authentifizierung aufgetreten ist.

Siehe auch

Gilt für

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen. Beim Authentifizierungsprozess werden die angegebenen Anmeldeinformationen und Authentifizierungsoptionen verwendet.

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

Die NetworkCredential zum Feststellen der Clientidentität.

targetName
String

Der SPN, der den zu authentifizierenden Server eindeutig identifiziert.

requiredProtectionLevel
ProtectionLevel

Einer der ProtectionLevel-Werte, der die Sicherheitsdienste für den Stream angibt.

allowedImpersonationLevel
TokenImpersonationLevel

Einer der TokenImpersonationLevel-Werte, der angibt, wie der Server mit den Clientanmeldeinformationen auf Ressourcen zugreifen kann.

Ausnahmen

"allowedImpersonationLevel" ist kein gültiger Wert.

targetName ist NULL.

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Dieses Objekt wurde geschlossen.

Die Authentifizierung ist bereits erfolgt.

  • oder -

Dieser Stream wurde zuvor für einen Authentifizierungsversuch als Server verwendet. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Client zu wiederholen.

Hinweise

Verwenden Sie den Parameter, um Sicherheitsdienste für Daten anzufordern, die requiredProtectionLevel mithilfe des authentifizierten Datenstroms übertragen werden. Geben Sie beispielsweise den Wert an EncryptAndSign , um die Daten verschlüsselt und signiert zu haben. Die erfolgreiche Authentifizierung garantiert nicht, dass die angeforderte ProtectionLevel Authentifizierung erteilt wurde. Sie müssen die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu ermitteln, welche Sicherheitsdienste von dem NegotiateStreamverwendet werden.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine oder eine AuthenticationException InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit einer anderen Anmeldeinformationen wiederholen.

Gilt für

AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

Wird bei einer Client-/Serververbindung von Clients zum Authentifizieren des Clients und optional auch des Servers aufgerufen. Für den Authentifizierungsprozess werden die angegebenen Anmeldeinformationen, Authentifizierungsoptionen und die Channelbindung verwendet.

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

Die NetworkCredential zum Feststellen der Clientidentität.

binding
ChannelBinding

Das für erweiterten Schutz verwendete ChannelBinding.

targetName
String

Der SPN, der den zu authentifizierenden Server eindeutig identifiziert.

requiredProtectionLevel
ProtectionLevel

Einer der ProtectionLevel-Werte, der die Sicherheitsdienste für den Stream angibt.

allowedImpersonationLevel
TokenImpersonationLevel

Einer der TokenImpersonationLevel-Werte, der angibt, wie der Server mit den Clientanmeldeinformationen auf Ressourcen zugreifen kann.

Ausnahmen

targetName ist null.

- oder - credential ist null.

"allowedImpersonationLevel" ist kein gültiger Wert.

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Fehler bei der Authentifizierung. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.

Die Authentifizierung ist bereits erfolgt.

  • oder -

Dieser Stream wurde zuvor für einen Authentifizierungsversuch als Server verwendet. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Client zu wiederholen.

Dieses Objekt wurde geschlossen.

Hinweise

Verwenden Sie den Parameter, um Sicherheitsdienste für Daten anzufordern, die requiredProtectionLevel mithilfe des authentifizierten Datenstroms übertragen werden. Geben Sie beispielsweise den Wert an EncryptAndSign , um die Daten verschlüsselt und signiert zu haben. Die erfolgreiche Authentifizierung garantiert nicht, dass die angeforderte ProtectionLevel Authentifizierung erteilt wurde. Sie müssen die und IsSigned die IsEncrypted Eigenschaften überprüfen, um zu ermitteln, welche Sicherheitsdienste von dem NegotiateStreamverwendet werden.

Der ChannelBinding für den erweiterten Schutz verwendete, der an diese Methode im Parameter übergeben wird, wird von einer Anwendung aus TransportContext der Eigenschaft auf dem binding zugehörigen SslStreamabgerufen.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine oder eine AuthenticationException InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit einer anderen Anmeldeinformationen wiederholen.

Siehe auch

Gilt für