SecurityBindingElement Klasse

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Quelle:

SecurityBindingElement.cs

Eine abstrakte Klasse, die nach der Implementierung ein Bindungselement darstellt, das Sicherheit für Kanal-SOAP-Nachrichten unterstützt.

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

Vererbung

Object

BindingElement

SecurityBindingElement

Abgeleitet

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Hinweise

Diese Klasse ist die Basisklasse für die SOAP-Nachrichtensicherheitsbindungselemente in WCF. Es gibt drei Implementierungen dieser abstrakten Klasse: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement und TransportSecurityBindingElement. Diese Implementierungen modellieren die in der WS-Security Policy-Spezifikation definierten Bindungen.

Eine benutzerdefinierte Bindung enthält eine Auflistung von Bindungselementen, die in einer bestimmten Reihenfolge angeordnet sind: Das Element, das das erste Element des Bindungsstapels darstellt, wird zuerst hinzugefügt, das darauf folgende Element wird als zweites hinzugefügt usw.

Gehen Sie wie folgt vor, um diese Klasse zu einer Bindung hinzuzufügen:

1. Erstellen Sie eine BindingElementCollection.

2. Erstellen Sie ein benutzerdefiniertes Bindungselement, das sich über diesem Bindungselement im Bindungsstapel befindet, wie zum Beispiel das optionale TransactionFlowBindingElement und ReliableSessionBindingElement.

3. Fügen Sie diese Elemente in der zuvor angegebenen Reihenfolge zur BindingElementCollection hinzu, indem Sie die InsertItem-Methode verwenden.

4. Erstellen Sie eine Instanz eines Sicherheitsbindungselements, die vom SecurityBindingElement abgeleitet wird, z. B. AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement oder TransportSecurityBindingElement.

5. Fügen Sie der Auflistung das abgeleitete Sicherheitsbindungselement hinzu.

6. Fügen Sie weitere benutzerdefinierte Bindungselemente zur Auflistung hinzu, wie zum Beispiel TcpTransportBindingElement.

Weitere Informationen zur Verwendung von SecurityBindingElementfinden Sie unter SecurityBindingElement-Authentifizierungsmodi und Vorgehensweise: Erstellen einer benutzerdefinierten Bindung mithilfe von SecurityBindingElement.

Hinweis

Nachdem ein SecurityBindingElement-Objekt erstellt wurde, sollten Sie seine Eigenschaften als unveränderlich behandeln. Das Aufrufen von set für einige Eigenschaften kann zu unvorhergesehenen Auswirkungen führen: Die Bindung verhält sich möglicherweise so, als ob die Eigenschaft den alten Wert beibehalten hätte, wobei nur ein Laufzeitfehler auf ein Problem hinweist. Zwei Eigenschaften, die für diese Verhaltensweise bekannt sind, sind KeyType und MessageSecurityVersion. Es gibt möglicherweise weitere Eigenschaften, für die dies ebenfalls gilt.

Eigenschaften

DefaultAlgorithmSuite	Ruft die Nachrichtenverschlüsselungs- und Key Wrap-Algorithmen ab oder legt sie fest.
EnableUnsecuredResponse	Ruft einen Wert ab, der angibt, ob WCF senden kann und ungesicherte Antworten auf gesicherte Anforderungen empfangen, oder legt ihn fest.
EndpointSupportingTokenParameters	Ruft den Endpunkt ab, der Tokenparameter unterstützt.
IncludeTimestamp	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob jede Nachricht einen Zeitstempel enthält.
KeyEntropyMode	Ruft die Entropiequelle zum Erstellen von Schlüsseln ab oder legt diese fest.
LocalClientSettings	Ruft die für lokale Sicherheitseinstellungen, die vom Client verwendet werden, spezifischen Bindungseigenschaften ab.
MessageSecurityVersion	Ruft die Nachrichtensicherheitsversion ab oder legt sie fest.
SecurityHeaderLayout	Ruft die Reihenfolge der Elemente im Sicherheitsheader für diese Bindung ab oder legt diese fest.

Methoden

BuildChannelFactory<TChannel>(BindingContext)	Erstellt eine Kanalfactory anhand der SecurityBindingElement-Einstellungen und dem übergebenen Bindungskontext. Die erstellte Kanalfactory ist eine SOAP-Nachrichtensicherheits-Kanalfactory, die über einen internen Verweis auf die Kanalfactory verfügt, die dem Bindungskontext entspricht (der die Transportkanalfactory umfasst).
BuildChannelFactoryCore<TChannel>(BindingContext)	Erstellt nach Implementierung eine Kanalfactory eines angegebenen Typs.
BuildChannelListener<TChannel>(BindingContext)	Initialisiert einen Kanallistener, der Kanäle eines bestimmten Typs aus dem Bindungskontext annimmt. (Geerbt von BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Bestimmt, ob eine Kanalfactory des angegebenen Typs erstellt werden kann.
CanBuildChannelListener<TChannel>(BindingContext)	Gibt einen Wert zurück, der angibt, ob das Bindungselement einen Listener für einen bestimmten Typ von Kanal erstellen kann. (Geerbt von BindingElement)
Clone()	Gibt beim Überschreiben in einer abgeleiteten Klasse eine Kopie des Bindungselementobjekts zurück. (Geerbt von BindingElement)
CreateCertificateOverTransportBindingElement()	Erstellt ein Sicherheitsbindungselement, das von Clients erwartet, eine zertifikatbasierte Authentifizierung mit SOAP-Nachrichtensicherheit durchzuführen.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Erstellt ein Sicherheitsbindungselement, das von Clients erwartet, eine zertifikatbasierte Authentifizierung mit SOAP-Nachrichtensicherheit durchzuführen.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Erstellt ein Sicherheitsbindungselement, das so konfiguriert wurde, dass die SOAP-Sicherheit-basierte Clientauthentifizierung mit einem ausgestellten Token erforderlich ist. Dieses Bindungselement (z. B. https) erfordert vom Transport die Durchführung der Serverauthentifizierung sowie die Bereitstellung des Nachrichtenschutzes.
CreateSecureConversationBindingElement(SecurityBindingElement)	Erstellt ein symmetrisches Sicherheitsbindungselement, das so konfiguriert wurde, dass eine sichere Konversation zwischen dem Client und dem Dienst hergestellt werden kann. Das Sicherheitskontexttoken, das am Ende des Handshakes der sicheren Konversation ausgestellt wird, dient zum Sichern der Nachrichten. Das Bootstrap-Sicherheitsbindungselement gibt an, wie die Handshake-Nachrichten zur sicheren Konversation gesichert werden.
CreateUserNameOverTransportBindingElement()	Erstellt ein Sicherheitsbindungselement, das für die Clientauthentifizierung anhand eines Benutzernamens und eines Kennworts, die als Teil der SOAP-Nachricht gesendet werden, konfiguriert ist. Das Bindungselement (z. B. https) erfordert vom Transport die Durchführung der Serverauthentifizierung sowie die Bereitstellung des Nachrichtenschutzes.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetProperty<T>(BindingContext)	Ruft ein angegebenes Objekt mit dem angegebenen BindingContext ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Beschreibung dieser Klasse zurück.

Weitere Informationen

• SecurityBindingElement-Authentifizierungsmodi
• Vorgehensweise: Erstellen einer benutzerdefinierten Bindung mithilfe von SecurityBindingElement