SecurityBindingElement Класс

Определение

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

System.ServiceModel.Channels

Сборка:

System.ServiceModel.Primitives.dll

Пакет:

System.ServiceModel.Primitives v6.2.0

Source:

SecurityBindingElement.cs

Абстрактный класс, который (при реализации) представляет элемент привязки, поддерживающий канальную безопасность сообщений SOAP.

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement

public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement

type SecurityBindingElement = class
    inherit BindingElement

Public MustInherit Class SecurityBindingElement
Inherits BindingElement

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

Object

BindingElement

SecurityBindingElement

Производный

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Комментарии

Этот класс является базовым классом для элементов привязки безопасности сообщений SOAP в WCF. Существует три реализации этого абстрактного класса: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement и TransportSecurityBindingElement. Эти реализации моделируют привязки, определенные в спецификации WS-Security Policy.

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

Для добавления этого класса в привязку выполните следующие действия.

1. Создайте таблицу BindingElementCollection.

2. Создайте элемент пользовательской привязки, который располагаются в стеке привязок выше этого элемента привязки, например необязательный элемент TransactionFlowBindingElement или ReliableSessionBindingElement.

3. Добавьте эти элементы в упомянутом выше порядке в коллекцию BindingElementCollection с помощью метода InsertItem.

4. Создайте экземпляр элемента привязки безопасности, производный от класса SecurityBindingElement, например AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement или TransportSecurityBindingElement.

5. Добавьте производный элемент привязки безопасности в коллекцию.

6. Добавьте в коллекцию любые дополнительные элементы пользовательской привязки, такие как TcpTransportBindingElement.

Дополнительные сведения об использовании SecurityBindingElementсм. в разделах Режимы проверки подлинности SecurityBindingElement и Практическое руководство. Создание пользовательской привязки с помощью SecurityBindingElement.

Примечание

После создания объекта SecurityBindingElement его свойства следует считать неизменяемыми. Вызов set для некоторых свойств может иметь непредсказуемые последствия: привязка может повести себя, как если бы свойство сохранило свое прежнее значение, а на проблему может указывать только ошибка времени выполнения. Известно, что так ведут себя два свойства: KeyType и MessageSecurityVersion. Возможно, это справедливо и для других свойств.

Свойства

DefaultAlgorithmSuite	Возвращает или задает алгоритмы шифрования сообщений и ключей.
EnableUnsecuredResponse	Возвращает или задает значение, указывающее, может ли WCF отправлять и получать небезопасные ответы на безопасные запросы.
EndpointSupportingTokenParameters	Возвращает конечную точку, которая поддерживает параметры маркера.
IncludeTimestamp	Возвращает или задает значение, которое указывает, будут ли отметки времени включаться в каждое сообщение.
KeyEntropyMode	Возвращает или задает источник энтропии, используемый для создания ключей.
LocalClientSettings	Возвращает свойства привязки, связанные с локальными параметрами безопасности клиента.
MessageSecurityVersion	Возвращает или задает версию системы безопасности для защиты сообщения.
OperationSupportingTokenParameters	Возвращает коллекцию параметров маркеров, поддерживающих операцию.
OptionalEndpointSupportingTokenParameters	Возвращает дополнительную коллекцию параметров поддерживающих маркеров для конечной точки службы.
OptionalOperationSupportingTokenParameters	Возвращает коллекцию дополнительную параметров маркеров, поддерживающих операцию.
SecurityHeaderLayout	Возвращает или задает порядок элементов в заголовке безопасности для данной привязки.

Методы

BuildChannelFactory<TChannel>(BindingContext)	Создает фабрику каналов на основании параметров SecurityBindingElement и переданного контекста привязок. Создаваемая фабрика каналов является фабрикой каналов безопасности сообщений SOAP, в которой содержится ссылка на фабрику каналов, соответствующую контексту привязки (который включает фабрику каналов транспорта).
BuildChannelFactoryCore<TChannel>(BindingContext)	При реализации создает фабрику каналов заданного типа.
BuildChannelListener<TChannel>(BindingContext)	Инициализирует прослушиватель каналов для приема каналов заданного типа из контекста привязки. (Унаследовано от BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Определяет, можно ли создать фабрику каналов заданного типа.
CanBuildChannelListener<TChannel>(BindingContext)	Возвращает значение, показывающее, может ли элемент привязки создать прослушиватель для заданного типа канала. (Унаследовано от BindingElement)
Clone()	При переопределении в производном классе возвращает копию объекта элемента привязки. (Унаследовано от BindingElement)
CreateCertificateOverTransportBindingElement()	Создает элемент привязки безопасности, настроенный на проверку подлинности клиентов на основе сертификата с использованием средств защиты сообщений SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Создает элемент привязки безопасности, настроенный на проверку подлинности клиентов на основе сертификата с использованием средств защиты сообщений SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании механизмов безопасности SOAP с использованием выпущенного маркера. Этому элементу привязки требуется транспорт для обеспечения проверки подлинности сервера и защиты сообщений (например, протокол HTTPS).
CreateMutualCertificateBindingElement()	Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
CreateSecureConversationBindingElement(SecurityBindingElement)	Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как организуется защита сообщений подтверждения безопасного обмена данными.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как организуется защита сообщений подтверждения безопасного обмена данными.
CreateUserNameOverTransportBindingElement()	Создает симметричный элемент привязки безопасности, настроенный на проверку подлинности клиента на основании имени пользователя и пароля, переданных как часть сообщения SOAP. Элементу привязки требуется транспорт для обеспечения проверки подлинности сервера и защиты сообщений (например, протокол HTTPS).
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetProperty<T>(BindingContext)	Возвращает указанный объект с использованием указанного объекта BindingContext.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Задает ключ для свойства требования токена, значение которого представляет собой BindingContext, которую следует использовать для звонка издателю, если требование относится к выданному токену.
SetKeyDerivation(Boolean)	Задает значение, показывающее, необходимы ли производные ключи.
ToString()	Возвращает описание этого класса.

См. также раздел

• Режимы проверки подлинности SecurityBindingElement
• Практическое руководство. Создание пользовательской привязки с помощью элемента SecurityBindingElement