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 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()
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
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 -> unitPublic 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 des Clients 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 den SPN, der für die gegenseitige Authentifizierung verwendet wird.
Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von NegotiateStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um zu ermitteln, ob eine gegenseitige Authentifizierung erfolgt ist.
Wenn die Authentifizierung fehlschlägt, erhalten Sie oder AuthenticationException .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
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 -> unitPublic 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 den SPN, der für die gegenseitige Authentifizierung verwendet wird.
Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von NegotiateStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um zu ermitteln, ob eine gegenseitige Authentifizierung erfolgt ist.
Gilt für:
AuthenticateAsClient(NetworkCredential, ChannelBinding, String)
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
- Quelle:
- NegotiateStream.cs
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 -> unitPublic 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
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 den SPN, der für die gegenseitige Authentifizierung verwendet wird.
Der ChannelBinding für den erweiterten Schutz verwendet wird, der binding im -Parameter an diese Methode übergeben wird, wird von einer Anwendung aus der TransportContext -Eigenschaft des zugeordneten SslStreamabgerufen.
Wenn die Authentifizierung erfolgreich ist, müssen Sie die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von NegotiateStreamverwendet werden. Überprüfen Sie die IsMutuallyAuthenticated -Eigenschaft, um zu ermitteln, ob eine gegenseitige Authentifizierung erfolgt 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
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 -> unitPublic 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 requiredProtectionLevel -Parameter, um Sicherheitsdienste für Daten anzufordern, die mithilfe des authentifizierten Datenstroms übertragen werden. Geben Sie EncryptAndSign beispielsweise den Wert an, um die Daten verschlüsselt und signiert zu lassen. Eine erfolgreiche Authentifizierung garantiert nicht, dass die angeforderte ProtectionLevel gewährt wurde. Sie müssen die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu bestimmen, welche Sicherheitsdienste von NegotiateStreamverwendet werden.
Wenn die Authentifizierung fehlschlägt, erhalten Sie oder AuthenticationException .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
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 -> unitPublic 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
"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 requiredProtectionLevel -Parameter, um Sicherheitsdienste für Daten anzufordern, die mit dem authentifizierten Stream übertragen werden. Geben Sie beispielsweise den EncryptAndSign Wert an, um die Daten verschlüsselt und signiert zu lassen. Eine erfolgreiche Authentifizierung garantiert nicht, dass das angeforderte ProtectionLevel gewährt wurde. Sie müssen die IsEncrypted Eigenschaften und IsSigned überprüfen, um zu ermitteln, welche Sicherheitsdienste von NegotiateStreamverwendet werden.
Die ChannelBinding für den erweiterten Schutz verwendete, die an diese Methode im binding -Parameter übergeben wird, wird von einer Anwendung aus der TransportContext -Eigenschaft für die zugeordnete SslStreamabgerufen.
Wenn die Authentifizierung fehlschlägt, erhalten Sie ein AuthenticationException oder ein 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)
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für