SecurityBindingElement Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- Pochodne
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:
Utwórz element BindingElementCollection.
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.
Dodaj te elementy w kolejności opisanej wcześniej przy BindingElementCollection użyciu InsertItem metody .
Utwórz wystąpienie elementu powiązania zabezpieczeń pochodzącego z SecurityBindingElementelementu , takiego jak AsymmetricSecurityBindingElement, SymmetricSecurityBindingElementlub TransportSecurityBindingElement.
Dodaj pochodny element powiązania zabezpieczeń do kolekcji.
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
AllowInsecureTransport |
Pobiera lub ustawia wartość wskazującą, czy komunikaty zabezpieczone w trybie mieszanym można wysyłać za pośrednictwem niezabezpieczonego transportu, takiego jak HTTP. |
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. |
LocalServiceSettings |
Pobiera właściwości powiązania specyficzne dla ustawień zabezpieczeń lokalnych używanych przez usługę. |
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. |
ProtectTokens |
Pobiera lub ustawia, czy element powiązania zabezpieczeń chroni tokeny. |
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) |
Tworzy odbiornik kanału na SecurityBindingElement podstawie ustawień i kontekstu powiązania przekazanego. |
BuildChannelListener<TChannel>(BindingContext) |
Inicjuje odbiornik kanału, aby akceptował kanały określonego typu z kontekstu powiązania. (Odziedziczone po BindingElement) |
BuildChannelListenerCore<TChannel>(BindingContext) |
Po zaimplementowaniu program tworzy odbiornik kanału o określonym typie. |
CanBuildChannelFactory<TChannel>(BindingContext) |
Określa, czy można skompilować fabrykę kanałów określonego typu. |
CanBuildChannelListener<TChannel>(BindingContext) |
Określa, czy można skompilować odbiornik kanału 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) |
CreateAnonymousForCertificateBindingElement() |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do uwierzytelniania anonimowego klienta i uwierzytelniania serwera opartego na certyfikatach. |
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. |
CreateCertificateSignatureBindingElement() |
Tworzy element powiązania przy użyciu certyfikatu do podpisywania komunikatów. Ten element powiązania może być używany tylko w przypadku jednokierunkowych wymiany komunikatów i może być dostępny tylko podczas podpisywania wiadomości. |
CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters) |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta przy użyciu wystawionego tokenu opartego na kluczu symetrycznym. |
CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters) |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta na podstawie wystawionego tokenu i uwierzytelniania serwera na podstawie certyfikatu serwera. |
CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters) |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta na podstawie wystawionego tokenu i uwierzytelniania serwera na podstawie certyfikatu serwera. |
CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean) |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta na podstawie wystawionego tokenu i uwierzytelniania serwera na podstawie certyfikatu serwera. |
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). |
CreateKerberosBindingElement() |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta na podstawie tokenu Kerberos klienta. |
CreateKerberosOverTransportBindingElement() |
Tworzy element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na zabezpieczeniach protokołu SOAP przy użyciu tokenu Kerberos klienta. 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. |
CreateMutualCertificateDuplexBindingElement() |
Tworzy asymetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach. Ten tryb uwierzytelniania może służyć do zabezpieczania wzorców dwukierunkowej wymiany komunikatów i wymaga skonfigurowania usługi za pomocą certyfikatu klienta poza pasmem. |
CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion) |
Tworzy asymetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na certyfikatach, a także uwierzytelniania serwera opartego na certyfikatach. Ten tryb uwierzytelniania może służyć do zabezpieczania wzorców wymiany komunikatów dwukierunkowych i wymaga skonfigurowania usługi za pomocą certyfikatu klienta poza pasmem. |
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. |
CreateSslNegotiationBindingElement(Boolean) |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do negocjowania protokołu SSL na poziomie protokołu SOAP między klientem a serwerem, zauważając, czy certyfikat klienta jest wymagany. |
CreateSslNegotiationBindingElement(Boolean, Boolean) |
Tworzy symetryczny element powiązania zabezpieczeń, który wykonuje negocjacje protokołu SSL protokołu SOAP, zauważając, czy certyfikat klienta i anulowanie jest wymagane. |
CreateSspiNegotiationBindingElement() |
Tworzy symetryczny element powiązania zabezpieczeń, który wykonuje negocjacje protokołu SSPI protokołu SOAP na podstawie pakietu uwierzytelniania Negocjuj. |
CreateSspiNegotiationBindingElement(Boolean) |
Tworzy symetryczny element powiązania zabezpieczeń, który wykonuje negocjacje protokołu SSPI protokołu SOAP na podstawie pakietu uwierzytelniania Negocjuj. |
CreateSspiNegotiationOverTransportBindingElement() |
Tworzy element powiązania zabezpieczeń skonfigurowany do uwierzytelniania klienta na podstawie negocjacji protokołu SSPI protokołu SOAP przy użyciu pakietu uwierzytelniania Negocjuj. Element powiązania wymaga transportu, aby zapewnić uwierzytelnianie serwera i ochronę komunikatów (na przykład HTTPS). |
CreateSspiNegotiationOverTransportBindingElement(Boolean) |
Tworzy element powiązania zabezpieczeń skonfigurowany do uwierzytelniania klienta na podstawie negocjacji protokołu SSPI protokołu SOAP przy użyciu pakietu uwierzytelniania Negocjuj. Element powiązania wymaga transportu, aby zapewnić uwierzytelnianie serwera i ochronę komunikatów (na przykład HTTPS). |
CreateUserNameForCertificateBindingElement() |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na nazwach użytkownika i hasłach oraz uwierzytelniania serwera opartego na certyfikatach. Utworzony element powiązania wymaga skonfigurowania klienta z certyfikatem usługi, który jest poza pasmem przed otwarciem kanału komunikacyjnego z usługą. |
CreateUserNameForSslBindingElement() |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na nazwach użytkownika i hasłach oraz uwierzytelniania serwera opartego na certyfikatach. Klient uwierzytelnia serwer przy użyciu protokołu SSL na poziomie protokołu SOAP. |
CreateUserNameForSslBindingElement(Boolean) |
Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do wymagania uwierzytelniania klienta opartego na nazwach użytkownika i hasłach oraz uwierzytelniania serwera opartego na certyfikatach. Klient uwierzytelnia serwer przy użyciu protokołu SSL na poziomie protokołu SOAP. |
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. |