SecurityBindingElement.CreateMutualCertificateBindingElement Метод

Определение

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

System.ServiceModel.Channels

Сборка:

System.ServiceModel.dll

Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.

Перегрузки

CreateMutualCertificateBindingElement()	Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.

Комментарии

На клиенте необходимо настроить сертификат клиента и сертификат сервера. На сервере должен быть настроен сертификат сервера.

CreateMutualCertificateBindingElement()

Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement();

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement ();

static member CreateMutualCertificateBindingElement : unit -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement () As SecurityBindingElement

Возвращаемое значение

SecurityBindingElement

Объект SecurityBindingElement.

Примеры

В следующем примере кода показано, как вызвать этот метод.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

Комментарии

Привязка настраивается таким образом, что для каждого запроса клиент создается случайный симметричный ключ (зашифрованный для сервера), который используется для защиты запроса и ответа сервера. В качестве подтверждающего поддерживающего маркера при запросе используется сертификат клиента.

Фактически создается объект AsymmetricSecurityBindingElement.

CreateMutualCertificateBindingElement(MessageSecurityVersion)

Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.

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.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion) As SecurityBindingElement

Параметры

version

MessageSecurityVersion

Версия механизмов безопасности сообщения.

Возвращаемое значение

SecurityBindingElement

Объект SecurityBindingElement.

Исключения

ArgumentNullException

version имеет значение null.

Комментарии

Если используется версия WSSecurity10, то элемент привязки настраивается таким образом, что запрос клиента подписывается сертификатом клиента и шифруется с использованием сертификата сервера.

Если используется версия WSSecurity11, то элемент привязки настраивается таким образом, что для каждого запроса клиент создает случайный симметричный ключ (зашифрованный для сервера), который используется для защиты запроса и ответа сервера. В качестве подтверждающего поддерживающего маркера при запросе используется сертификат клиента.

Примечание

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

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

Создает асимметричный элемент привязки безопасности, настроенный на затребование проверки подлинности клиента на основании сертификата и проверки подлинности сервера на основании сертификата.

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.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion, allowSerializedSigningTokenOnReply As Boolean) As SecurityBindingElement

Параметры

version

MessageSecurityVersion

Версия механизмов безопасности сообщения.

allowSerializedSigningTokenOnReply

Boolean

true для разрешения сериализованного токена подписи в ответе; в противном случае — значение false.

Возвращаемое значение

SecurityBindingElement

Объект SecurityBindingElement.

Исключения

ArgumentNullException

version имеет значение null.

Комментарии

Если значение параметра allowSerializedSigningTokenOnReply равняется true, обеспечивается взаимодействие с более старыми версиями расширений веб-служб (WSE).

Примечание

После создания объекта SecurityBindingElement путем вызова данного метода свойство MessageSecurityVersion должно рассматриваться как неизменяемое. Если изменить это значение, может возникнуть рассогласование привязки.