通过

ClientCredentials 类

  • 参考

定义

命名空间:
System.ServiceModel.Description
程序集:
System.ServiceModel.Primitives.dll
程序集:
System.ServiceModel.dll

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

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
派生
实现
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)

留待将来使用。

适用于