ClientCredentials 类

参考

定义

命名空间:: System.ServiceModel.Description

程序集:: System.ServiceModel.Primitives.dll

程序集:: System.ServiceModel.dll

重要

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

使用户能够配置客户端和服务凭据以及服务凭据身份验证设置，以用于通信的客户端。

public ref class ClientCredentials : System::ServiceModel::Description::IEndpointBehavior

public ref class ClientCredentials : System::ServiceModel::Security::SecurityCredentialsManager, System::ServiceModel::Description::IEndpointBehavior

public class ClientCredentials : System.ServiceModel.Description.IEndpointBehavior

public class ClientCredentials : System.ServiceModel.Security.SecurityCredentialsManager, System.ServiceModel.Description.IEndpointBehavior

type ClientCredentials = class
    interface IEndpointBehavior

type ClientCredentials = class
    inherit SecurityCredentialsManager
    interface IEndpointBehavior

Public Class ClientCredentials
Implements IEndpointBehavior

Public Class ClientCredentials
Inherits SecurityCredentialsManager
Implements IEndpointBehavior

继承: Object
ClientCredentials

继承: Object

SecurityCredentialsManager
ClientCredentials

派生: System.ServiceModel.Federation.WSTrustChannelClientCredentials

实现: IEndpointBehavior

示例

下面的代码示例演示如何重写此类并实现你自己的包含自定义的安全令牌管理器的自定义客户端凭据。

重要

需要特别注意的是，将重写 CreateSecurityTokenManager 方法以创建自定义安全令牌管理器。派生自 ClientCredentialsSecurityTokenManager的安全令牌管理器。必须返回派生自 SecurityTokenProvider的自定义安全令牌提供程序才能创建实际的安全令牌。如果不遵循此模式创建安全令牌，则您的应用程序将面临安全攻击风险，尤其是特权提升。此编码模式确保在缓存通道工厂时使用正确的凭据。

public class MyClientCredentials : ClientCredentials
{
    string creditCardNumber;

    public MyClientCredentials()
    {
        // Perform client credentials initialization.
    }

    protected MyClientCredentials(MyClientCredentials other)
        : base(other)
    {
        // Clone fields defined in this class.
        this.creditCardNumber = other.creditCardNumber;
    }

    public string CreditCardNumber
    {
        get
        {
            return this.creditCardNumber;
        }
        set
        {
            if (value == null)
            {
                throw new ArgumentNullException("value");
            }
            this.creditCardNumber = value;
        }
    }

    public override SecurityTokenManager CreateSecurityTokenManager()
    {
        // Return your implementation of the SecurityTokenManager.
        return new MyClientCredentialsSecurityTokenManager(this);
    }

    protected override ClientCredentials CloneCore()
    {
        // Implement the cloning functionality.
        return new MyClientCredentials(this);
    }
}

Public Class MyClientCredentials
    Inherits ClientCredentials
    Private creditCardNumberValue As String

    Public Sub New() 
    
    End Sub
    
    ' Perform client credentials initialization.    
    Protected Sub New(ByVal other As MyClientCredentials) 
        MyBase.New(other)
        ' Clone fields defined in this class.
        Me.creditCardNumberValue = other.creditCardNumberValue
    
    End Sub

    Public Property CreditCardNumber() As String 
        Get
            Return Me.creditCardNumberValue
        End Get
        Set
            If value Is Nothing Then
                Throw New ArgumentNullException("value")
            End If
            Me.creditCardNumberValue = value
        End Set
    End Property

    Public Overrides Function CreateSecurityTokenManager() As SecurityTokenManager 
        ' Return your implementation of the SecurityTokenManager.
        Return New MyClientCredentialsSecurityTokenManager(Me)
    
    End Function
    
    Protected Overrides Function CloneCore() As ClientCredentials 
        ' Implement the cloning functionality.
        Return New MyClientCredentials(Me)
    
    End Function
End Class

注解

通过 ClientCredentials 类的 ClientCredentials 属性来访问 ClientBase<TChannel>。

向 ClientCredentials 集合中添加了一个 Behaviors 对象。该 ClientCredentials 属性是一个 Facade (一个已知设计模式，) 该集合中的条目。此类中的许多属性可返回主要由属性组成的对象。以下对象可用于配置：您 get 该对象后，可通过调用其成员来将其用于 set 属性。

构造函数

ClientCredentials()	初始化 ClientCredentials 类的新实例。
ClientCredentials(ClientCredentials)	此为复制构造函数。

属性

ClientCertificate	获取一个对象，您可以使用该对象来提供客户端用于通过到服务的验证的 X.509 证书。
HttpDigest	获取当前 HTTP 摘要凭据。
IssuedToken	使用此属性可指定在联系本地安全令牌服务时要使用的终结点地址和绑定。某服务需要使用已颁发令牌的身份验证，但该服务的策略（表示为客户端上的绑定）未显式指定如何和在什么位置获取已颁发的令牌时，会使用此信息。
Peer	控制对等节点用于使自身通过到网格中的其他节点的认证的凭据，以及对等节点用于认证其他对等节点的对等节点。
SecurityTokenHandlerCollectionManager	获取或设置用于客户端凭据的安全令牌处理程序。
ServiceCertificate	获取用于指定服务的 X.509 证书的对象。
SupportInteractive	获取或设置指示是否允许系统在必要时交互式提示用户输入凭据。例如，在中间层方案中，可能需要将其设置为 `false`。
UseIdentityConfiguration	获取或设置客户端凭据是否使用标识配置。
UserName	获取一个凭据对象，您可以使用该对象来设置客户端用于使自身通过到服务的身份验证的用户名和密码。
Windows	获取用于控制客户端用于使自身通过到服务的身份认证的 Windows 凭据的对象。

方法

ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	将指定客户端行为应用于终结点。
Clone()	创建此 ClientCredentials 实例的新副本。
CloneCore()	创建此 ClientCredentials 实例的新副本。
CreateSecurityTokenManager()	为此实例创建安全令牌管理器。此方法很少显式调用；它主要用于扩展方案，由系统自已调用。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer)	使用 CardSpace 系统和指定的策略链和令牌序列化程序生成并返回安全令牌。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	将此类的此实例添加到绑定参数集合。
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	在终结点范围内实现服务的修改或扩展。
IEndpointBehavior.Validate(ServiceEndpoint)	留待将来使用。

适用于

ClientCredentials 类

定义

示例

注解

构造函数

属性

方法

显式接口实现

适用于

其他资源