SecurityBindingElement Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
En abstrakt klass som, när den implementeras, representerar ett bindningselement som stöder kanal-SOAP-meddelandesäkerhet.
public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElementpublic abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElementtype SecurityBindingElement = class
inherit BindingElementPublic MustInherit Class SecurityBindingElement
Inherits BindingElement- Arv
- Härledda
Kommentarer
Den här klassen är basklassen för SOAP-meddelandesäkerhetsbindningselementen i WCF. Det finns tre implementeringar av den här abstrakta klassen: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementoch TransportSecurityBindingElement. Dessa implementeringar modellerar bindningarna som definierats i WS-Security Policy-specifikationen.
En anpassad bindning innehåller en samling bindningselement ordnade i en specifik ordning: elementet som representerar överst i bindningsstacken läggs till först, nästa element nere i bindningsstacken läggs till tvåa och så vidare.
Gör följande för att lägga till den här klassen i en bindning:
Skapa en BindingElementCollection.
Skapa ett anpassat bindningselement som ligger ovanför det här bindningselementet i bindningsstacken, till exempel det valfria TransactionFlowBindingElement och ReliableSessionBindingElement.
Lägg till de här elementen i den ordning som tidigare beskrivits BindingElementCollection för att använda InsertItem -metoden.
Skapa en instans av ett säkerhetsbindningselement som härletts från SecurityBindingElement, till exempel AsymmetricSecurityBindingElement, SymmetricSecurityBindingElementeller TransportSecurityBindingElement.
Lägg till det härledda säkerhetsbindningselementet i samlingen.
Lägg till ytterligare anpassade bindningselement i samlingen, till exempel TcpTransportBindingElement.
Mer information om hur du använder en SecurityBindingElementfinns i SecurityBindingElement Authentication Modes and How to: Create a Custom Binding Using the SecurityBindingElement (Autentiseringslägen för SecurityBindingElement) och How to: Create a Custom Binding Using the SecurityBindingElement (Skapa en anpassad bindning med securityBindingElement).
Note
När ett SecurityBindingElement objekt har skapats bör du behandla dess egenskaper som oföränderliga. Att anropa set vissa egenskaper kan ha oförutsägbara effekter: bindningen kan fungera som om egenskapen behöll sitt gamla värde, med ett körningsfel som den enda indikationen på ett problem. Två egenskaper som är kända för att bete sig på det här sättet är KeyType och MessageSecurityVersion. Det kan finnas andra egenskaper som detta också är sant för.
Egenskaper
| Name | Description |
|---|---|
| AllowInsecureTransport |
Hämtar eller anger ett värde som anger om skyddade meddelanden i blandat läge kan skickas via en osäker transport, till exempel HTTP. |
| DefaultAlgorithmSuite |
Hämtar eller anger meddelandekryptering och nyckelomslutningsalgoritmer. |
| EnableUnsecuredResponse |
Hämtar eller anger ett värde som anger om WCF kan skicka och ta emot oskyddade svar på skyddade begäranden. |
| EndpointSupportingTokenParameters |
Hämtar slutpunkten som stöder tokenparametrar. |
| IncludeTimestamp |
Hämtar eller anger ett värde som anger om tidsstämplar ingår i varje meddelande. |
| KeyEntropyMode |
Hämtar eller anger källan för entropi som används för att skapa nycklar. |
| LocalClientSettings |
Hämtar bindningsegenskaperna som är specifika för lokala säkerhetsinställningar som används av klienten. |
| LocalServiceSettings |
Hämtar bindningsegenskaperna som är specifika för lokala säkerhetsinställningar som används av tjänsten. |
| MessageSecurityVersion |
Hämtar eller anger meddelandesäkerhetsversionen. |
| OperationSupportingTokenParameters |
Hämtar samlingen av åtgärder som stöder tokenparametrar. |
| OptionalEndpointSupportingTokenParameters |
Hämtar de valfria stödtokenparametrarna för tjänstslutpunkten. |
| OptionalOperationSupportingTokenParameters |
Hämtar samlingen med valfria åtgärder som stöder tokenparametrar. |
| ProtectTokens |
Hämtar eller anger om säkerhetsbindningselementet skyddar token. |
| SecurityHeaderLayout |
Hämtar eller anger ordningen på elementen i säkerhetsrubriken för den här bindningen. |
Metoder
| Name | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingContext) |
Skapar en kanalfabrik baserat på SecurityBindingElement inställningarna och bindningskontexten som skickas in. Kanalfabriken som skapats är en SOAP-meddelandesäkerhetskanalfabrik, som internt har en referens till kanalfabriken som motsvarar bindningskontexten (som inkluderar transportkanalfabriken). |
| BuildChannelFactoryCore<TChannel>(BindingContext) |
När den implementeras skapar du en kanalfabrik av en angiven typ. |
| BuildChannelListener<TChannel>(BindingContext) |
Skapar en kanallyssnare SecurityBindingElement baserat på inställningarna och bindningskontexten som skickas in. |
| BuildChannelListenerCore<TChannel>(BindingContext) |
När den implementeras skapar du en kanallyssnare av en angiven typ. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Avgör om en kanalfabrik av den angivna typen kan skapas. |
| CanBuildChannelListener<TChannel>(BindingContext) |
Avgör om en kanallyssnare av den angivna typen kan skapas. |
| Clone() |
När det åsidosättas i en härledd klass returnerar en kopia av bindningselementobjektet. (Ärvd från BindingElement) |
| CreateAnonymousForCertificateBindingElement() |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för anonym klientautentisering och certifikatbaserad serverautentisering. |
| CreateCertificateOverTransportBindingElement() |
Skapar ett säkerhetsbindningselement som förväntar sig att klienter utför certifikatbaserad autentisering med hjälp av SOAP-meddelandesäkerhet. |
| CreateCertificateOverTransportBindingElement(MessageSecurityVersion) |
Skapar ett säkerhetsbindningselement som förväntar sig att klienter utför certifikatbaserad autentisering med hjälp av SOAP-meddelandesäkerhet. |
| CreateCertificateSignatureBindingElement() |
Skapar ett bindningselement med ett certifikat för att signera meddelanden. Det här bindningselementet kan endast användas för enkelriktade meddelandeutbyten och kan bara signera meddelandet. |
| CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att kräva klientautentisering med hjälp av en symmetrisk nyckelbaserad utfärdad token. |
| CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att kräva klientautentisering baserat på en utfärdad token och serverautentisering baserat på servercertifikatet. |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att kräva klientautentisering baserat på en utfärdad token och serverautentisering baserat på servercertifikatet. |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att kräva klientautentisering baserat på en utfärdad token och serverautentisering baserat på servercertifikatet. |
| CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters) |
Skapar ett säkerhetsbindningselement som konfigurerats för att kräva SOAP-säkerhetsbaserad klientautentisering med hjälp av en utfärdad token. Det här bindningselementet kräver transport för att tillhandahålla serverautentisering och meddelandeskydd (till exempel HTTPS). |
| CreateKerberosBindingElement() |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att kräva klientautentisering baserat på klientens Kerberos-token. |
| CreateKerberosOverTransportBindingElement() |
Skapar ett säkerhetsbindningselement som är konfigurerat för att kräva SOAP-säkerhetsbaserad klientautentisering med hjälp av klientens Kerberos-token. Det här bindningselementet kräver transport för att tillhandahålla serverautentisering och meddelandeskydd (till exempel HTTPS). |
| CreateMutualCertificateBindingElement() |
Skapar ett asymmetriskt säkerhetsbindningselement som är konfigurerat för att kräva certifikatbaserad klientautentisering samt certifikatbaserad serverautentisering. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean) |
Skapar ett asymmetriskt säkerhetsbindningselement som är konfigurerat för att kräva certifikatbaserad klientautentisering samt certifikatbaserad serverautentisering. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion) |
Skapar ett asymmetriskt säkerhetsbindningselement som är konfigurerat för att kräva certifikatbaserad klientautentisering samt certifikatbaserad serverautentisering. |
| CreateMutualCertificateDuplexBindingElement() |
Skapar ett asymmetriskt säkerhetsbindningselement som är konfigurerat för att kräva certifikatbaserad klientautentisering samt certifikatbaserad serverautentisering. Det här autentiseringsläget kan användas för att skydda duplex-mönster för meddelandeutbyte och kräver att tjänsten konfigureras med klientcertifikatet out of band.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) |
Skapar ett asymmetriskt säkerhetsbindningselement som är konfigurerat för att kräva certifikatbaserad klientautentisering samt certifikatbaserad serverautentisering. Det här autentiseringsläget kan användas för att skydda duplex-meddelandeutbytesmönster och kräver att tjänsten konfigureras med klientcertifikatet out of band.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, Boolean, ChannelProtectionRequirements) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att upprätta en säker konversation mellan klienten och tjänsten. Säkerhetskontexttoken som utfärdas i slutet av handskakningen för säker konversation används för att skydda meddelandena. Säkerhetsbindningselementet bootstrap anger hur de säkra konversationshandskakningsmeddelandena skyddas. |
| CreateSecureConversationBindingElement(SecurityBindingElement, Boolean) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att upprätta en säker konversation mellan klienten och tjänsten. Säkerhetskontexttoken som utfärdas i slutet av handskakningen för säker konversation används för att skydda meddelandena. |
| CreateSecureConversationBindingElement(SecurityBindingElement) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att upprätta en säker konversation mellan klienten och tjänsten. Säkerhetskontexttoken som utfärdas i slutet av handskakningen för säker konversation används för att skydda meddelandena. Säkerhetsbindningselementet bootstrap anger hur de säkra konversationshandskakningsmeddelandena skyddas. |
| CreateSslNegotiationBindingElement(Boolean, Boolean) |
Skapar ett symmetriskt säkerhetsbindningselement som utför SOAP SSL-förhandling och anger om ett klientcertifikat och annullering krävs. |
| CreateSslNegotiationBindingElement(Boolean) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att utföra SSL-förhandling på SOAP-nivå mellan klienten och servern, och anger om ett klientcertifikat krävs. |
| CreateSspiNegotiationBindingElement() |
Skapar ett symmetriskt säkerhetsbindningselement som utför SOAP SSPI-förhandlingar baserat på förhandlingsautentiseringspaketet. |
| CreateSspiNegotiationBindingElement(Boolean) |
Skapar ett symmetriskt säkerhetsbindningselement som utför SOAP SSPI-förhandlingar baserat på förhandlingsautentiseringspaketet. |
| CreateSspiNegotiationOverTransportBindingElement() |
Skapar ett säkerhetsbindningselement som är konfigurerat för klientautentisering baserat på SOAP SSPI-förhandling med hjälp av paketet Förhandla om autentisering. Bindningselementet kräver transport för att tillhandahålla serverautentisering och meddelandeskydd (till exempel HTTPS). |
| CreateSspiNegotiationOverTransportBindingElement(Boolean) |
Skapar ett säkerhetsbindningselement som är konfigurerat för klientautentisering baserat på SOAP SSPI-förhandling med hjälp av paketet Förhandla om autentisering. Bindningselementet kräver transport för att tillhandahålla serverautentisering och meddelandeskydd (till exempel HTTPS). |
| CreateUserNameForCertificateBindingElement() |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att kräva användarnamn- och lösenordsbaserad klientautentisering och certifikatbaserad serverautentisering. Det skapade bindningselementet kräver att klienten konfigureras med ett tjänstcertifikat som är out-of-band innan en kommunikationskanal öppnas med en tjänst. |
| CreateUserNameForSslBindingElement() |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att kräva användarnamn- och lösenordsbaserad klientautentisering och certifikatbaserad serverautentisering. Klienten autentiserar servern med hjälp av SSL-protokollet på SOAP-nivå. |
| CreateUserNameForSslBindingElement(Boolean) |
Skapar ett symmetriskt säkerhetsbindningselement som är konfigurerat för att kräva användarnamn- och lösenordsbaserad klientautentisering och certifikatbaserad serverautentisering. Klienten autentiserar servern med hjälp av SSL-protokollet på SOAP-nivå. |
| CreateUserNameOverTransportBindingElement() |
Skapar ett säkerhetsbindningselement som är konfigurerat för klientautentisering baserat på ett användarnamn och lösenord som skickas som en del av SOAP-meddelandet. Bindningselementet kräver transport för att tillhandahålla serverautentisering och meddelandeskydd (till exempel HTTPS). |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetProperty<T>(BindingContext) |
Hämtar ett angivet objekt med den angivna BindingContext. |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext) |
Anger nyckeln för egenskapen tokenkrav vars värde är BindingContext som används för att kommunicera med den utfärdande parten om kravet gäller för en utfärdad token. |
| SetKeyDerivation(Boolean) |
Anger ett värde som anger om härledda nycklar krävs. |
| ToString() |
Returnerar en beskrivning av den här klassen. |