NegotiateStream.AuthenticateAsServer Methode

Definition

Behandelt die Serverseite einer Authentifizierung für eine Client-/Serververbindung.Handles the server side of an authentication for a client-server connection.

Überlädt

AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Clients und optional auch des Servers aufgerufen.Called by servers to authenticate the client, and optionally the server, in a client-server connection. Für den Authentifizierungsprozess werden die angegebenen Serveranmeldeinformationen, Authentifizierungsoptionen und die erweiterte Schutzrichtlinie verwendet.The authentication process uses the specified server credentials, authentication options, and extended protection policy.

AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Clients und optional auch des Servers aufgerufen.Called by servers to authenticate the client, and optionally the server, in a client-server connection. Beim Authentifizierungsprozess werden die angegebenen Serveranmeldeinformationen und die angegebenen Authentifizierungsoptionen verwendet.The authentication process uses the specified server credentials and authentication options.

AuthenticateAsServer()

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Clients und optional auch des Servers aufgerufen.Called by servers to authenticate the client, and optionally the server, in a client-server connection.

AuthenticateAsServer(ExtendedProtectionPolicy)

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Clients und optional auch des Servers aufgerufen.Called by servers to authenticate the client, and optionally the server, in a client-server connection. Für den Authentifizierungsprozess wird die angegebene erweiterte Schutzrichtlinie verwendet.The authentication process uses the specified extended protection policy.

Hinweise

Diese Methoden blockieren, während die Authentifizierung ausgeführt wird.These methods block while the authentication is in progress. Verwenden Sie die BeginAuthenticateAsServer-Methode, um zu verhindern, dass die Anwendung blockiert wird, während Sie auf den Abschluss der Authentifizierung wartet.To prevent the application from blocking while waiting for the authentication to complete, use the BeginAuthenticateAsServer method.

AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Clients und optional auch des Servers aufgerufen.Called by servers to authenticate the client, and optionally the server, in a client-server connection. Für den Authentifizierungsprozess werden die angegebenen Serveranmeldeinformationen, Authentifizierungsoptionen und die erweiterte Schutzrichtlinie verwendet.The authentication process uses the specified server credentials, authentication options, and extended protection policy.

public:
 virtual void AuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);
public virtual void AuthenticateAsServer (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
abstract member AuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
Public Overridable Sub AuthenticateAsServer (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel)

Parameter

credential
NetworkCredential

Die NetworkCredential zum Feststellen der Clientidentität.The NetworkCredential that is used to establish the identity of the client.

policy
ExtendedProtectionPolicy

Das für erweiterten Schutz verwendete ExtendedProtectionPolicy.The ExtendedProtectionPolicy that is used for extended protection.

requiredProtectionLevel
ProtectionLevel

Einer der ProtectionLevel-Werte, der die Sicherheitsdienste für den Stream angibt.One of the ProtectionLevel values, indicating the security services for the stream.

requiredImpersonationLevel
TokenImpersonationLevel

Einer der TokenImpersonationLevel-Werte, der angibt, wie der Server mit den Clientanmeldeinformationen auf Ressourcen zugreifen kann.One of the TokenImpersonationLevel values, indicating how the server can use the client's credentials to access resources.

Ausnahmen

CustomChannelBinding und CustomServiceNames für die erweiterte im policy-Parameter übergebene Schutzrichtlinie sind beide null.The CustomChannelBinding and CustomServiceNames on the extended protection policy passed in the policy parameter are both null.

credential ist null.credential is null.

requiredImpersonationLevel muss Identification, Impersonation oder Delegation sein.requiredImpersonationLevel must be Identification, Impersonation, or Delegation,

Fehler bei der Authentifizierung.The authentication failed. Sie können den Authentifizierungsversuch mithilfe dieses Objekt wiederholen.You can use this object to try to r-authenticate.

Fehler bei der Authentifizierung.The authentication failed. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.You can use this object to retry the authentication.

Die Authentifizierung ist bereits erfolgt.Authentication has already occurred.

- oder --or-

Dieser Stream wurde zuvor für einen Authentifizierungsversuch als Client verwendet.This stream was used previously to attempt authentication as the client. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Server zu wiederholen.You cannot use the stream to retry authentication as the server.

Windows 95 und Windows 98 werden nicht unterstützt.Windows 95 and Windows 98 are not supported.

Dieses Objekt wurde geschlossen.This object has been closed.

Der policy-Parameter wurde auf Always auf einer Plattform festgelegt, die keinen erweiterten Schutz unterstützt.The policy parameter was set to Always on a platform that does not support extended protection.

Hinweise

Wenn der policy-Parameter nullist, wird eine erweiterte Schutzrichtlinie verwendet, bei der PolicyEnforcement auf Neverfestgelegt ist.If the policy parameter is null, then an extended protection policy is used that has PolicyEnforcement set to Never.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die Eigenschaften des IsEncrypted und IsSigned überprüfen, um zu bestimmen, welche Sicherheitsdienste vom NegotiateStreamverwendet werden.When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated-Eigenschaft, um zu bestimmen, ob die gegenseitigeCheck the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Diese Methode wird blockiert, bis der Vorgang abgeschlossen ist.This method blocks until the operation completes. Um Blockierungen zu verhindern, bis der Vorgang abgeschlossen ist, verwenden Sie eine der BeginAuthenticateAsServer-Methoden Überladungen.To prevent blocking until the operation completes, use one of the BeginAuthenticateAsServer method overloads.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException oder eine InvalidCredentialException.If the authentication fails, you receive an AuthenticationException or an InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit anderen Anmelde Informationen wiederholen.In this case, you can retry the authentication with a different credential.

Siehe auch

AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Clients und optional auch des Servers aufgerufen.Called by servers to authenticate the client, and optionally the server, in a client-server connection. Beim Authentifizierungsprozess werden die angegebenen Serveranmeldeinformationen und die angegebenen Authentifizierungsoptionen verwendet.The authentication process uses the specified server credentials and authentication options.

public:
 virtual void AuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);
public virtual void AuthenticateAsServer (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
abstract member AuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
Public Overridable Sub AuthenticateAsServer (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel)

Parameter

credential
NetworkCredential

Die NetworkCredential zum Feststellen der Serveridentität.The NetworkCredential that is used to establish the identity of the server.

requiredProtectionLevel
ProtectionLevel

Einer der ProtectionLevel-Werte, der die Sicherheitsdienste für den Stream angibt.One of the ProtectionLevel values, indicating the security services for the stream.

requiredImpersonationLevel
TokenImpersonationLevel

Einer der TokenImpersonationLevel-Werte, der angibt, wie der Server mit den Clientanmeldeinformationen auf Ressourcen zugreifen kann.One of the TokenImpersonationLevel values, indicating how the server can use the client's credentials to access resources.

Ausnahmen

credential ist null.credential is null.

requiredImpersonationLevel muss Identification, Impersonation oder Delegation sein.requiredImpersonationLevel must be Identification, Impersonation, or Delegation,

Fehler bei der Authentifizierung.The authentication failed. Sie können den Authentifizierungsversuch mithilfe dieses Objekt wiederholen.You can use this object to try to r-authenticate.

Fehler bei der Authentifizierung.The authentication failed. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.You can use this object to retry the authentication.

Dieses Objekt wurde geschlossen.This object has been closed.

Die Authentifizierung ist bereits erfolgt.Authentication has already occurred.

- oder --or-

Dieser Stream wurde zuvor für einen Authentifizierungsversuch als Client verwendet.This stream was used previously to attempt authentication as the client. Sie können den Stream nicht verwenden, um den Authentifizierungsversuch als Server zu wiederholen.You cannot use the stream to retry authentication as the server.

Windows 95 und Windows 98 werden nicht unterstützt.Windows 95 and Windows 98 are not supported.

Hinweise

Wenn die Authentifizierung erfolgreich ist, müssen Sie die Eigenschaften des IsEncrypted und IsSigned überprüfen, um zu bestimmen, welche Sicherheitsdienste vom NegotiateStreamverwendet werden.When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated-Eigenschaft, um zu bestimmen, ob die gegenseitigeCheck the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Diese Methode wird blockiert, bis der Vorgang abgeschlossen ist.This method blocks until the operation completes. Um Blockierungen zu verhindern, bis der Vorgang abgeschlossen ist, verwenden Sie eine der BeginAuthenticateAsServer-Methoden Überladungen.To prevent blocking until the operation completes, use one of the BeginAuthenticateAsServer method overloads.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException oder eine InvalidCredentialException.If the authentication fails, you receive an AuthenticationException or an InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit anderen Anmelde Informationen wiederholen.In this case, you can retry the authentication with a different credential.

Sicherheit

SecurityPermission
, wenn das explizite NetworkCredentialverwendet werden soll.to use the explicit NetworkCredential. Zugeordnete Enumeration: ControlPrincipalAssociated enumeration: ControlPrincipal.

AuthenticateAsServer()

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Clients und optional auch des Servers aufgerufen.Called by servers to authenticate the client, and optionally the server, in a client-server connection.

public:
 virtual void AuthenticateAsServer();
public virtual void AuthenticateAsServer ();
abstract member AuthenticateAsServer : unit -> unit
override this.AuthenticateAsServer : unit -> unit
Public Overridable Sub AuthenticateAsServer ()

Ausnahmen

Fehler bei der Authentifizierung.The authentication failed. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.You can use this object to retry the authentication.

Fehler bei der Authentifizierung.The authentication failed. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.You can use this object to retry the authentication.

Dieses Objekt wurde geschlossen.This object has been closed.

Windows 95 und Windows 98 werden nicht unterstützt.Windows 95 and Windows 98 are not supported.

Hinweise

Bei der Authentifizierung wird die DefaultCredentialsdes Servers verwendet.The authentication uses the server's DefaultCredentials. Es wurde kein Dienst Prinzipal Name (Service Principal Name, SPN) für den Server angegeben.No Service Principal Name (SPN) is specified for the server. Die Identitätswechsel Ebene ist Identification, und die Sicherheitsstufe ist EncryptAndSign.The impersonation level is Identification, and the security level is EncryptAndSign.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die Eigenschaften des IsEncrypted und IsSigned überprüfen, um zu bestimmen, welche Sicherheitsdienste vom NegotiateStreamverwendet werden.When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated-Eigenschaft, um zu bestimmen, ob die gegenseitigeCheck the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Diese Methode wird blockiert, bis der Vorgang abgeschlossen ist.This method blocks until the operation completes. Um Blockierungen zu verhindern, bis der Vorgang abgeschlossen ist, verwenden Sie eine der BeginAuthenticateAsServer-Methoden Überladungen.To prevent blocking until the operation completes, use one of the BeginAuthenticateAsServer method overloads.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException oder eine InvalidCredentialException.If the authentication fails, you receive an AuthenticationException or an InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit anderen Anmelde Informationen wiederholen.In this case, you can retry the authentication with a different credential.

Sicherheit

SecurityPermission
, wenn das explizite NetworkCredentialverwendet werden soll.to use the explicit NetworkCredential. Zugeordnete Enumeration: ControlPrincipalAssociated enumeration: ControlPrincipal.

AuthenticateAsServer(ExtendedProtectionPolicy)

Wird bei einer Client-/Serververbindung von Servern zum Authentifizieren des Clients und optional auch des Servers aufgerufen.Called by servers to authenticate the client, and optionally the server, in a client-server connection. Für den Authentifizierungsprozess wird die angegebene erweiterte Schutzrichtlinie verwendet.The authentication process uses the specified extended protection policy.

public:
 virtual void AuthenticateAsServer(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy);
public virtual void AuthenticateAsServer (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy);
abstract member AuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> unit
override this.AuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> unit
Public Overridable Sub AuthenticateAsServer (policy As ExtendedProtectionPolicy)

Parameter

policy
ExtendedProtectionPolicy

Das für erweiterten Schutz verwendete ExtendedProtectionPolicy.The ExtendedProtectionPolicy that is used for extended protection.

Ausnahmen

CustomChannelBinding und CustomServiceNames für die erweiterte im policy-Parameter übergebene Schutzrichtlinie sind beide null.The CustomChannelBinding and CustomServiceNames on the extended protection policy passed in the policy parameter are both null.

Fehler bei der Authentifizierung.The authentication failed. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.You can use this object to retry the authentication.

Fehler bei der Authentifizierung.The authentication failed. Sie können die Authentifizierung mithilfe dieses Objekts wiederholen.You can use this object to retry the authentication.

Windows 95 und Windows 98 werden nicht unterstützt.Windows 95 and Windows 98 are not supported.

Dieses Objekt wurde geschlossen.This object has been closed.

Der policy-Parameter wurde auf Always auf einer Plattform festgelegt, die keinen erweiterten Schutz unterstützt.The policy parameter was set to Always on a platform that does not support extended protection.

Hinweise

Bei der Authentifizierung wird die DefaultCredentialsdes Servers verwendet.The authentication uses the server's DefaultCredentials. Es wurde kein Dienst Prinzipal Name (Service Principal Name, SPN) für den Server angegeben.No Service Principal Name (SPN) is specified for the server. Die Identitätswechsel Ebene ist Identification, und die Sicherheitsstufe ist EncryptAndSign.The impersonation level is Identification, and the security level is EncryptAndSign.

Wenn der policy-Parameter nullist, wird eine erweiterte Schutzrichtlinie verwendet, bei der PolicyEnforcement auf Neverfestgelegt ist.If the policy parameter is null, then an extended protection policy is used that has PolicyEnforcement set to Never.

Wenn die Authentifizierung erfolgreich ist, müssen Sie die Eigenschaften des IsEncrypted und IsSigned überprüfen, um zu bestimmen, welche Sicherheitsdienste vom NegotiateStreamverwendet werden.When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream. Überprüfen Sie die IsMutuallyAuthenticated-Eigenschaft, um zu bestimmen, ob die gegenseitigeCheck the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Diese Methode wird blockiert, bis der Vorgang abgeschlossen ist.This method blocks until the operation completes. Um Blockierungen zu verhindern, bis der Vorgang abgeschlossen ist, verwenden Sie eine der BeginAuthenticateAsServer-Methoden Überladungen.To prevent blocking until the operation completes, use one of the BeginAuthenticateAsServer method overloads.

Wenn die Authentifizierung fehlschlägt, erhalten Sie eine AuthenticationException oder eine InvalidCredentialException.If the authentication fails, you receive an AuthenticationException or an InvalidCredentialException. In diesem Fall können Sie die Authentifizierung mit anderen Anmelde Informationen wiederholen.In this case, you can retry the authentication with a different credential.

Siehe auch

Gilt für: