SecurityBindingElement Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel.Channels

Zestaw:

System.ServiceModel.Primitives.dll

Pakiet:

System.ServiceModel.Primitives v6.2.0

Source:

SecurityBindingElement.cs

Abstrakcyjna klasa, która po zaimplementowaniu reprezentuje element powiązania, który obsługuje zabezpieczenia komunikatów protokołu SOAP kanału.

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

Dziedziczenie

Object

BindingElement

SecurityBindingElement

Pochodne

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Uwagi

Ta klasa jest klasą bazową elementów powiązania zabezpieczeń komunikatów PROTOKOŁU SOAP w programie WCF. Istnieją trzy implementacje tej klasy abstrakcyjnej: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementi TransportSecurityBindingElement. Te implementacje modeluje powiązania zdefiniowane w specyfikacji zasad WS-Security.

Powiązanie niestandardowe zawiera kolekcję elementów powiązań rozmieszczonych w określonej kolejności: element reprezentujący górną część stosu powiązań jest dodawany najpierw, następny element w stosie powiązań jest dodawany drugi i tak dalej.

Aby dodać tę klasę do powiązania, wykonaj następujące czynności:

1. Utwórz element BindingElementCollection.

2. Utwórz niestandardowy element powiązania, który znajduje się powyżej tego elementu powiązania w stosie powiązań, na przykład opcjonalny TransactionFlowBindingElement i ReliableSessionBindingElement.

3. Dodaj te elementy w kolejności opisanej wcześniej przy BindingElementCollection użyciu InsertItem metody .

4. Utwórz wystąpienie elementu powiązania zabezpieczeń pochodzącego z SecurityBindingElementelementu , takiego jak AsymmetricSecurityBindingElement, SymmetricSecurityBindingElementlub TransportSecurityBindingElement.

5. Dodaj pochodny element powiązania zabezpieczeń do kolekcji.

6. Dodaj do kolekcji dodatkowe niestandardowe elementy powiązania, takie jak TcpTransportBindingElement.

Aby uzyskać więcej informacji na temat używania elementu SecurityBindingElement, zobacz SecurityBindingElement Authentication Modes (Tryby uwierzytelniania securityBindingElement ) i How to: Create a Custom Binding Using the SecurityBindingElement (Jak utworzyć powiązanie niestandardowe przy użyciu elementu SecurityBindingElement).

Uwaga

Po utworzeniu SecurityBindingElement obiektu należy traktować jego właściwości jako niezmienne. Wywołanie set niektórych właściwości może mieć nieprzewidywalny wpływ: powiązanie może zachowywać się tak, jakby właściwość zachowała starą wartość, a błąd środowiska uruchomieniowego jest jedynym wskazaniem problemu. Dwie właściwości znane do zachowania w ten sposób to KeyType i MessageSecurityVersion. Mogą istnieć inne właściwości, z których jest to również prawdziwe.

Właściwości

DefaultAlgorithmSuite	Pobiera lub ustawia algorytmy szyfrowania komunikatów i zawijania kluczy.
EnableUnsecuredResponse	Pobiera lub ustawia wartość wskazującą, czy program WCF może wysyłać i odbierać niezabezpieczone odpowiedzi na zabezpieczone żądania.
EndpointSupportingTokenParameters	Pobiera punkt końcowy obsługujący parametry tokenu.
IncludeTimestamp	Pobiera lub ustawia wartość wskazującą, czy sygnatury czasowe są uwzględniane w każdym komunikacie.
KeyEntropyMode	Pobiera lub ustawia źródło entropii używanej do tworzenia kluczy.
LocalClientSettings	Pobiera właściwości powiązania specyficzne dla ustawień zabezpieczeń lokalnych używanych przez klienta.
MessageSecurityVersion	Pobiera lub ustawia wersję zabezpieczeń komunikatu.
OperationSupportingTokenParameters	Pobiera kolekcję parametrów tokenu obsługi operacji.
OptionalEndpointSupportingTokenParameters	Pobiera opcjonalne parametry tokenu pomocniczego dla punktu końcowego usługi.
OptionalOperationSupportingTokenParameters	Pobiera kolekcję opcjonalnych parametrów tokenu obsługi operacji.
SecurityHeaderLayout	Pobiera lub ustawia kolejność elementów w nagłówku zabezpieczeń dla tego powiązania.

Metody

BuildChannelFactory<TChannel>(BindingContext)	Tworzy fabrykę kanałów na SecurityBindingElement podstawie ustawień i kontekstu powiązania przekazanego. Utworzona fabryka kanałów kanałów kanału zabezpieczeń protokołu SOAP to fabryka kanałów zabezpieczeń protokołu SOAP, która wewnętrznie ma odwołanie do fabryki kanałów, która odpowiada kontekstowi powiązania (w tym fabryce kanałów transportu).
BuildChannelFactoryCore<TChannel>(BindingContext)	Po zaimplementowaniu tworzy fabrykę kanałów określonego typu.
BuildChannelListener<TChannel>(BindingContext)	Inicjuje odbiornik kanału, aby akceptował kanały określonego typu z kontekstu powiązania. (Odziedziczone po BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Określa, czy można skompilować fabrykę kanałów określonego typu.
CanBuildChannelListener<TChannel>(BindingContext)	Zwraca wartość wskazującą, czy element powiązania może skompilować odbiornik dla określonego typu kanału. (Odziedziczone po BindingElement)
Clone()	Po zastąpieniu klasy pochodnej zwraca kopię obiektu elementu powiązania. (Odziedziczone po BindingElement)
CreateCertificateOverTransportBindingElement()	Tworzy element powiązania zabezpieczeń, który oczekuje od klientów uwierzytelniania opartego na certyfikatach przy użyciu zabezpieczeń komunikatów protokołu SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Tworzy element powiązania zabezpieczeń, który oczekuje od klientów uwierzytelniania opartego na certyfikatach przy użyciu zabezpieczeń komunikatów protokołu SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Tworzy element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na zabezpieczeniach protokołu SOAP przy użyciu wystawionego tokenu. Ten element powiązania wymaga transportu, aby zapewnić uwierzytelnianie serwera i ochronę komunikatów (na przykład HTTPS).
CreateMutualCertificateBindingElement()	Tworzy asymetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Tworzy asymetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Tworzy asymetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach.
CreateSecureConversationBindingElement(SecurityBindingElement)	Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości. Element powiązania zabezpieczeń bootstrap określa sposób zabezpieczania wiadomości uzgadniania konwersacji.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości. Element powiązania zabezpieczeń bootstrap określa sposób zabezpieczania wiadomości uzgadniania konwersacji.
CreateUserNameOverTransportBindingElement()	Tworzy element powiązania zabezpieczeń skonfigurowany do uwierzytelniania klienta na podstawie nazwy użytkownika i hasła wysyłanego w ramach komunikatu SOAP. Element powiązania wymaga transportu, aby zapewnić uwierzytelnianie serwera i ochronę komunikatów (na przykład HTTPS).
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetProperty<T>(BindingContext)	Pobiera określony obiekt przy użyciu określonego BindingContextobiektu .
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Ustawia klucz właściwości wymagania tokenu, którego wartością jest BindingContext używany do rozmowy z podmiotem wystawiającym, jeśli wymaganie dotyczy wystawionego tokenu.
SetKeyDerivation(Boolean)	Ustawia wartość wskazującą, czy klucze pochodne są wymagane.
ToString()	Zwraca opis tej klasy.

Zobacz też

• Tryby uwierzytelniania elementu SecurityBindingElement
• Instrukcje: tworzenie powiązania niestandardowego przy użyciu elementu SecurityBindingElement