SecurityBindingElement Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Абстрактный класс, который (при реализации) представляет элемент привязки, поддерживающий канальную безопасность сообщений SOAP.
public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElementpublic abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElementtype SecurityBindingElement = class
inherit BindingElementPublic MustInherit Class SecurityBindingElement
Inherits BindingElement- Наследование
- Производный
Комментарии
Этот класс является базовым классом для элементов привязки безопасности сообщений SOAP в WCF. Существует три реализации этого абстрактного класса: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement и TransportSecurityBindingElement. Эти реализации моделируют привязки, определенные в спецификации WS-Security Policy.
Пользовательская привязка содержит коллекцию элементов привязки, упорядоченных определенным образом: элемент, представляющий верхнюю часть стека привязки, добавляется в первую очередь, затем — следующий нижний элемент стека привязки и т. д.
Для добавления этого класса в привязку выполните следующие действия.
Создайте таблицу BindingElementCollection.
Создайте элемент пользовательской привязки, который располагаются в стеке привязок выше этого элемента привязки, например необязательный элемент TransactionFlowBindingElement или ReliableSessionBindingElement.
Добавьте эти элементы в упомянутом выше порядке в коллекцию BindingElementCollection с помощью метода InsertItem.
Создайте экземпляр элемента привязки безопасности, производный от класса SecurityBindingElement, например AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement или TransportSecurityBindingElement.
Добавьте производный элемент привязки безопасности в коллекцию.
Добавьте в коллекцию любые дополнительные элементы пользовательской привязки, такие как TcpTransportBindingElement.
Дополнительные сведения об использовании SecurityBindingElementсм. в разделах Режимы проверки подлинности SecurityBindingElement и Практическое руководство. Создание пользовательской привязки с помощью SecurityBindingElement.
Примечание
После создания объекта SecurityBindingElement его свойства следует считать неизменяемыми. Вызов set для некоторых свойств может иметь непредсказуемые последствия: привязка может повести себя, как если бы свойство сохранило свое прежнее значение, а на проблему может указывать только ошибка времени выполнения. Известно, что так ведут себя два свойства: KeyType и MessageSecurityVersion. Возможно, это справедливо и для других свойств.
Свойства
| AllowInsecureTransport |
Возвращает или задает значение, которое указывает, можно ли отправлять сообщения в смешанном режиме безопасности по безопасному протоколу, например HTTP. |
| DefaultAlgorithmSuite |
Возвращает или задает алгоритмы шифрования сообщений и ключей. |
| EnableUnsecuredResponse |
Возвращает или задает значение, указывающее, может ли WCF отправлять и получать небезопасные ответы на безопасные запросы. |
| EndpointSupportingTokenParameters |
Возвращает конечную точку, которая поддерживает параметры маркера. |
| IncludeTimestamp |
Возвращает или задает значение, которое указывает, будут ли отметки времени включаться в каждое сообщение. |
| KeyEntropyMode |
Возвращает или задает источник энтропии, используемый для создания ключей. |
| LocalClientSettings |
Возвращает свойства привязки, связанные с локальными параметрами безопасности клиента. |
| LocalServiceSettings |
Возвращает свойства привязки, связанные с локальными параметрами безопасности службы. |
| MessageSecurityVersion |
Возвращает или задает версию системы безопасности для защиты сообщения. |
| OperationSupportingTokenParameters |
Возвращает коллекцию параметров маркеров, поддерживающих операцию. |
| OptionalEndpointSupportingTokenParameters |
Возвращает дополнительную коллекцию параметров поддерживающих маркеров для конечной точки службы. |
| OptionalOperationSupportingTokenParameters |
Возвращает коллекцию дополнительную параметров маркеров, поддерживающих операцию. |
| ProtectTokens |
Получает или задает значение, указывающее, защищает ли элемент привязки безопасности токены. |
| SecurityHeaderLayout |
Возвращает или задает порядок элементов в заголовке безопасности для данной привязки. |
Методы
| BuildChannelFactory<TChannel>(BindingContext) |
Создает фабрику каналов на основании параметров SecurityBindingElement и переданного контекста привязок. Создаваемая фабрика каналов является фабрикой каналов безопасности сообщений SOAP, в которой содержится ссылка на фабрику каналов, соответствующую контексту привязки (который включает фабрику каналов транспорта). |
| BuildChannelFactoryCore<TChannel>(BindingContext) |
При реализации создает фабрику каналов заданного типа. |
| BuildChannelListener<TChannel>(BindingContext) |
Создает прослушиватель каналов на основании параметров SecurityBindingElement и переданного контекста привязки. |
| BuildChannelListener<TChannel>(BindingContext) |
Инициализирует прослушиватель каналов для приема каналов заданного типа из контекста привязки. (Унаследовано от BindingElement) |
| BuildChannelListenerCore<TChannel>(BindingContext) |
При реализации создает прослушиватель каналов заданного типа. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Определяет, можно ли создать фабрику каналов заданного типа. |
| CanBuildChannelListener<TChannel>(BindingContext) |
Определяет, можно ли создать прослушиватель каналов заданного типа. |
| CanBuildChannelListener<TChannel>(BindingContext) |
Возвращает значение, показывающее, может ли элемент привязки создать прослушиватель для заданного типа канала. (Унаследовано от BindingElement) |
| Clone() |
При переопределении в производном классе возвращает копию объекта элемента привязки. (Унаследовано от BindingElement) |
| CreateAnonymousForCertificateBindingElement() |
Создает симметричный элемент привязки безопасности, настроенный на анонимную проверку подлинности клиента и проверку подлинности сервера на основании сертификата. |
| CreateCertificateOverTransportBindingElement() |
Создает элемент привязки безопасности, настроенный на проверку подлинности клиентов на основе сертификата с использованием средств защиты сообщений SOAP. |
| CreateCertificateOverTransportBindingElement(MessageSecurityVersion) |
Создает элемент привязки безопасности, настроенный на проверку подлинности клиентов на основе сертификата с использованием средств защиты сообщений SOAP. |
| CreateCertificateSignatureBindingElement() |
Создает элемент привязки с использованием сертификата для подписи сообщений. Этот элемент привязки может использоваться только для односторонней передачи сообщений и пригоден только для подписи сообщений. |
| CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters) |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента с использованием маркера, выпущенного на основании симметричного ключа. |
| CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters) |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании выданного маркера и проверки подлинности сервера на основании сертификата сервера. |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters) |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании выданного маркера и проверки подлинности сервера на основании сертификата сервера. |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean) |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании выданного маркера и проверки подлинности сервера на основании сертификата сервера. |
| CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters) |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании механизмов безопасности SOAP с использованием выпущенного маркера. Этому элементу привязки требуется транспорт для обеспечения проверки подлинности сервера и защиты сообщений (например, протокол HTTPS). |
| CreateKerberosBindingElement() |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента с использованием маркера Kerberos клиента. |
| CreateKerberosOverTransportBindingElement() |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основе механизмов безопасности SOAP с использованием маркера Kerberos клиента. Этому элементу привязки требуется транспорт для обеспечения проверки подлинности сервера и защиты сообщений (например, протокол HTTPS). |
| CreateMutualCertificateBindingElement() |
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion) |
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean) |
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата. |
| CreateMutualCertificateDuplexBindingElement() |
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата. Этот режим проверки подлинности может использоваться для защиты шаблонов двустороннего обмена сообщениями и требует настройки сертификата клиента для службы без передачи сертификата по сети. |
| CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion) |
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата. Этот режим проверки подлинности может использоваться для защиты шаблонов двустороннего обмена сообщениями и требует настройки клиентского сертификата для службы без передачи сертификата по сети. |
| CreateSecureConversationBindingElement(SecurityBindingElement) |
Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как организуется защита сообщений подтверждения безопасного обмена данными. |
| CreateSecureConversationBindingElement(SecurityBindingElement, Boolean) |
Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений. |
| CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements) |
Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как организуется защита сообщений подтверждения безопасного обмена данными. |
| CreateSslNegotiationBindingElement(Boolean) |
Создает симметричный элемент привязки безопасности, настроенный на выполнение согласования SSL на уровне SOAP между клиентом и сервером и указывающий, требуется ли сертификат клиента. |
| CreateSslNegotiationBindingElement(Boolean, Boolean) |
Создает симметричный элемент привязки безопасности, выполняющий согласование SSL на уровне SOAP и указывающий, требуется ли сертификат клиента и отмена. |
| CreateSspiNegotiationBindingElement() |
Создает симметричный элемент привязки безопасности, выполняющий согласование SSPI на уровне SOAP на основе пакета проверки подлинности Negotiate. |
| CreateSspiNegotiationBindingElement(Boolean) |
Создает симметричный элемент привязки безопасности, выполняющий согласование SSPI на уровне SOAP на основе пакета проверки подлинности Negotiate. |
| CreateSspiNegotiationOverTransportBindingElement() |
Создает симметричный элемент привязки безопасности, настроенный на проверку подлинности клиента на основе согласования SSPI на уровне SOAP с использованием пакета проверки подлинности Negotiate. Элементу привязки требуется транспорт для обеспечения проверки подлинности сервера и защиты сообщений (например, протокол HTTPS). |
| CreateSspiNegotiationOverTransportBindingElement(Boolean) |
Создает симметричный элемент привязки безопасности, настроенный на проверку подлинности клиента на основе согласования SSPI на уровне SOAP с использованием пакета проверки подлинности Negotiate. Элементу привязки требуется транспорт для обеспечения проверки подлинности сервера и защиты сообщений (например, протокол HTTPS). |
| CreateUserNameForCertificateBindingElement() |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании имени пользователя и пароля и проверки подлинности сервера на основании сертификата. Перед открытием коммуникационного канала со службой для созданного элемента привязки требуется настроить на клиенте сертификат службы (без передачи сертификата по сети). |
| CreateUserNameForSslBindingElement() |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании имени пользователя и пароля и проверки подлинности сервера на основании сертификата. Клиент проверяет подлинность сервера, используя протокол SSL уровня SOAP. |
| CreateUserNameForSslBindingElement(Boolean) |
Создает симметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании имени пользователя и пароля и проверки подлинности сервера на основании сертификата. Клиент проверяет подлинность сервера, используя протокол SSL уровня SOAP. |
| 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() |
Возвращает описание этого класса. |
