NegotiateStream.AuthenticateAsClient 方法

参考

定义

命名空间:: System.Net.Security

程序集:: System.Net.Security.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。

重载

AuthenticateAsClient()	客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。
AuthenticateAsClient(NetworkCredential, String)	客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。身份验证过程使用指定的客户端凭据。
AuthenticateAsClient(NetworkCredential, ChannelBinding, String)	客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。身份验证过程使用指定的客户端凭据和通道绑定。
AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。身份验证过程使用指定的凭据和身份验证选项。
AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。身份验证过程使用指定的凭据、身份验证选项和通道绑定。

AuthenticateAsClient()

客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。

public:
 virtual void AuthenticateAsClient();

public virtual void AuthenticateAsClient ();

abstract member AuthenticateAsClient : unit -> unit
override this.AuthenticateAsClient : unit -> unit

Public Overridable Sub AuthenticateAsClient ()

例外

AuthenticationException

身份验证失败。可以使用此对象尝试重新进行身份验证。

InvalidCredentialException

身份验证失败。可以使用此对象尝试重新进行身份验证。

ObjectDisposedException

此对象已关闭。

InvalidOperationException

已进行了身份验证。

或 -

此流先前被尝试作为服务器进行身份验证。不能尝试将该流作为客户端重新进行身份验证。

注解

身份验证使用客户端的 DefaultCredentials。未为服务器指定任何服务主体名称 (SPN) 。模拟级别为 Identification，安全级别为 EncryptAndSign，并请求相互身份验证。该 NegotiateStream 类将构造用于相互身份验证的 SPN。

身份验证成功后，必须检查 IsEncrypted 和 IsSigned 属性以确定哪些安全服务由该 NegotiateStream服务使用。检查属性 IsMutuallyAuthenticated 以确定是否发生了相互身份验证。

如果身份验证失败，将收到一个或一个 AuthenticationException InvalidCredentialException。在这种情况下，可以使用其他凭据重试身份验证。

适用于

AuthenticateAsClient(NetworkCredential, String)

客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。身份验证过程使用指定的客户端凭据。

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)

参数

credential: NetworkCredential

用于确立客户端身份的 NetworkCredential。

targetName: String

唯一标识要进行身份验证的服务器的服务主体名称 (SPN)。

例外

AuthenticationException

身份验证失败。可以使用此对象尝试重新进行身份验证。

InvalidCredentialException

身份验证失败。可以使用此对象尝试重新进行身份验证。

ObjectDisposedException

此对象已关闭。

InvalidOperationException

已进行了身份验证。

或 -

此流先前被尝试作为服务器进行身份验证。不能尝试将该流作为客户端重新进行身份验证。

ArgumentNullException

targetName 为 null。

注解

模拟级别为 Identification，安全级别为 EncryptAndSign，并请求相互身份验证。该 NegotiateStream 类将构造用于相互身份验证的 SPN。

适用于

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。身份验证过程使用指定的客户端凭据和通道绑定。

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)

参数

credential: NetworkCredential

用于确立客户端身份的 NetworkCredential。

binding: ChannelBinding

用于扩展保护的 ChannelBinding。

targetName: String

唯一标识要进行身份验证的服务器的服务主体名称 (SPN)。

例外

ArgumentNullException

targetName 为 null。

或 - credential 为 null。

AuthenticationException

身份验证失败。可以使用此对象尝试重新进行身份验证。

InvalidCredentialException

身份验证失败。可以使用此对象尝试重新进行身份验证。

InvalidOperationException

已进行了身份验证。

或 -

此流先前被尝试作为服务器进行身份验证。不能尝试将该流作为客户端重新进行身份验证。

ObjectDisposedException

此对象已关闭。

注解

模拟级别为 Identification，安全级别为 EncryptAndSign，并请求相互身份验证。该 NegotiateStream 类将构造用于相互身份验证的 SPN。

ChannelBinding用于在参数中binding传递给此方法的扩展保护将由应用程序从TransportContext关联的SslStream属性检索。

另请参阅

适用于

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。身份验证过程使用指定的凭据和身份验证选项。

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)

参数

credential: NetworkCredential

用于确立客户端身份的 NetworkCredential。

targetName: String

唯一标识要进行身份验证的服务器的服务主体名称 (SPN)。

requiredProtectionLevel: ProtectionLevel

ProtectionLevel 值之一，指示流的安全服务。

allowedImpersonationLevel: TokenImpersonationLevel

TokenImpersonationLevel 值之一，指示服务器使用客户端凭据访问资源的方式。

例外

ArgumentOutOfRangeException

allowedImpersonationLevel 不是有效值。

ArgumentNullException

targetName 为 null。

AuthenticationException

身份验证失败。可以使用此对象尝试重新进行身份验证。

InvalidCredentialException

身份验证失败。可以使用此对象尝试重新进行身份验证。

ObjectDisposedException

此对象已关闭。

InvalidOperationException

已进行了身份验证。

或 -

此流先前被尝试作为服务器进行身份验证。不能尝试将该流作为客户端重新进行身份验证。

注解

使用 requiredProtectionLevel 参数为使用经过身份验证的流传输的数据请求安全服务。例如，若要对数据进行加密和签名，请指定 EncryptAndSign 值。成功身份验证不保证已授予所请求 ProtectionLevel 的身份验证。必须检查 IsEncrypted 和 IsSigned 属性以确定安全服务由哪些 NegotiateStream安全服务使用。

如果身份验证失败，则会收到一个或一个 AuthenticationException InvalidCredentialException。在这种情况下，可以使用其他凭据重试身份验证。

适用于

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

客户端调用此方法，以便对客户端/服务器连接中的客户端及服务器（可选）进行身份验证。身份验证过程使用指定的凭据、身份验证选项和通道绑定。

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)

参数

credential: NetworkCredential

用于确立客户端身份的 NetworkCredential。

binding: ChannelBinding

用于扩展保护的 ChannelBinding。

targetName: String

唯一标识要进行身份验证的服务器的服务主体名称 (SPN)。

requiredProtectionLevel: ProtectionLevel

ProtectionLevel 值之一，指示流的安全服务。

allowedImpersonationLevel: TokenImpersonationLevel

TokenImpersonationLevel 值之一，指示服务器使用客户端凭据访问资源的方式。

例外

ArgumentNullException

targetName 为 null。

或 - credential 为 null。

ArgumentOutOfRangeException

allowedImpersonationLevel 不是有效值。

AuthenticationException

身份验证失败。可以使用此对象尝试重新进行身份验证。

InvalidCredentialException

身份验证失败。可以使用此对象尝试重新进行身份验证。

InvalidOperationException

已进行了身份验证。

或 -

此流先前被尝试作为服务器进行身份验证。不能尝试将该流作为客户端重新进行身份验证。

ObjectDisposedException

此对象已关闭。

注解

ChannelBinding用于在参数中binding传递给此方法的扩展保护将由应用程序从TransportContext关联的SslStream属性中检索。

如果身份验证失败，则会收到一个或一个 AuthenticationException InvalidCredentialException。在这种情况下，可以使用其他凭据重试身份验证。

另请参阅

适用于

NegotiateStream.AuthenticateAsClient 方法

定义

重载

AuthenticateAsClient()

例外

注解

适用于

AuthenticateAsClient(NetworkCredential, String)

参数

例外

注解

适用于

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

参数

例外

注解

另请参阅

适用于

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

参数

例外

注解

适用于

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

参数

例外

注解

另请参阅

适用于

其他资源