SecurityBindingElement Klasa

Definicja

Klasa abstrakcyjna, która po zaimplementowaniu reprezentuje element powiązania, który obsługuje zabezpieczenia komunikatów SOAP kanału.An abstract class that, when implemented, represents a binding element that supports channel SOAP message security.

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
SecurityBindingElement
Pochodne

Uwagi

Ta klasa jest klasą bazową dla elementów powiązania zabezpieczeń wiadomości protokołu SOAP w programie WCF.This class is the base class for the SOAP message security binding elements in WCF. Istnieją trzy implementacje tej klasy abstrakcyjnej: SymmetricSecurityBindingElement , AsymmetricSecurityBindingElement , i TransportSecurityBindingElement .There are three implementations of this abstract class: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement, and TransportSecurityBindingElement. Te implementacje modelują powiązania zdefiniowane w specyfikacji zasad WS-Security.These implementations model the bindings defined in the WS-Security Policy specification.

Powiązanie niestandardowe zawiera kolekcję elementów wiążących uporządkowanych w określonej kolejności: element reprezentujący początek stosu powiązań jest dodawany jako pierwszy, następny element w dół stosu powiązań został dodany drugi i tak dalej.A custom binding contains a collection of binding elements arranged in a specific order: the element that represents the top of the binding stack is added first, the next element down in the binding stack is added second, and so on.

Aby dodać tę klasę do powiązania, wykonaj następujące czynności:To add this class to a binding, do the following:

  1. Utwórz BindingElementCollection .Create a BindingElementCollection.

  2. Utwórz niestandardowy element powiązania, który znajduje się powyżej tego elementu wiązania w stosie powiązań, taki jak opcjonalne TransactionFlowBindingElement i ReliableSessionBindingElement .Create a custom binding element that is above this binding element in the binding stack, such as the optional TransactionFlowBindingElement and ReliableSessionBindingElement.

  3. Dodaj te elementy w kolejności opisanej wcześniej BindingElementCollection przy użyciu InsertItem metody.Add these elements in the order previously described to the BindingElementCollection using the InsertItem method.

  4. Utwórz wystąpienie elementu powiązania zabezpieczeń pochodnego od SecurityBindingElement , takiego jak AsymmetricSecurityBindingElement , SymmetricSecurityBindingElement lub TransportSecurityBindingElement .Create an instance of a security binding element derived from SecurityBindingElement, such as AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement, or TransportSecurityBindingElement.

  5. Dodaj do kolekcji pochodny element powiązania zabezpieczeń.Add the derived security binding element to the collection.

  6. Dodaj dodatkowe niestandardowe elementy powiązania do kolekcji, np TcpTransportBindingElement ..Add any additional custom binding elements to the collection, such as TcpTransportBindingElement.

Aby uzyskać więcej informacji na temat korzystania z programu SecurityBindingElement , zobacz elementu SecurityBindingElement Authentication Modes and How to: Create a Custom Binding using the elementu SecurityBindingElement.For more information about using a SecurityBindingElement, see SecurityBindingElement Authentication Modes and How to: Create a Custom Binding Using the SecurityBindingElement.

Uwaga

Po SecurityBindingElement utworzeniu obiektu należy traktować jego właściwości jako niezmienne.Once a SecurityBindingElement object is created, you should treat its properties as immutable. Wywoływanie set niektórych właściwości może mieć nieprzewidywalne skutki: powiązanie może zachowywać się tak, jakby Właściwość zachowała swoją starą wartość, a w czasie wykonywania jedyną oznaką problemu Wystąpił błąd.Calling set on some properties may have unpredictable effects: the binding may behave as if the property retained its old value, with a runtime failure being the only indication of an issue. Dwie właściwości znane do zachowania w ten sposób są KeyType i MessageSecurityVersion .Two properties known to behave this way are KeyType and MessageSecurityVersion. Mogą istnieć inne właściwości, których dotyczy również ta wartość true.There may be other properties of which this is also true.

Właściwości

AllowInsecureTransport

Pobiera lub ustawia wartość wskazującą, czy komunikaty zabezpieczone w trybie mieszanym mogą być wysyłane za pośrednictwem niezabezpieczonego transportu, takiego jak HTTP.Gets or sets a value that indicates whether mixed-mode secured messages can be sent over an unsecured transport such as HTTP.

DefaultAlgorithmSuite

Pobiera lub ustawia szyfrowanie komunikatów i algorytmy zawijania kluczy.Gets or sets the message encryption and key-wrap algorithms.

EnableUnsecuredResponse

Pobiera lub ustawia wartość wskazującą, czy funkcja WCF może wysyłać i odbierać niezabezpieczone odpowiedzi na zabezpieczone żądania.Gets or sets a value that indicates whether WCF can send and receive unsecured responses to secured requests.

EndpointSupportingTokenParameters

Pobiera punkt końcowy, który obsługuje parametry tokenu.Gets the endpoint that supports token parameters.

IncludeTimestamp

Pobiera lub ustawia wartość wskazującą, czy sygnatury czasowe są dołączone do poszczególnych komunikatów.Gets or sets a value that indicates whether time stamps are included in each message.

KeyEntropyMode

Pobiera lub ustawia Źródło entropii używanej do tworzenia kluczy.Gets or sets the source of entropy used to create keys.

LocalClientSettings

Pobiera właściwości powiązania specyficzne dla ustawień zabezpieczeń lokalnych używanych przez klienta.Gets the binding properties specific to local security settings used by the client.

LocalServiceSettings

Pobiera właściwości powiązania specyficzne dla ustawień zabezpieczeń lokalnych używanych przez usługę.Gets the binding properties specific to local security settings used by the service.

MessageSecurityVersion

Pobiera lub ustawia wersję zabezpieczeń wiadomości.Gets or sets the message security version.

OperationSupportingTokenParameters

Pobiera kolekcję operacji obsługujących Parametry tokenu.Gets the collection of operation supporting token parameters.

OptionalEndpointSupportingTokenParameters

Pobiera opcjonalne parametry tokenu pomocniczego dla punktu końcowego usługi.Gets the optional supporting token parameters for the service endpoint.

OptionalOperationSupportingTokenParameters

Pobiera kolekcję parametrów opcjonalnego tokenu pomocniczego.Gets the collection of optional operation supporting token parameters.

ProtectTokens

Pobiera lub ustawia wartość określającą, czy element powiązania zabezpieczeń chroni tokeny.Gets or sets whether the security binding element protects tokens.

SecurityHeaderLayout

Pobiera lub ustawia kolejność elementów w nagłówku zabezpieczeń dla tego powiązania.Gets or sets the ordering of the elements in the security header for this binding.

Metody

BuildChannelFactory<TChannel>(BindingContext)

Tworzy fabrykę kanałów na podstawie SecurityBindingElement ustawień i przekazaniu kontekstu powiązania.Creates a channel factory based on the SecurityBindingElement settings and the binding context passed in. Utworzona Fabryka kanałów jest fabryką kanału zabezpieczeń komunikatów protokołu SOAP, która wewnętrznie zawiera odwołanie do fabryki kanałów, która odpowiada kontekstowi powiązania (który obejmuje fabrykę kanałów transportu).The channel factory created is a SOAP message security channel factory, which internally has a reference to the channel factory that corresponds to the binding context, (which includes the transport channel factory).

BuildChannelFactoryCore<TChannel>(BindingContext)

Po zaimplementowaniu program tworzy fabrykę kanałów określonego typu.When implemented, creates a channel factory of a specified type.

BuildChannelListener<TChannel>(BindingContext)

Tworzy odbiornik kanału oparty na SecurityBindingElement ustawieniach i przekazaniu kontekstu powiązania.Creates a channel listener based on the SecurityBindingElement settings and the binding context passed in.

BuildChannelListener<TChannel>(BindingContext)

Inicjuje odbiornik kanału w celu akceptowania kanałów określonego typu z kontekstu powiązania.Initializes a channel listener to accept channels of a specified type from the binding context.

(Odziedziczone po BindingElement)
BuildChannelListenerCore<TChannel>(BindingContext)

Po zaimplementowaniu program tworzy odbiornik kanału określonego typu.When implemented, creates a channel listener of a specified type.

CanBuildChannelFactory<TChannel>(BindingContext)

Określa, czy można skompilować fabrykę kanałów określonego typu.Determines whether a channel factory of the specified type can be built.

CanBuildChannelListener<TChannel>(BindingContext)

Określa, czy można skompilować odbiornik kanału określonego typu.Determines whether a channel listener of the specified type can be built.

CanBuildChannelListener<TChannel>(BindingContext)

Zwraca wartość wskazującą, czy element powiązania może kompilować odbiornik dla określonego typu kanału.Returns a value that indicates whether the binding element can build a listener for a specific type of channel.

(Odziedziczone po BindingElement)
Clone()

Gdy jest zastępowany w klasie pochodnej, zwraca kopię obiektu elementu powiązania.When overridden in a derived class, returns a copy of the binding element object.

(Odziedziczone po BindingElement)
CreateAnonymousForCertificateBindingElement()

Tworzy element symetrycznego powiązania zabezpieczeń skonfigurowany do uwierzytelniania klientów anonimowych i uwierzytelniania na serwerze opartym na certyfikatach.Creates a symmetric security binding element that is configured for anonymous client authentication and certificate-based server authentication.

CreateCertificateOverTransportBindingElement()

Tworzy element powiązania zabezpieczeń, który oczekuje klientom uwierzytelniania opartego na certyfikatach przy użyciu zabezpieczeń komunikatów protokołu SOAP.Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

CreateCertificateOverTransportBindingElement(MessageSecurityVersion)

Tworzy element powiązania zabezpieczeń, który oczekuje klientom uwierzytelniania opartego na certyfikatach przy użyciu zabezpieczeń komunikatów protokołu SOAP.Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

CreateCertificateSignatureBindingElement()

Tworzy element powiązania przy użyciu certyfikatu do podpisywania komunikatów.Creates a binding element using a certificate to sign messages. Ten element powiązania może być używany tylko w przypadku wymiany komunikatów jednokierunkowych i może jedynie podpisać komunikat.This binding element can be used only for one-way message exchanges and is capable only of signing the message.

CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta przy użyciu wystawionego tokenu opartego na kluczu symetrycznym.Creates a symmetric security binding element that is configured to require client authentication using a symmetric-key based issued token.

CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta na podstawie wystawionego tokenu i uwierzytelniania serwera na podstawie certyfikatu serwera.Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta na podstawie wystawionego tokenu i uwierzytelniania serwera na podstawie certyfikatu serwera.Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta na podstawie wystawionego tokenu i uwierzytelniania serwera na podstawie certyfikatu serwera.Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)

Tworzy element powiązania zabezpieczeń skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na protokole SOAP przy użyciu wystawionego tokenu.Creates a security binding element configured to require SOAP security based client authentication using an issued token. Ten element powiązania wymaga, aby transport zapewniał uwierzytelnianie serwera i ochronę komunikatów (na przykład HTTPS).This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateKerberosBindingElement()

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta na podstawie tokenu Kerberos klienta.Creates a symmetric security binding element that is configured to require client authentication based on the client's Kerberos token.

CreateKerberosOverTransportBindingElement()

Tworzy element powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na protokole SOAP przy użyciu tokenu Kerberos klienta.Creates a security binding element that is configured to require SOAP-security based client authentication using the client's Kerberos token. Ten element powiązania wymaga, aby transport zapewniał uwierzytelnianie serwera i ochronę komunikatów (na przykład HTTPS).This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateMutualCertificateBindingElement()

Tworzy asymetryczny element powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateBindingElement(MessageSecurityVersion)

Tworzy asymetryczny element powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

Tworzy asymetryczny element powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateDuplexBindingElement()

Tworzy asymetryczny element powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. Tego trybu uwierzytelniania można użyć do zabezpieczania wielostronnych wzorców wymiany komunikatów i wymaga skonfigurowania usługi przy użyciu certyfikatu klienta poza pasmem.This authentication mode can be used to secure duplex message-exchange patterns and requires the service to be configured with the client certificate out of band.

CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion)

Tworzy asymetryczny element powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. Ten tryb uwierzytelniania może służyć do zabezpieczania wzorców wymiany komunikatów dupleksowych i wymaga skonfigurowania usługi przy użyciu certyfikatu klienta poza pasmem.This authentication mode can be used to secure duplex message exchange patterns and requires the service to be configured with the client certificate out of band.

CreateSecureConversationBindingElement(SecurityBindingElement)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany do nawiązywania bezpiecznej konwersacji między klientem i usługą.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. Token kontekstu zabezpieczeń wystawiony po zakończeniu uzgadniania bezpiecznych konwersacji jest używany do zabezpieczania komunikatów.The security context token issued at the end of the secure conversation handshake is used to secure the messages. Element powiązania zabezpieczeń Bootstrap określa sposób zabezpieczania komunikatów uzgadniania komunikacji zabezpieczonej.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany do nawiązywania bezpiecznej konwersacji między klientem i usługą.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. Token kontekstu zabezpieczeń wystawiony po zakończeniu uzgadniania bezpiecznych konwersacji jest używany do zabezpieczania komunikatów.The security context token issued at the end of the secure conversation handshake is used to secure the messages.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany do nawiązywania bezpiecznej konwersacji między klientem i usługą.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. Token kontekstu zabezpieczeń wystawiony po zakończeniu uzgadniania bezpiecznych konwersacji jest używany do zabezpieczania komunikatów.The security context token issued at the end of the secure conversation handshake is used to secure the messages. Element powiązania zabezpieczeń Bootstrap określa sposób zabezpieczania komunikatów uzgadniania komunikacji zabezpieczonej.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

CreateSslNegotiationBindingElement(Boolean)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany do przeprowadzania negocjacji SSL na poziomie protokołu SOAP między klientem i serwerem, zwracając uwagę, czy certyfikat klienta jest wymagany.Creates a symmetric security binding element that is configured to do SOAP-level SSL negotiation between the client and server, noting whether a client certificate is required.

CreateSslNegotiationBindingElement(Boolean, Boolean)

Tworzy element symetrycznego powiązania zabezpieczeń, który wykonuje negocjowanie protokołu SOAP SSL, zwracając uwagę, czy certyfikat klienta i anulowanie są wymagane.Creates a symmetric security binding element that does SOAP SSL negotiation, noting whether a client certificate and cancellation is required.

CreateSspiNegotiationBindingElement()

Tworzy element symetrycznego powiązania zabezpieczeń, który wykonuje negocjowanie protokołu SOAP SSPI na podstawie pakietu uwierzytelniania negocjowanego.Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.

CreateSspiNegotiationBindingElement(Boolean)

Tworzy element symetrycznego powiązania zabezpieczeń, który wykonuje negocjowanie protokołu SOAP SSPI na podstawie pakietu uwierzytelniania negocjowanego.Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.

CreateSspiNegotiationOverTransportBindingElement()

Tworzy element powiązania zabezpieczeń, który jest skonfigurowany do uwierzytelniania klienta na podstawie negocjacji protokołu SOAP SSPI przy użyciu pakietu uwierzytelniania negocjowanego.Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. Element Binding wymaga transportu do zapewnienia uwierzytelniania serwera i ochrony komunikatów (na przykład HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateSspiNegotiationOverTransportBindingElement(Boolean)

Tworzy element powiązania zabezpieczeń, który jest skonfigurowany do uwierzytelniania klienta na podstawie negocjacji protokołu SOAP SSPI przy użyciu pakietu uwierzytelniania negocjowanego.Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. Element Binding wymaga transportu do zapewnienia uwierzytelniania serwera i ochrony komunikatów (na przykład HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateUserNameForCertificateBindingElement()

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na nazwie użytkownika i hasła oraz uwierzytelniania serwera opartego na certyfikacie.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. Utworzony element powiązania wymaga, aby klient został skonfigurowany przy użyciu certyfikatu usługi poza pasmem przed otwarciem kanału komunikacyjnego z usługą.The created binding element requires the client to be configured with a service certificate that is out-of-band before opening a communication channel with a service.

CreateUserNameForSslBindingElement()

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na nazwie użytkownika i hasła oraz uwierzytelniania serwera opartego na certyfikacie.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. Klient uwierzytelnia serwer przy użyciu protokołu SSL na poziomie protokołu SOAP.The client authenticates the server using the SOAP-level SSL protocol.

CreateUserNameForSslBindingElement(Boolean)

Tworzy element symetrycznego powiązania zabezpieczeń, który jest skonfigurowany tak, aby wymagał uwierzytelniania klienta opartego na nazwie użytkownika i hasła oraz uwierzytelniania serwera opartego na certyfikacie.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. Klient uwierzytelnia serwer przy użyciu protokołu SSL na poziomie protokołu SOAP.The client authenticates the server using the SOAP-level SSL protocol.

CreateUserNameOverTransportBindingElement()

Tworzy element powiązania zabezpieczeń, który jest skonfigurowany do uwierzytelniania klienta na podstawie nazwy użytkownika i hasła wysyłanego jako część komunikatu protokołu SOAP.Creates a security binding element that is configured for client authentication based on a user name and password sent as part of the SOAP message. Element Binding wymaga transportu do zapewnienia uwierzytelniania serwera i ochrony komunikatów (na przykład HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetProperty<T>(BindingContext)

Pobiera określony obiekt przy użyciu określonego elementu BindingContext .Gets a specified object using the specified BindingContext.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)

Ustawia klucz dla właściwości wymagania tokenu, którego wartość jest BindingContext używana do komunikowania się z podmiotem wystawiającym, jeśli jest to wymagane dla wystawionego tokenu.Sets the key for the token requirement property whose value is the BindingContext used to talk to the issuing party if the requirement is for an issued token.

SetKeyDerivation(Boolean)

Ustawia wartość wskazującą, czy klucze pochodne są wymagane.Sets a value that indicates whether derived keys are required.

ToString()

Zwraca opis tej klasy.Returns a description of this class.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też