SecurityBindingElement Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Een abstracte klasse die, wanneer geïmplementeerd, een bindingselement vertegenwoordigt dat ondersteuning biedt voor soap-berichtbeveiliging van kanalen.
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- Overname
- Afgeleid
Opmerkingen
Deze klasse is de basisklasse voor de SOAP-berichtbeveiligingsbindingselementen in WCF. Er zijn drie implementaties van deze abstracte klasse: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementen TransportSecurityBindingElement. Deze implementaties modelleren de bindingen die zijn gedefinieerd in de specificatie WS-Security Beleid.
Een aangepaste binding bevat een verzameling bindingselementen die in een specifieke volgorde zijn gerangschikt: het element dat de bovenkant van de bindingsstack vertegenwoordigt, wordt eerst het volgende element in de bindingsstack toegevoegd, enzovoort.
Ga als volgt te werk om deze klasse toe te voegen aan een binding:
Maak een BindingElementCollection.
Maak een aangepast bindingselement boven dit bindingselement in de bindingsstack, zoals de optionele TransactionFlowBindingElement en ReliableSessionBindingElement.
Voeg deze elementen toe in de volgorde die eerder aan de BindingElementCollection methode InsertItem is beschreven.
Maak een exemplaar van een beveiligingsbindingselement dat is afgeleid van SecurityBindingElement, zoals AsymmetricSecurityBindingElement, SymmetricSecurityBindingElementof TransportSecurityBindingElement.
Voeg het afgeleide beveiligingsbindingselement toe aan de verzameling.
Voeg aanvullende aangepaste bindingselementen toe aan de verzameling, zoals TcpTransportBindingElement.
Zie SecurityBindingElement Authentication Modes and How to: Create a Custom Binding Using the SecurityBindingElement for more information about using a, securityBindingElement authentication modes and How to: Create a Custom Binding Using the SecurityBindingElement.SecurityBindingElement
Note
Zodra een SecurityBindingElement object is gemaakt, moet u de eigenschappen ervan behandelen als onveranderbaar. Het aanroepen van set sommige eigenschappen kan onvoorspelbare effecten hebben: de binding kan zich gedragen alsof de eigenschap de oude waarde behoudt, waarbij een runtimefout de enige indicatie is van een probleem. Twee eigenschappen die bekend zijn om zich op deze manier te gedragen, zijn KeyType en MessageSecurityVersion. Er kunnen andere eigenschappen zijn waarvan dit ook waar is.
Eigenschappen
| Name | Description |
|---|---|
| AllowInsecureTransport |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of beveiligde berichten in de gemengde modus kunnen worden verzonden via een onbeveiligd transport zoals HTTP. |
| DefaultAlgorithmSuite |
Hiermee haalt u de berichtversleuteling en sleutelterugloopalgoritmen op of stelt u deze in. |
| EnableUnsecuredResponse |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of WCF onbeveiligde antwoorden op beveiligde aanvragen kan verzenden en ontvangen. |
| EndpointSupportingTokenParameters |
Hiermee haalt u het eindpunt op dat tokenparameters ondersteunt. |
| IncludeTimestamp |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of tijdstempels zijn opgenomen in elk bericht. |
| KeyEntropyMode |
Hiermee haalt u de bron van entropie op die wordt gebruikt voor het maken van sleutels. |
| LocalClientSettings |
Hiermee haalt u de bindingseigenschappen op die specifiek zijn voor lokale beveiligingsinstellingen die door de client worden gebruikt. |
| LocalServiceSettings |
Hiermee haalt u de bindingseigenschappen op die specifiek zijn voor lokale beveiligingsinstellingen die door de service worden gebruikt. |
| MessageSecurityVersion |
Hiermee haalt u de beveiligingsversie van het bericht op of stelt u deze in. |
| OperationSupportingTokenParameters |
Hiermee wordt de verzameling bewerkingsparameters opgehaald die tokenparameters ondersteunen. |
| OptionalEndpointSupportingTokenParameters |
Hiermee haalt u de optionele ondersteunende tokenparameters voor het service-eindpunt op. |
| OptionalOperationSupportingTokenParameters |
Hiermee haalt u de verzameling optionele bewerkingen op die tokenparameters ondersteunen. |
| ProtectTokens |
Hiermee haalt u op of stelt u in of het beveiligingsbindingselement tokens beveiligt. |
| SecurityHeaderLayout |
Hiermee haalt u de volgorde van de elementen in de beveiligingskoptekst voor deze binding op of stelt u deze in. |
Methoden
| Name | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingContext) |
Hiermee maakt u een kanaalfactory op basis van de SecurityBindingElement instellingen en de bindingscontext die wordt doorgegeven. De kanaalfactory die is gemaakt, is een SOAP-berichtbeveiligingskanaalfactory, die intern een verwijzing heeft naar de kanaalfactory die overeenkomt met de bindingscontext (inclusief de transportkanaalfactory). |
| BuildChannelFactoryCore<TChannel>(BindingContext) |
Wanneer deze is geïmplementeerd, maakt u een kanaalfactory van een opgegeven type. |
| BuildChannelListener<TChannel>(BindingContext) |
Hiermee maakt u een kanaallistener op basis van de SecurityBindingElement instellingen en de bindingscontext die is doorgegeven. |
| BuildChannelListenerCore<TChannel>(BindingContext) |
Wanneer deze is geïmplementeerd, maakt u een kanaallistener van een opgegeven type. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Bepaalt of een kanaalfactory van het opgegeven type kan worden gebouwd. |
| CanBuildChannelListener<TChannel>(BindingContext) |
Bepaalt of een kanaallistener van het opgegeven type kan worden gebouwd. |
| Clone() |
Wanneer deze wordt overschreven in een afgeleide klasse, retourneert u een kopie van het object voor het bindingselement. (Overgenomen van BindingElement) |
| CreateAnonymousForCertificateBindingElement() |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd voor anonieme clientverificatie en serververificatie op basis van certificaten. |
| CreateCertificateOverTransportBindingElement() |
Hiermee maakt u een beveiligingsbindingselement dat verwacht dat clients verificatie op basis van certificaten uitvoeren met soap-berichtbeveiliging. |
| CreateCertificateOverTransportBindingElement(MessageSecurityVersion) |
Hiermee maakt u een beveiligingsbindingselement dat verwacht dat clients verificatie op basis van certificaten uitvoeren met soap-berichtbeveiliging. |
| CreateCertificateSignatureBindingElement() |
Hiermee maakt u een bindingselement met behulp van een certificaat om berichten te ondertekenen. Dit bindingselement kan alleen worden gebruikt voor berichtenuitwisseling in één richting en kan alleen het bericht ondertekenen. |
| CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie te vereisen met behulp van een uitgegeven token op basis van symmetrische sleutels. |
| CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie te vereisen op basis van een uitgegeven token en serververificatie op basis van het servercertificaat. |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie te vereisen op basis van een uitgegeven token en serververificatie op basis van het servercertificaat. |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie te vereisen op basis van een uitgegeven token en serververificatie op basis van het servercertificaat. |
| CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters) |
Hiermee maakt u een beveiligingsbindingselement dat is geconfigureerd om op SOAP-beveiliging gebaseerde clientverificatie te vereisen met behulp van een uitgegeven token. Dit bindingselement vereist het transport om serververificatie en berichtbeveiliging te bieden (bijvoorbeeld HTTPS). |
| CreateKerberosBindingElement() |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie te vereisen op basis van het Kerberos-token van de client. |
| CreateKerberosOverTransportBindingElement() |
Hiermee maakt u een beveiligingsbindingselement dat is geconfigureerd om op SOAP-beveiliging gebaseerde clientverificatie te vereisen met behulp van het Kerberos-token van de client. Dit bindingselement vereist het transport om serververificatie en berichtbeveiliging te bieden (bijvoorbeeld HTTPS). |
| CreateMutualCertificateBindingElement() |
Hiermee maakt u een asymmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie op basis van certificaten en serververificatie op basis van certificaten te vereisen. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean) |
Hiermee maakt u een asymmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie op basis van certificaten en serververificatie op basis van certificaten te vereisen. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion) |
Hiermee maakt u een asymmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie op basis van certificaten en serververificatie op basis van certificaten te vereisen. |
| CreateMutualCertificateDuplexBindingElement() |
Hiermee maakt u een asymmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie op basis van certificaten en serververificatie op basis van certificaten te vereisen. Deze verificatiemodus kan worden gebruikt om dubbelzijdige berichtuitwisselingspatronen te beveiligen en vereist dat de service wordt geconfigureerd met het clientcertificaat buiten band. |
| CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion) |
Hiermee maakt u een asymmetrisch beveiligingsbindingselement dat is geconfigureerd om clientverificatie op basis van certificaten en serververificatie op basis van certificaten te vereisen. Deze verificatiemodus kan worden gebruikt om dubbelzijdige berichtuitwisselingspatronen te beveiligen en vereist dat de service wordt geconfigureerd met het clientcertificaat buiten band. |
| CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd om een veilig gesprek tot stand te brengen tussen de client en de service. Het beveiligingscontexttoken dat aan het einde van de veilige gesprekshanddruk wordt uitgegeven, wordt gebruikt om de berichten te beveiligen. Het bootstrap-beveiligingsbindingselement geeft aan hoe de beveiligde handshake-berichten van gesprekken worden beveiligd. |
| CreateSecureConversationBindingElement(SecurityBindingElement, Boolean) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd om een veilig gesprek tot stand te brengen tussen de client en de service. Het beveiligingscontexttoken dat aan het einde van de veilige gesprekshanddruk wordt uitgegeven, wordt gebruikt om de berichten te beveiligen. |
| CreateSecureConversationBindingElement(SecurityBindingElement) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd om een veilig gesprek tot stand te brengen tussen de client en de service. Het beveiligingscontexttoken dat aan het einde van de veilige gesprekshanddruk wordt uitgegeven, wordt gebruikt om de berichten te beveiligen. Het bootstrap-beveiligingsbindingselement geeft aan hoe de beveiligde handshake-berichten van gesprekken worden beveiligd. |
| CreateSslNegotiationBindingElement(Boolean, Boolean) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat SOAP SSL-onderhandeling doet, waarbij wordt aangegeven of een clientcertificaat en annulering vereist is. |
| CreateSslNegotiationBindingElement(Boolean) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd voor HET uitvoeren van SSL-onderhandeling op SOAP-niveau tussen de client en de server, waarbij wordt aangegeven of een clientcertificaat vereist is. |
| CreateSspiNegotiationBindingElement() |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat SOAP SSPI-onderhandeling doet op basis van het onderhandelingspakket voor verificatie. |
| CreateSspiNegotiationBindingElement(Boolean) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat SOAP SSPI-onderhandeling doet op basis van het onderhandelingspakket voor verificatie. |
| CreateSspiNegotiationOverTransportBindingElement() |
Hiermee maakt u een beveiligingsbindingselement dat is geconfigureerd voor clientverificatie op basis van SOAP SSPI-onderhandeling met behulp van het verificatiepakket Negotiate. Het bindingselement vereist het transport om serververificatie en berichtbeveiliging te bieden (bijvoorbeeld HTTPS). |
| CreateSspiNegotiationOverTransportBindingElement(Boolean) |
Hiermee maakt u een beveiligingsbindingselement dat is geconfigureerd voor clientverificatie op basis van SOAP SSPI-onderhandeling met behulp van het verificatiepakket Negotiate. Het bindingselement vereist het transport om serververificatie en berichtbeveiliging te bieden (bijvoorbeeld HTTPS). |
| CreateUserNameForCertificateBindingElement() |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd voor het vereisen van clientverificatie op basis van gebruikersnaam en wachtwoord en serververificatie op basis van certificaten. Voor het gemaakte bindingselement moet de client worden geconfigureerd met een servicecertificaat dat out-of-band is voordat een communicatiekanaal met een service wordt geopend. |
| CreateUserNameForSslBindingElement() |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd voor het vereisen van clientverificatie op basis van gebruikersnaam en wachtwoord en serververificatie op basis van certificaten. De client verifieert de server met behulp van het SSL-protocol op SOAP-niveau. |
| CreateUserNameForSslBindingElement(Boolean) |
Hiermee maakt u een symmetrisch beveiligingsbindingselement dat is geconfigureerd voor het vereisen van clientverificatie op basis van gebruikersnaam en wachtwoord en serververificatie op basis van certificaten. De client verifieert de server met behulp van het SSL-protocol op SOAP-niveau. |
| CreateUserNameOverTransportBindingElement() |
Hiermee maakt u een beveiligingsbindingselement dat is geconfigureerd voor clientverificatie op basis van een gebruikersnaam en wachtwoord die als onderdeel van het SOAP-bericht worden verzonden. Het bindingselement vereist het transport om serververificatie en berichtbeveiliging te bieden (bijvoorbeeld HTTPS). |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetProperty<T>(BindingContext) |
Hiermee haalt u een opgegeven object op met behulp van de opgegeven BindingContext. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext) |
Hiermee stelt u de sleutel in voor de eigenschap tokenvereiste waarvan de waarde de BindingContext is die wordt gebruikt om met de uitgevende partij te communiceren als de vereiste voor een uitgegeven token is. |
| SetKeyDerivation(Boolean) |
Hiermee stelt u een waarde in die aangeeft of afgeleide sleutels vereist zijn. |
| ToString() |
Retourneert een beschrijving van deze klasse. |