SecurityBindingElement Třída

Definice

Obor názvů:

System.ServiceModel.Channels

Sestavení:

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

Balíček:

System.ServiceModel.Primitives v10.0.652802

Zdroj:

SecurityBindingElement.cs

Abstraktní třída, která při implementaci představuje element vazby, který podporuje zabezpečení zpráv SOAP kanálu.

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement

public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement

type SecurityBindingElement = class
    inherit BindingElement

Public MustInherit Class SecurityBindingElement
Inherits BindingElement

Dědičnost

Object

BindingElement

SecurityBindingElement

Odvozené

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Poznámky

Tato třída je základní třídou pro elementy vazby zabezpečení zprávy SOAP ve WCF. Existují tři implementace této abstraktní třídy: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementa TransportSecurityBindingElement. Tyto implementace modelují vazby definované ve specifikaci WS-Security Policy.

Vlastní vazba obsahuje kolekci prvků vazby uspořádaných v určitém pořadí: element, který představuje začátek zásobníku vazeb, je přidán jako první, další prvek dolů v zásobníku vazeb je přidán druhý atd.

Chcete-li přidat tuto třídu do vazby, postupujte takto:

1. Vytvoření souboru BindingElementCollection.

2. Vytvořte vlastní element vazby, který je nad tímto prvkem vazby v zásobníku vazeb, například volitelné TransactionFlowBindingElement a ReliableSessionBindingElement.

3. Přidejte tyto prvky v pořadí, které bylo dříve popsáno do BindingElementCollection metody.InsertItem

4. Vytvoření instance elementu vazby zabezpečení odvozeného z SecurityBindingElement, například AsymmetricSecurityBindingElement, SymmetricSecurityBindingElementnebo TransportSecurityBindingElement.

5. Přidejte odvozený prvek vazby zabezpečení do kolekce.

6. Přidejte do kolekce všechny další vlastní prvky vazby, například TcpTransportBindingElement.

Další informace o použití SecurityBindingElement, viz SecurityBindingElement režimy ověřování a postupy: Vytvoření vlastní vazby pomocí SecurityBindingElement.

Poznámka:

Po vytvoření objektu SecurityBindingElement byste měli zacházet s jeho vlastnostmi jako neměnnými. Volání set některýchvlastnostích zařízení může mít nepředvídatelné účinky: Vazba se může chovat, jako by si vlastnost zachovala starou hodnotu, a selhání modulu runtime je jediným indikátorem problému. Dvě vlastnosti, o kterých je známo, že se tímto způsobem chovají, jsou KeyType a MessageSecurityVersion. Mohou existovat i další vlastnosti, z nichž platí.

Vlastnosti

Name	Description
DefaultAlgorithmSuite	Získá nebo nastaví šifrování zpráv a algoritmy zalamování klíčů.
EnableUnsecuredResponse	Získá nebo nastaví hodnotu, která označuje, zda WCF může odesílat a přijímat nezabezpečené odpovědi na zabezpečené požadavky.
EndpointSupportingTokenParameters	Získá koncový bod, který podporuje parametry tokenu.
IncludeTimestamp	Získá nebo nastaví hodnotu, která určuje, zda jsou časové razítka zahrnuta do každé zprávy.
KeyEntropyMode	Získá nebo nastaví zdroj entropie použité k vytvoření klíčů.
LocalClientSettings	Získá vlastnosti vazby specifické pro místní nastavení zabezpečení používané klientem.
MessageSecurityVersion	Získá nebo nastaví verzi zabezpečení zprávy.
OperationSupportingTokenParameters	Získá kolekci operací podporující parametry tokenu.
OptionalEndpointSupportingTokenParameters	Získá volitelné parametry podpůrného tokenu pro koncový bod služby.
OptionalOperationSupportingTokenParameters	Získá kolekci volitelných operací podporujících parametry tokenu.
SecurityHeaderLayout	Získá nebo nastaví pořadí prvků v hlavičce zabezpečení pro tuto vazbu.

Metody

Name	Description
BuildChannelFactory<TChannel>(BindingContext)	Vytvoří objekt pro vytváření kanálů na SecurityBindingElement základě nastavení a kontextu vazby předaného. Vytvořená továrna kanálu kanálu soap je továrna pro zabezpečení zpráv SOAP, která interně obsahuje odkaz na objekt pro vytváření kanálů, který odpovídá kontextu vazby (který zahrnuje továrnu přenosového kanálu).
BuildChannelFactoryCore<TChannel>(BindingContext)	Při implementaci vytvoří objekt pro vytváření kanálů zadaného typu.
CanBuildChannelFactory<TChannel>(BindingContext)	Určuje, zda lze sestavit objekt pro vytváření kanálů zadaného typu.
Clone()	Při přepsání v odvozené třídě vrátí kopii vazby element objektu. (Zděděno od BindingElement)
CreateCertificateOverTransportBindingElement()	Vytvoří prvek vazby zabezpečení, který očekává, že klienti budou provádět ověřování na základě certifikátů pomocí zabezpečení zpráv SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Vytvoří prvek vazby zabezpečení, který očekává, že klienti budou provádět ověřování na základě certifikátů pomocí zabezpečení zpráv SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Vytvoří element vazby zabezpečení nakonfigurovaný tak, aby vyžadoval ověřování klientů na základě zabezpečení PROTOKOLU SOAP pomocí vydaného tokenu. Tento element vazby vyžaduje, aby přenos poskytoval ověřování serveru a ochranu zpráv (například HTTPS).
CreateMutualCertificateBindingElement()	Vytvoří asymetrický prvek vazby zabezpečení, který je nakonfigurovaný tak, aby vyžadoval ověřování klientů na základě certifikátů a ověřování serveru založeného na certifikátech.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Vytvoří asymetrický prvek vazby zabezpečení, který je nakonfigurovaný tak, aby vyžadoval ověřování klientů na základě certifikátů a ověřování serveru založeného na certifikátech.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Vytvoří asymetrický prvek vazby zabezpečení, který je nakonfigurovaný tak, aby vyžadoval ověřování klientů na základě certifikátů a ověřování serveru založeného na certifikátech.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Vytvoří element symetrické vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. K zabezpečení zpráv se používá token kontextu zabezpečení vydaný na konci metody handshake zabezpečené konverzace. Element vazby zabezpečení bootstrap určuje, jak jsou zabezpečené zprávy handshake konverzace.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Vytvoří element symetrické vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. K zabezpečení zpráv se používá token kontextu zabezpečení vydaný na konci metody handshake zabezpečené konverzace.
CreateSecureConversationBindingElement(SecurityBindingElement)	Vytvoří element symetrické vazby zabezpečení, který je nakonfigurovaný tak, aby vytvořil zabezpečenou konverzaci mezi klientem a službou. K zabezpečení zpráv se používá token kontextu zabezpečení vydaný na konci metody handshake zabezpečené konverzace. Element vazby zabezpečení bootstrap určuje, jak jsou zabezpečené zprávy handshake konverzace.
CreateUserNameOverTransportBindingElement()	Vytvoří prvek vazby zabezpečení, který je nakonfigurován pro ověřování klientů na základě uživatelského jména a hesla odeslaného jako součást zprávy SOAP. Element vazby vyžaduje, aby přenos poskytoval ověřování serveru a ochranu zpráv (například HTTPS).
GetProperty<T>(BindingContext)	Získá zadaný objekt pomocí zadaného BindingContext.
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Nastaví klíč pro vlastnost požadavku tokenu, jejíž hodnota je BindingContext použitá ke komunikaci s vydávající stranou, pokud je požadavek na vystavený token.
SetKeyDerivation(Boolean)	Nastaví hodnotu, která určuje, jestli jsou odvozené klíče povinné.
ToString()	Vrátí popis této třídy.

Viz také

• Režimy ověřování prvku SecurityBindingElement
• Postupy: Vytvoření vlastní vazby pomocí securityBindingElement