SecurityBindingElement Třída

Definice

Obor názvů:

System.ServiceModel.Channels

Sestavení:

System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v8.0.0

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 elementů zabezpečení zpráv SOAP ve WCF. Existují tři implementace této abstraktní třídy: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementa TransportSecurityBindingElement. Tyto implementace modelují vazby definované ve specifikaci zásad WS-Security.

Vlastní vazba obsahuje kolekci elementů vazby uspořádaných v určitém pořadí: element, který představuje horní část zásobníku vazby, 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řte BindingElementCollection.

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

3. Pomocí metody přidejte tyto prvky v pořadí, které jsme popsali BindingElementCollectionInsertItem dříve.

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

5. Přidejte element odvozené vazby zabezpečení do kolekce.

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

Další informace o použití SecurityBindingElementnaleznete v tématu Režimy ověřování SecurityBindingElement a Postupy: Vytvoření vlastní vazby pomocí SecurityBindingElement.

Poznámka

Po vytvoření objektu SecurityBindingElement byste měli jeho vlastnosti považovat za neměnné. Volání set u některých vlastností může mít nepředvídatelné účinky: vazba se může chovat, jako by si vlastnost zachovala starou hodnotu, přičemž selhání modulu runtime je jediným indikátorem problému. Dvě vlastnosti, o kterých je známo, že se chovají tímto způsobem, jsou KeyType a MessageSecurityVersion. Můžou existovat i jiné vlastnosti, u kterých to platí.

Vlastnosti

DefaultAlgorithmSuite	Získá nebo nastaví šifrování zpráv a zalamování klíčů algoritmy.
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á označuje, zda jsou součástí každé zprávy časová razítka.
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 operace podporující parametry tokenu.
OptionalEndpointSupportingTokenParameters	Získá volitelné parametry podpůrného tokenu pro koncový bod služby.
OptionalOperationSupportingTokenParameters	Získá kolekci volitelné operace podporující parametry tokenu.
SecurityHeaderLayout	Získá nebo nastaví pořadí prvků v hlavičce zabezpečení pro tuto vazbu.

Metody

BuildChannelFactory<TChannel>(BindingContext)	Vytvoří objekt pro vytváření kanálů na SecurityBindingElement základě nastavení a předaného kontextu vazby. Vytvořený kanál je objekt pro vytváření kanálů zabezpečení zpráv SOAP, který interně obsahuje odkaz na objekt pro vytváření kanálů, který odpovídá kontextu vazby (který zahrnuje objekt pro vytváření přenosového kanálu).
BuildChannelFactoryCore<TChannel>(BindingContext)	Při implementaci vytvoří objekt pro vytváření kanálů zadaného typu.
BuildChannelListener<TChannel>(BindingContext)	Inicializuje naslouchací proces kanálu pro příjem kanálů zadaného typu z kontextu vazby. (Zděděno od BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Určuje, zda lze sestavit objekt pro vytváření kanálů zadaného typu.
CanBuildChannelListener<TChannel>(BindingContext)	Vrátí hodnotu, která označuje, zda element vazby může sestavit naslouchací proces pro konkrétní typ kanálu. (Zděděno od BindingElement)
Clone()	Při přepsání v odvozené třídě vrátí kopii objektu elementu vazby. (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átu 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átu pomocí zabezpečení zpráv SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Vytvoří prvek vazby zabezpečení nakonfigurovaný tak, aby vyžadoval ověřování klienta založeného na 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 nakonfigurován tak, aby vyžadoval ověření klienta na základě certifikátu, stejně jako ověřování serveru založeného na certifikátech.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Vytvoří asymetrický prvek vazby zabezpečení, který je nakonfigurován tak, aby vyžadoval ověření klienta na základě certifikátu, stejně jako ověřování serveru založeného na certifikátech.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Vytvoří asymetrický prvek vazby zabezpečení, který je nakonfigurován tak, aby vyžadoval ověření klienta na základě certifikátu, stejně jako ověřování serveru založeného na certifikátech.
CreateSecureConversationBindingElement(SecurityBindingElement)	Vytvoří symetrický prvek vazby zabezpečení, který je nakonfigurován k navázání zabezpečené konverzace mezi klientem a službou. K zabezpečení zpráv se používá token kontextu zabezpečení vydaný na konci zabezpečené konverzace metodou handshake. Element vazby zabezpečení bootstrap určuje, jak jsou zabezpečeny zprávy handshake zabezpečené konverzace.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Vytvoří symetrický prvek vazby zabezpečení, který je nakonfigurován k navázání zabezpečené konverzace mezi klientem a službou. K zabezpečení zpráv se používá token kontextu zabezpečení vydaný na konci zabezpečené konverzace metodou handshake.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Vytvoří symetrický prvek vazby zabezpečení, který je nakonfigurován k navázání zabezpečené konverzace mezi klientem a službou. K zabezpečení zpráv se používá token kontextu zabezpečení vydaný na konci zabezpečené konverzace metodou handshake. Element vazby zabezpečení bootstrap určuje, jak jsou zabezpečeny zprávy handshake zabezpečené konverzace.
CreateUserNameOverTransportBindingElement()	Vytvoří prvek vazby zabezpečení, který je nakonfigurován pro ověřování klienta 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).
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetProperty<T>(BindingContext)	Získá zadaný objekt pomocí zadaného BindingContextobjektu .
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Nastaví klíč pro vlastnost požadavku na token, jejíž hodnota je BindingContext použitá ke komunikaci s vydávající stranou, pokud je požadavek na vydaný 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í SecurityBindingElement
• Postupy: Vytvoření vlastní vazby pomocí metody SecurityBindingElement