Freigeben über


NegotiateStream.AuthenticateAsServerAsync Methode

Definition

Behandelt die Serverseite für eine Authentifizierung einer Client-/Serververbindung als eines asynchronen Vorgang.

Überlädt

AuthenticateAsServerAsync()

Wird von Servern zur Authentifizierung des Clients und optional auch des Servers aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang.

AuthenticateAsServerAsync(ExtendedProtectionPolicy)

Wird von Servern zur Authentifizierung des Clients und optional auch des Servers aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Für den Authentifizierungsprozess wird die angegebene erweiterte Schutzrichtlinie verwendet.

AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

Wird von Servern zur Authentifizierung des Clients und optional auch des Servers aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Beim Authentifizierungsprozess werden die angegebenen Serveranmeldeinformationen und die angegebenen Authentifizierungsoptionen verwendet.

AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)

Wird von Servern zur Authentifizierung des Clients und optional auch des Servers aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Für den Authentifizierungsprozess werden die angegebenen Serveranmeldeinformationen, Authentifizierungsoptionen und die erweiterte Schutzrichtlinie verwendet.

AuthenticateAsServerAsync()

Quelle:
NegotiateStream.cs
Quelle:
NegotiateStream.cs
Quelle:
NegotiateStream.cs

Wird von Servern zur Authentifizierung des Clients und optional auch des Servers aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync();
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync ();
abstract member AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync () As Task

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

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.

Windows 95 und Windows 98 werden nicht unterstützt.

Hinweise

Die Authentifizierung verwendet den Server.DefaultCredentials Für den Server wird kein Dienstprinzipalname (Service Principal Name, SPN) angegeben. Die Identitätswechselebene ist Identification, und die Sicherheitsstufe ist EncryptAndSign.

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 festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.

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

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten AuthenticateAsServer()Ausnahmen.

Gilt für:

AuthenticateAsServerAsync(ExtendedProtectionPolicy)

Quelle:
NegotiateStream.cs
Quelle:
NegotiateStream.cs
Quelle:
NegotiateStream.cs

Wird von Servern zur Authentifizierung des Clients und optional auch des Servers aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Für den Authentifizierungsprozess wird die angegebene erweiterte Schutzrichtlinie verwendet.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy);
abstract member AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (policy As ExtendedProtectionPolicy) As Task

Parameter

policy
ExtendedProtectionPolicy

Das für erweiterten Schutz verwendete ExtendedProtectionPolicy.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

CustomChannelBinding und CustomServiceNames für die erweiterte im policy-Parameter übergebene Schutzrichtlinie sind beide 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.

Der policy-Parameter wurde auf Always auf einer Plattform festgelegt, die keinen erweiterten Schutz unterstützt.

Windows 95 und Windows 98 werden nicht unterstützt.

Hinweise

Die Authentifizierung verwendet den Server.DefaultCredentials Für den Server wird kein Dienstprinzipalname (Service Principal Name, SPN) angegeben. Die Identitätswechselebene ist Identification, und die Sicherheitsstufe ist EncryptAndSign.

Wenn der policy Parameter istnull, wird eine erweiterte Schutzrichtlinie verwendet, die auf Neverfestgelegt istPolicyEnforcement.

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 festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.

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

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten AuthenticateAsServer(ExtendedProtectionPolicy)Ausnahmen.

Weitere Informationen

Gilt für:

AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

Quelle:
NegotiateStream.cs
Quelle:
NegotiateStream.cs
Quelle:
NegotiateStream.cs

Wird von Servern zur Authentifizierung des Clients und optional auch des Servers aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Beim Authentifizierungsprozess werden die angegebenen Serveranmeldeinformationen und die angegebenen Authentifizierungsoptionen verwendet.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As Task

Parameter

credential
NetworkCredential

Die NetworkCredential zum Feststellen der Serveridentität.

requiredProtectionLevel
ProtectionLevel

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

requiredImpersonationLevel
TokenImpersonationLevel

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

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

credential ist null.

requiredImpersonationLevel muss Identification, Impersonation oder Delegation sein.

Fehler bei der Authentifizierung. Sie können den Authentifizierungsversuch mithilfe dieses Objekt 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 Client verwendet. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Server zu wiederholen.

Windows 95 und Windows 98 werden nicht unterstützt.

Hinweise

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 festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.

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

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)Ausnahmen.

Gilt für:

AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)

Quelle:
NegotiateStream.cs
Quelle:
NegotiateStream.cs
Quelle:
NegotiateStream.cs

Wird von Servern zur Authentifizierung des Clients und optional auch des Servers aufgerufen, bei einer Client-/Serververbindungen als asynchroner Vorgang. Für den Authentifizierungsprozess werden die angegebenen Serveranmeldeinformationen, Authentifizierungsoptionen und die erweiterte Schutzrichtlinie verwendet.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As Task

Parameter

credential
NetworkCredential

Die NetworkCredential zum Feststellen der Clientidentität.

policy
ExtendedProtectionPolicy

Das für erweiterten Schutz verwendete ExtendedProtectionPolicy.

requiredProtectionLevel
ProtectionLevel

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

requiredImpersonationLevel
TokenImpersonationLevel

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

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

CustomChannelBinding und CustomServiceNames für die erweiterte im policy-Parameter übergebene Schutzrichtlinie sind beide null.

credential ist null.

requiredImpersonationLevel muss Identification, Impersonation oder Delegation sein.

Fehler bei der Authentifizierung. Sie können den Authentifizierungsversuch mithilfe dieses Objekt 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 Client verwendet. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Server zu wiederholen.

Dieses Objekt wurde geschlossen.

Der policy-Parameter wurde auf Always auf einer Plattform festgelegt, die keinen erweiterten Schutz unterstützt.

Windows 95 und Windows 98 werden nicht unterstützt.

Hinweise

Wenn der policy Parameter istnull, wird eine erweiterte Schutzrichtlinie verwendet, die auf Neverfestgelegt istPolicyEnforcement.

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 festzustellen, ob die gegenseitige Authentifizierung stattgefunden hat.

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

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)Ausnahmen.

Weitere Informationen

Gilt für: