SecurityBindingElement.CreateSecureConversationBindingElement Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений.
Перегрузки
CreateSecureConversationBindingElement(SecurityBindingElement) |
Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как организуется защита сообщений подтверждения безопасного обмена данными. |
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean) |
Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений. |
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements) |
Создает симметричный элемент привязки безопасности, настроенный на установку защищенного взаимодействия между клиентом и службой. Маркер контекста безопасности, выпущенный после подтверждения безопасного обмена данными, служит для защиты сообщений. Элемент привязки безопасности начальной загрузки указывает, как организуется защита сообщений подтверждения безопасного обмена данными. |
CreateSecureConversationBindingElement(SecurityBindingElement)
- Source:
- SecurityBindingElement.cs
- Source:
- SecurityBindingElement.cs
- Source:
- 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.
Исключения
bootstrapSecurity
имеет значение null
.
Комментарии
Элемент привязки настроен на использование маркеров контекста безопасности на основе сеанса.
Параметр bootstrapSecurity
используется для указания привязки безопасности и политики, используемых для запроса маркера безопасного диалога от службы.
Если значение bootstrapSecurity
равняется TransportSecurityBindingElement, элемент привязки, возвращаемый этим методом, принадлежит к тому же типу, а свойство IncludeTimestamp равняется true
; при этом у объекта LocalClientSecuritySettings, возвращаемого свойством LocalClientSettings, для свойства DetectReplays установлено значение false
, а у объекта LocalServiceSecuritySettings, возвращаемого свойством LocalServiceSettings, свойство DetectReplays равняется false
.
В противном случае возвращается объект SymmetricSecurityBindingElement, у которого для свойства RequireSignatureConfirmation установлено значение false
.
Применяется к
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)
- Source:
- SecurityBindingElement.cs
- Source:
- SecurityBindingElement.cs
- Source:
- 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
Значение true
используется, если требуется отмена; в противном случае используется значение false
. Если для этого параметра установлено значение false
, разрешается использование маркера контекста безопасности, который удобен в сценариях веб-ферм, поскольку в этом режиме состояние сеанса кодируется внутри установленного маркера контекста безопасности, а не хранится в памяти сервера.
Возвращаемое значение
Объект SecurityBindingElement.
Исключения
bootstrapSecurity
имеет значение null
.
Примеры
В следующем примере кода показано, как вызвать этот метод.
SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();
// Use a secure session.
security = SecurityBindingElement.CreateSecureConversationBindingElement(security, true);
Комментарии
Если requireCancellation
имеет значение false
, выдаются маркеры контекста безопасности на основе файлов cookie; в противном случае выдаются маркеры контекста безопасности на основе сеанса.
Параметр bootstrapSecurity
используется для указания привязки безопасности и политики, используемых для запроса объекта SecureConversationToken
от службы.
Если значение bootstrapSecurity
равняется TransportSecurityBindingElement, элемент привязки, возвращаемый этим методом, также принадлежит к типу TransportSecurityBindingElement
, а свойство IncludeTimestamp равняется true
; при этом у объекта LocalClientSecuritySettings, возвращаемого свойством LocalClientSettings, для свойства DetectReplays установлено значение false
, а у объекта LocalServiceSecuritySettings, возвращаемого свойством LocalServiceSettings, свойство DetectReplays равняется false
.
В противном случае возвращается объект SymmetricSecurityBindingElement, у которого для свойства RequireSignatureConfirmation установлено значение false
.
Примечание
Если в Windows XP требуется олицетворение, используйте безопасный сеанс без маркера контекста безопасности. При использовании маркеров контекста безопасности вместе с олицетворением возникает исключение InvalidOperationException. Дополнительные сведения см. в разделе Неподдерживаемые сценарии. Дополнительные сведения о безопасных сеансах см. в разделе Безопасные сеансы.
Применяется к
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)
- Source:
- SecurityBindingElement.cs
- Source:
- SecurityBindingElement.cs
- Source:
- 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
Значение true
используется, если требуется отмена; в противном случае используется значение false
. Если для этого параметра установлено значение false
, разрешается использование маркера контекста безопасности, который удобен в сценариях веб-ферм, поскольку в этом режиме состояние сеанса кодируется внутри установленного маркера контекста безопасности, а не хранится в памяти сервера.
- bootstrapProtectionRequirements
- ChannelProtectionRequirements
Объект ChannelProtectionRequirements, задающий требования для защиты каналов.
Возвращаемое значение
Объект SecurityBindingElement.
Исключения
bootstrapSecurity
имеет значение null
.
Комментарии
Параметр bootstrapProtectionRequirements
обеспечивает возможность настройки способа защиты сообщений, передаваемых в процессе подтверждения безопасного обмена данными.
Параметр bootstrapSecurity
используется для указания привязки безопасности и политики, используемых для запроса маркера безопасного диалога от службы.
Если значение bootstrapSecurity
равняется TransportSecurityBindingElement, элемент привязки, возвращаемый этим методом, также принадлежит к типу TransportSecurityBindingElement
, а свойство IncludeTimestamp равняется true
; при этом у объекта LocalClientSecuritySettings, возвращаемого свойством LocalClientSettings, для свойства DetectReplays установлено значение false
, а у объекта LocalServiceSecuritySettings, возвращаемого свойством LocalServiceSettings, свойство DetectReplays равняется false
.
В противном случае возвращается объект SymmetricSecurityBindingElement, у которого для свойства RequireSignatureConfirmation установлено значение false
.
Примечание
Если в Windows XP требуется олицетворение, используйте безопасный сеанс без маркера контекста безопасности. При использовании маркеров контекста безопасности вместе с олицетворением возникает исключение InvalidOperationException. Дополнительные сведения см. в разделе Неподдерживаемые сценарии. Дополнительные сведения о безопасных сеансах см. в разделе Безопасные сеансы.