SecurityBindingElement.CreateSecureConversationBindingElement Metoda

Definice

Obor názvů:

System.ServiceModel.Channels

Sestavení:

System.ServiceModel.Security.dll

Sestavení:

System.ServiceModel.dll

Vytvoří element symetrické vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. Token kontextu zabezpečení vydaný na konci zabezpečené konverzace handshake slouží k zabezpečení zpráv.

Přetížení

CreateSecureConversationBindingElement(SecurityBindingElement)	Vytvoří element symetrické vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. Token kontextu zabezpečení vydaný na konci zabezpečené konverzace handshake slouží k zabezpečení zpráv. Element vazby zabezpečení bootstrap určuje, jak jsou zabezpečené zprávy handshake konverzace.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Vytvoří symetrický prvek vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. Token kontextu zabezpečení vydaný na konci zabezpečené konverzace handshake slouží k zabezpečení zpráv.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Vytvoří symetrický prvek vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. Token kontextu zabezpečení vydaný na konci zabezpečené konverzace handshake slouží k zabezpečení zpráv. Element vazby zabezpečení bootstrap určuje, jak jsou zabezpečené zprávy handshake konverzace.

CreateSecureConversationBindingElement(SecurityBindingElement)

Vytvoří element symetrické vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. Token kontextu zabezpečení vydaný na konci zabezpečené konverzace handshake slouží k zabezpečení zpráv. Element vazby zabezpečení bootstrap určuje, jak jsou zabezpečené zprávy handshake konverzace.

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

Parametry

bootstrapSecurity

SecurityBindingElement

A SecurityBindingElement , která obsahuje specifikaci toho, jak jsou zabezpečené zprávy handshake konverzace zabezpečené.

Návraty

SecurityBindingElement

Objekt SecurityBindingElement .

Výjimky

ArgumentNullException

bootstrapSecurity je null.

Poznámky

Element vazby je nakonfigurovaný tak, aby používal tokeny kontextu zabezpečení založené na relacích.

Slouží bootstrapSecurity k označení vazby zabezpečení a zásady používané k vyžádání zabezpečeného tokenu konverzace ze služby.

Pokud bootstrapSecurity je , TransportSecurityBindingElementvazba element vrácený touto metodou je také jeden a IncludeTimestamp je nastaven na true; a LocalClientSecuritySettings objekt vrácený z LocalClientSettings má jeho DetectReplays vlastnost nastaven na false; a LocalServiceSecuritySettings objekt vrácený z LocalServiceSettings má vlastnost DetectReplays nastaven na false.

V opačném případě se vrátí hodnota SymmetricSecurityBindingElement s nastavenou RequireSignatureConfirmation na falsehodnotu .

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Vytvoří symetrický prvek vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. Token kontextu zabezpečení vydaný na konci zabezpečené konverzace handshake slouží k zabezpečení zpráv.

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

Parametry

bootstrapSecurity

SecurityBindingElement

A SecurityBindingElement , která obsahuje specifikaci způsobu zabezpečení zpráv handshake konverzace.

requireCancellation

Boolean

trueje-li vyžadováno zrušení; v opačném případě . false Nastavením tohoto parametru false povolíte token kontextu zabezpečení, který je užitečný ve scénářích webové farmy, protože v tomto režimu je stav relace kódován uvnitř vytvořeného kontextového tokenu zabezpečení místo toho, aby byl uložen v paměti serveru.

Návraty

SecurityBindingElement

Objekt SecurityBindingElement .

Výjimky

ArgumentNullException

bootstrapSecurity je null.

Příklady

Následující kód ukazuje, jak volat tuto metodu.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

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

Poznámky

Pokud requireCancellation se jedná falseo tokeny kontextu zabezpečení založené na souborech cookie, v opačném případě se vystavují tokeny kontextu zabezpečení založené na relacích.

Slouží bootstrapSecurity k označení vazby zabezpečení a zásad používaných k vyžádání SecureConversationToken ze služby.

Pokud bootstrapSecurity je element vazby TransportSecurityBindingElementvrácený touto metodou, je také TransportSecurityBindingElementa IncludeTimestamp je nastaven na true; a LocalClientSecuritySettings objekt vrácený z LocalClientSettings má jeho DetectReplays vlastnost nastaven na false; a LocalServiceSecuritySettings objekt vrácený z LocalServiceSettings má vlastnost DetectReplays nastaven na false.

V opačném případě se vrátí hodnota SymmetricSecurityBindingElement s nastavenou RequireSignatureConfirmation na falsehodnotu .

Poznámka

Pokud se v Windows XP vyžaduje zosobnění, použijte zabezpečenou relaci bez tokenu kontextu zabezpečení. Při použití tokenů kontextu zabezpečení s zosobněním InvalidOperationException je vyvolán. Další informace najdete v tématu Nepodporované scénáře. Další informace o zabezpečených relacích najdete v tématu Zabezpečené relace.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Vytvoří symetrický prvek vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. Token kontextu zabezpečení vydaný na konci zabezpečené konverzace handshake slouží k zabezpečení zpráv. Element vazby zabezpečení bootstrap určuje, jak jsou zabezpečené zprávy handshake konverzace.

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

Parametry

bootstrapSecurity

SecurityBindingElement

A SecurityBindingElement , která obsahuje specifikaci způsobu zabezpečení zpráv handshake konverzace.

requireCancellation

Boolean

trueje-li vyžadováno zrušení; v opačném případě . false Nastavením tohoto parametru false povolíte token kontextu zabezpečení, který je užitečný ve scénářích webové farmy, protože v tomto režimu je stav relace kódován uvnitř vytvořeného kontextového tokenu zabezpečení místo toho, aby byl uložen v paměti serveru.

bootstrapProtectionRequirements

ChannelProtectionRequirements

Objekt ChannelProtectionRequirements , který určuje požadavky na ochranu kanálu.

Návraty

SecurityBindingElement

Objekt SecurityBindingElement .

Výjimky

ArgumentNullException

bootstrapSecurity je null.

Poznámky

Parametr bootstrapProtectionRequirements umožňuje přizpůsobení způsobu výměny zpráv v rámci zabezpečené konverzace handshake.

Slouží bootstrapSecurity k označení vazby zabezpečení a zásady používané k vyžádání zabezpečeného tokenu konverzace ze služby.

Pokud bootstrapSecurity je element vazby TransportSecurityBindingElementvrácený touto metodou, je také TransportSecurityBindingElementa IncludeTimestamp je nastaven na true; a LocalClientSecuritySettings objekt vrácený z LocalClientSettings má jeho DetectReplays vlastnost nastaven na false; a LocalServiceSecuritySettings objekt vrácený z LocalServiceSettings má vlastnost DetectReplays nastaven na false.

V opačném případě se vrátí hodnota SymmetricSecurityBindingElement s nastavenou RequireSignatureConfirmation na falsehodnotu .

Poznámka

Pokud se v Windows XP vyžaduje zosobnění, použijte zabezpečenou relaci bez tokenu kontextu zabezpečení. Při použití tokenů kontextu zabezpečení s zosobněním InvalidOperationException je vyvolán. Další informace najdete v tématu Nepodporované scénáře. Další informace o zabezpečených relacích najdete v tématu Zabezpečené relace.