SecurityBindingElement.CreateMutualCertificateBindingElement Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
Перегрузки
| CreateMutualCertificateBindingElement() |
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion) |
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean) |
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата. |
Комментарии
На клиенте необходимо настроить сертификат клиента и сертификат сервера. На сервере должен быть настроен сертификат сервера.
CreateMutualCertificateBindingElement()
- Исходный код:
- SecurityBindingElement.cs
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
public:
static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement();public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement ();static member CreateMutualCertificateBindingElement : unit -> System.ServiceModel.Channels.SecurityBindingElementPublic Shared Function CreateMutualCertificateBindingElement () As SecurityBindingElementВозвращаемое значение
Объект SecurityBindingElement.
Примеры
В следующем примере кода показано, как вызвать этот метод.
SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();
Комментарии
Привязка настраивается таким образом, что для каждого запроса клиент создается случайный симметричный ключ (зашифрованный для сервера), который используется для защиты запроса и ответа сервера. В качестве подтверждающего поддерживающего маркера при запросе используется сертификат клиента.
Фактически создается объект AsymmetricSecurityBindingElement.
Применяется к
CreateMutualCertificateBindingElement(MessageSecurityVersion)
- Исходный код:
- SecurityBindingElement.cs
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
public:
static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement(System::ServiceModel::MessageSecurityVersion ^ version);public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement (System.ServiceModel.MessageSecurityVersion version);static member CreateMutualCertificateBindingElement : System.ServiceModel.MessageSecurityVersion -> System.ServiceModel.Channels.SecurityBindingElementPublic Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion) As SecurityBindingElementПараметры
- version
- MessageSecurityVersion
Версия механизмов безопасности сообщения.
Возвращаемое значение
Объект SecurityBindingElement.
Исключения
version имеет значение null.
Комментарии
Если используется версия WSSecurity10, то элемент привязки настраивается таким образом, что запрос клиента подписывается сертификатом клиента и шифруется с использованием сертификата сервера.
Если используется версия WSSecurity11, то элемент привязки настраивается таким образом, что для каждого запроса клиент создает случайный симметричный ключ (зашифрованный для сервера), который используется для защиты запроса и ответа сервера. В качестве подтверждающего поддерживающего маркера при запросе используется сертификат клиента.
Примечание
После создания объекта SecurityBindingElement путем вызова данного метода свойство MessageSecurityVersion должно рассматриваться как неизменяемое. Вызов set для этого свойства не изменяет его.
Применяется к
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)
- Исходный код:
- SecurityBindingElement.cs
Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
public:
static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement(System::ServiceModel::MessageSecurityVersion ^ version, bool allowSerializedSigningTokenOnReply);public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement (System.ServiceModel.MessageSecurityVersion version, bool allowSerializedSigningTokenOnReply);static member CreateMutualCertificateBindingElement : System.ServiceModel.MessageSecurityVersion * bool -> System.ServiceModel.Channels.SecurityBindingElementPublic Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion, allowSerializedSigningTokenOnReply As Boolean) As SecurityBindingElementПараметры
- version
- MessageSecurityVersion
Версия механизмов безопасности сообщения.
- allowSerializedSigningTokenOnReply
- Boolean
true для разрешения сериализованного токена подписи в ответе; в противном случае — значение false.
Возвращаемое значение
Объект SecurityBindingElement.
Исключения
version имеет значение null.
Комментарии
Если значение параметра allowSerializedSigningTokenOnReply равняется true, обеспечивается взаимодействие с более старыми версиями расширений веб-служб (WSE).
Примечание
После создания объекта SecurityBindingElement путем вызова данного метода свойство MessageSecurityVersion должно рассматриваться как неизменяемое. Если изменить это значение, может возникнуть рассогласование привязки.
