SecurityBindingElement Класс

Определение

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

System.ServiceModel.Channels

Сборки:

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

Пакет:

System.ServiceModel.Primitives v10.0.652802

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

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.

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

Чтобы добавить этот класс в привязку, сделайте следующее:

1. Создайте BindingElementCollection.

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

3. Добавьте эти элементы в порядок, описанный BindingElementCollection ранее в методе InsertItem .

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

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

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

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

Замечание

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

Свойства

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

Методы

Имя	Описание
BuildChannelFactory<TChannel>(BindingContext)	Создает фабрику каналов на SecurityBindingElement основе параметров и контекста привязки, переданного в. Фабрика каналов создается фабрикой каналов безопасности СООБЩЕНИЙ SOAP, которая внутренне имеет ссылку на фабрику каналов, соответствующую контексту привязки (которая включает фабрику транспортных каналов).
BuildChannelFactoryCore<TChannel>(BindingContext)	При реализации создает фабрику каналов указанного типа.
CanBuildChannelFactory<TChannel>(BindingContext)	Определяет, можно ли создать фабрику каналов указанного типа.
Clone()	При переопределении в производном классе возвращает копию объекта элемента привязки. (Унаследовано от BindingElement)
CreateCertificateOverTransportBindingElement()	Создает элемент привязки безопасности, который ожидает, что клиенты будут выполнять проверку подлинности на основе сертификатов с помощью безопасности сообщений SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Создает элемент привязки безопасности, который ожидает, что клиенты будут выполнять проверку подлинности на основе сертификатов с помощью безопасности сообщений SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Создает элемент привязки безопасности, настроенный для проверки подлинности клиента на основе soap с помощью выданного маркера. Для этого элемента привязки требуется транспорт для обеспечения проверки подлинности сервера и защиты сообщений (например, HTTPS).
CreateMutualCertificateBindingElement()	Создает элемент асимметричной привязки безопасности, настроенный для обязательной проверки подлинности клиента на основе сертификатов, а также проверки подлинности сервера на основе сертификатов.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Создает элемент асимметричной привязки безопасности, настроенный для обязательной проверки подлинности клиента на основе сертификатов, а также проверки подлинности сервера на основе сертификатов.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Создает элемент асимметричной привязки безопасности, настроенный для обязательной проверки подлинности клиента на основе сертификатов, а также проверки подлинности сервера на основе сертификатов.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Создает элемент привязки симметричного обеспечения безопасности, настроенный для установления безопасного диалога между клиентом и службой. Маркер контекста безопасности, выданный в конце подтверждения безопасной беседы, используется для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как безопасные сообщения подтверждения беседы защищены.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Создает элемент привязки симметричного обеспечения безопасности, настроенный для установления безопасного диалога между клиентом и службой. Маркер контекста безопасности, выданный в конце подтверждения безопасной беседы, используется для защиты сообщений.
CreateSecureConversationBindingElement(SecurityBindingElement)	Создает элемент привязки симметричного обеспечения безопасности, настроенный для установления безопасного диалога между клиентом и службой. Маркер контекста безопасности, выданный в конце подтверждения безопасной беседы, используется для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как безопасные сообщения подтверждения беседы защищены.
CreateUserNameOverTransportBindingElement()	Создает элемент привязки безопасности, настроенный для проверки подлинности клиента на основе имени пользователя и пароля, отправляемого в рамках сообщения SOAP. Элемент привязки требует транспорта для обеспечения проверки подлинности сервера и защиты сообщений (например, HTTPS).
GetProperty<T>(BindingContext)	Возвращает указанный объект с помощью указанного BindingContextобъекта.
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Задает ключ для свойства требования маркера, значение которого — BindingContext, используемое для связи с издателем, если требование предназначено для выданного маркера.
SetKeyDerivation(Boolean)	Задает значение, указывающее, требуются ли производные ключи.
ToString()	Возвращает описание этого класса.

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

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