ClientCredentials Класс

Определение

Пространство имен:

System.ServiceModel.Description

Сборки:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Пакет:

System.ServiceModel.Primitives v10.0.652802

Исходный код:

ClientCredentials.cs

Позволяет пользователю настраивать учетные данные клиента и службы, а также параметры проверки подлинности учетных данных службы для использования на стороне клиента связи.

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

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

type ClientCredentials = class
    inherit SecurityCredentialsManager
    interface IEndpointBehavior

Public Class ClientCredentials
Inherits SecurityCredentialsManager
Implements IEndpointBehavior

Наследование

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 является фасадом (хорошо известным шаблоном дизайна) над записью в этой коллекции. Многие свойства в этом классе возвращают объекты, состоящие главным образом из свойств. Эти объекты можно использовать для настройки: после get того как объект можно использовать для set свойств, вызывая его члены.

Конструкторы

Имя	Описание
ClientCredentials()	Инициализирует новый экземпляр класса ClientCredentials.
ClientCredentials(ClientCredentials)	Это конструктор копирования.

Свойства

Имя	Описание
ClientCertificate	Возвращает объект, который можно использовать для предоставления сертификата X.509, который клиент использует для проверки подлинности в службе.
HttpDigest	Возвращает текущие учетные данные дайджеста HTTP.
ServiceCertificate	Возвращает объект, используемый для указания сертификата X.509 службы.
UserName	Возвращает объект учетных данных, который можно использовать для задания имени пользователя и пароля, используемого клиентом для проверки подлинности в службе.
Windows	Получает объект, используемый для управления учетными данными Windows, которые клиент использует для проверки подлинности в службе.

Методы

Имя	Описание
ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Применяет указанное поведение клиента к конечной точке.
Clone()	Создает новую копию этого ClientCredentials экземпляра.
CloneCore()	Создает новую копию этого ClientCredentials экземпляра.
CreateSecurityTokenManager()	Создает диспетчер маркеров безопасности для этого экземпляра. Этот метод редко вызывается явным образом; он в основном используется в сценариях расширяемости и вызывается самой системой.

Явные реализации интерфейса

Имя	Описание
IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Добавляет этот экземпляр этого класса в коллекцию параметров привязки.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Реализует изменение или расширение службы в конечной точке.
IEndpointBehavior.Validate(ServiceEndpoint)	Зарезервировано для дальнейшего использования.