NegotiateStream.AuthenticateAsServerAsync Methode

Definition

Namespace:

System.Net.Security

Assemblys:

netstandard.dll, System.Net.Security.dll

Behandelt die Serverseite einer Authentifizierung für eine Clientserververbindung als asynchronen Vorgang.

Überlädt

Name	Beschreibung
AuthenticateAsServerAsync()	Wird von Servern aufgerufen, um den Client und optional den Server in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren.
AuthenticateAsServerAsync(ExtendedProtectionPolicy)	Wird von Servern aufgerufen, um den Client und optional den Server in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebene erweiterte Schutzrichtlinie.
AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)	Wird von Servern aufgerufen, um den Client und optional den Server in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Serveranmeldeinformationen und Authentifizierungsoptionen.
AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)	Wird von Servern aufgerufen, um den Client und optional den Server in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Serveranmeldeinformationen, Authentifizierungsoptionen und erweiterte Schutzrichtlinie.

AuthenticateAsServerAsync()

Quelle:

NegotiateStream.cs

Wird von Servern aufgerufen, um den Client und optional den Server in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren.

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

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

AuthenticationException

Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.

InvalidCredentialException

Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

NotSupportedException

Windows 95 und Windows 98 werden nicht unterstützt.

Hinweise

Die Authentifizierung verwendet die 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 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.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AuthenticateAsServer().

AuthenticateAsServerAsync(ExtendedProtectionPolicy)

Quelle:

NegotiateStream.cs

Wird von Servern aufgerufen, um den Client und optional den Server in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebene erweiterte Schutzrichtlinie.

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

Dies ExtendedProtectionPolicy wird zum erweiterten Schutz verwendet.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentException

Die CustomChannelBinding im Parameter übergebene policy erweiterte CustomServiceNames Schutzrichtlinie ist beidesnull.

AuthenticationException

Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.

InvalidCredentialException

Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

PlatformNotSupportedException

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

NotSupportedException

Windows 95 und Windows 98 werden nicht unterstützt.

Hinweise

Die Authentifizierung verwendet die 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 lautetnull, wird eine erweiterte Schutzrichtlinie verwendet, die PolicyEnforcement auf .Never

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.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AuthenticateAsServer(ExtendedProtectionPolicy).

Weitere Informationen

• ExtendedProtectionPolicy
• Integrierte Windows-Authentifizierung unter Verwendung von "Erweiterter Schutz" (möglicherweise auf Englisch)

AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

Quelle:

NegotiateStream.cs

Wird von Servern aufgerufen, um den Client und optional den Server in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Serveranmeldeinformationen und Authentifizierungsoptionen.

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

Dies NetworkCredential wird verwendet, um die Identität des Servers einzurichten.

requiredProtectionLevel

ProtectionLevel

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

requiredImpersonationLevel

TokenImpersonationLevel

Einer der TokenImpersonationLevel Werte, der angibt, wie der Server die Anmeldeinformationen des Clients für den Zugriff auf Ressourcen verwenden kann.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentNullException

credential ist null.

ArgumentOutOfRangeException

requiredImpersonationLevel Identificationmuss , oder ImpersonationDelegation,

AuthenticationException

Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die R-Authentifizierung durchzuführen.

InvalidCredentialException

Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

InvalidOperationException

Die Authentifizierung ist bereits aufgetreten.

- oder -

Dieser Datenstrom wurde zuvor verwendet, um die Authentifizierung als Client zu versuchen. Sie können den Datenstrom nicht verwenden, um die Authentifizierung als Server erneut zu versuchen.

NotSupportedException

Windows 95 und Windows 98 werden nicht unterstützt.

Hinweise

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.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel).

AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)

Quelle:

NegotiateStream.cs

Wird von Servern aufgerufen, um den Client und optional den Server in einer Clientserververbindung als asynchronen Vorgang zu authentifizieren. Der Authentifizierungsprozess verwendet die angegebenen Serveranmeldeinformationen, Authentifizierungsoptionen und erweiterte Schutzrichtlinie.

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

Dies NetworkCredential wird verwendet, um die Identität des Clients einzurichten.

policy

ExtendedProtectionPolicy

Dies ExtendedProtectionPolicy wird zum erweiterten Schutz verwendet.

requiredProtectionLevel

ProtectionLevel

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

requiredImpersonationLevel

TokenImpersonationLevel

Einer der TokenImpersonationLevel Werte, der angibt, wie der Server die Anmeldeinformationen des Clients für den Zugriff auf Ressourcen verwenden kann.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentException

Die CustomChannelBinding im Parameter übergebene policy erweiterte CustomServiceNames Schutzrichtlinie ist beidesnull.

ArgumentNullException

credential ist null.

ArgumentOutOfRangeException

requiredImpersonationLevel Identificationmuss , oder ImpersonationDelegation,

AuthenticationException

Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die R-Authentifizierung durchzuführen.

InvalidCredentialException

Fehler bei der Authentifizierung. Sie können dieses Objekt verwenden, um die Authentifizierung erneut zu versuchen.

InvalidOperationException

Die Authentifizierung ist bereits aufgetreten.

- oder -

Dieser Datenstrom wurde zuvor verwendet, um die Authentifizierung als Client zu versuchen. Sie können den Datenstrom nicht verwenden, um die Authentifizierung als Server erneut zu versuchen.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

PlatformNotSupportedException

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

NotSupportedException

Windows 95 und Windows 98 werden nicht unterstützt.

Hinweise

Wenn der policy Parameter lautetnull, wird eine erweiterte Schutzrichtlinie verwendet, die PolicyEnforcement auf .Never

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.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel).

Weitere Informationen

• ExtendedProtectionPolicy
• Integrierte Windows-Authentifizierung unter Verwendung von "Erweiterter Schutz" (möglicherweise auf Englisch)