SecurityBindingElement.CreateSecureConversationBindingElement Метод

Определение

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

System.ServiceModel.Channels

Сборки:

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

Пакет:

System.ServiceModel.Primitives v10.0.652802

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

Перегрузки

Имя	Описание
CreateSecureConversationBindingElement(SecurityBindingElement)	Создает элемент привязки симметричного обеспечения безопасности, настроенный для установления безопасного диалога между клиентом и службой. Маркер контекста безопасности, выданный в конце подтверждения безопасной беседы, используется для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как безопасные сообщения подтверждения беседы защищены.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Создает элемент привязки симметричного обеспечения безопасности, настроенный для установления безопасного диалога между клиентом и службой. Маркер контекста безопасности, выданный в конце подтверждения безопасной беседы, используется для защиты сообщений.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Создает элемент привязки симметричного обеспечения безопасности, настроенный для установления безопасного диалога между клиентом и службой. Маркер контекста безопасности, выданный в конце подтверждения безопасной беседы, используется для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как безопасные сообщения подтверждения беседы защищены.

CreateSecureConversationBindingElement(SecurityBindingElement)

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

SecurityBindingElement.cs

Создает элемент привязки симметричного обеспечения безопасности, настроенный для установления безопасного диалога между клиентом и службой. Маркер контекста безопасности, выданный в конце подтверждения безопасной беседы, используется для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как безопасные сообщения подтверждения беседы защищены.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement(System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement) As SecurityBindingElement

Параметры

bootstrapSecurity

SecurityBindingElement

Значение SecurityBindingElement , содержащее спецификацию о том, как безопасные сообщения подтверждения беседы защищены.

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

SecurityBindingElement

Объект SecurityBindingElement.

Исключения

ArgumentNullException

bootstrapSecurity равно null.

Комментарии

Элемент привязки настроен для использования маркеров контекста безопасности на основе сеанса.

Используется bootstrapSecurity для указания привязки безопасности и политики, используемой для запроса маркера безопасного диалога из службы.

Если bootstrapSecurity это TransportSecurityBindingElement, элемент привязки, возвращаемый этим методом, также является одним и имеет trueзначение; и IncludeTimestamp объект, возвращаемый из негоDetectReplays, имеет значение свойстваfalse; и LocalClientSecuritySettingsLocalServiceSecuritySettings объект, возвращаемый из LocalServiceSettingsLocalClientSettings него, имеет значение свойства.falseDetectReplays

В противном случае возвращается объект SymmetricSecurityBindingElement с RequireSignatureConfirmation заданным значением false.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

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

SecurityBindingElement.cs

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

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement(System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean) As SecurityBindingElement

Параметры

bootstrapSecurity

SecurityBindingElement

Значение SecurityBindingElement , содержащее спецификацию о том, как безопасные сообщения подтверждения беседы защищены.

requireCancellation

Boolean

Значение , если отмена требуется; в противном случае . Установка этого параметра для false включения маркера контекста безопасности, полезного в сценариях веб-фермы, так как в этом режиме состояние сеанса закодировано внутри установленного маркера контекста безопасности, а не хранится в памяти сервера.

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

Объект SecurityBindingElement.

Исключения

ArgumentNullException

bootstrapSecurity равно null.

Примеры

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

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

// Use a secure session.
security = SecurityBindingElement.CreateSecureConversationBindingElement(security, true);

Комментарии

Если requireCancellation это false, маркеры контекста безопасности на основе файлов cookie выдаются; в противном случае маркеры контекста безопасности на основе сеансов выдаются.

Используется bootstrapSecurity для указания привязки безопасности и политики, используемой для запроса SecureConversationToken от службы.

Если bootstrapSecurity это , элемент привязки, возвращаемый этим методом, также TransportSecurityBindingElementявляется и имеет trueзначение ; и IncludeTimestampLocalClientSecuritySettings объект, возвращаемый из его DetectReplays свойстваfalse, имеет значение ; и LocalServiceSecuritySettings объект, возвращаемый из LocalClientSettingsLocalServiceSettings него, имеет значение свойстваfalseDetectReplays.TransportSecurityBindingElement

В противном случае возвращается объект SymmetricSecurityBindingElement с RequireSignatureConfirmation заданным значением false.

Замечание

Если олицетворение требуется в Windows XP, используйте безопасный сеанс без маркера контекста безопасности. При использовании маркеров контекста безопасности с олицетворением InvalidOperationException создается. Дополнительные сведения см. в разделе " Неподдерживаемые сценарии". Дополнительные сведения о безопасных сеансах см. в разделе "Безопасные сеансы".

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

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

SecurityBindingElement.cs

Создает элемент привязки симметричного обеспечения безопасности, настроенный для установления безопасного диалога между клиентом и службой. Маркер контекста безопасности, выданный в конце подтверждения безопасной беседы, используется для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как безопасные сообщения подтверждения беседы защищены.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation, System::ServiceModel::Security::ChannelProtectionRequirements ^ bootstrapProtectionRequirements);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement(System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation, System.ServiceModel.Security.ChannelProtectionRequirements bootstrapProtectionRequirements);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool * System.ServiceModel.Security.ChannelProtectionRequirements -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean, bootstrapProtectionRequirements As ChannelProtectionRequirements) As SecurityBindingElement

Параметры

bootstrapSecurity

SecurityBindingElement

Значение SecurityBindingElement , содержащее спецификацию о том, как безопасные сообщения подтверждения беседы защищены.

requireCancellation

Boolean

Значение , если отмена требуется; в противном случае . Установка этого параметра для false включения маркера контекста безопасности, полезного в сценариях веб-фермы, так как в этом режиме состояние сеанса закодировано внутри установленного маркера контекста безопасности, а не хранится в памяти сервера.

bootstrapProtectionRequirements

ChannelProtectionRequirements

Объект ChannelProtectionRequirements , указывающий требования к защите каналов.

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

Объект SecurityBindingElement.

Исключения

ArgumentNullException

bootstrapSecurity равно null.

Комментарии

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

Используется bootstrapSecurity для указания привязки безопасности и политики, используемой для запроса маркера безопасного диалога из службы.

Если bootstrapSecurity это , элемент привязки, возвращаемый этим методом, также TransportSecurityBindingElementявляется и имеет trueзначение ; и IncludeTimestampLocalClientSecuritySettings объект, возвращаемый из его DetectReplays свойстваfalse, имеет значение ; и LocalServiceSecuritySettings объект, возвращаемый из LocalClientSettingsLocalServiceSettings него, имеет значение свойстваfalseDetectReplays.TransportSecurityBindingElement

В противном случае возвращается объект SymmetricSecurityBindingElement с RequireSignatureConfirmation заданным значением false.

Замечание

Если олицетворение требуется в Windows XP, используйте безопасный сеанс без маркера контекста безопасности. При использовании маркеров контекста безопасности с олицетворением InvalidOperationException создается. Дополнительные сведения см. в разделе " Неподдерживаемые сценарии". Дополнительные сведения о безопасных сеансах см. в разделе "Безопасные сеансы".