SecurityBindingElement.CreateSecureConversationBindingElement Метод

Определение

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

System.ServiceModel.Channels

Сборка:

System.ServiceModel.Primitives.dll

Пакет:

System.ServiceModel.Primitives v6.2.0

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

Перегрузки

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

CreateSecureConversationBindingElement(SecurityBindingElement)

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

Объект SecurityBindingElement.

Исключения

ArgumentNullException

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

Комментарии

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

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

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

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

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

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

Объект SecurityBindingElement.

Исключения

ArgumentNullException

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

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

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

Объект SecurityBindingElement.

Исключения

ArgumentNullException

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

Комментарии

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

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

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

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

Примечание

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