AsymmetricSecurityBindingElement 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.
Vertegenwoordigt een aangepast bindingselement dat ondersteuning biedt voor kanaalbeveiliging met behulp van asymmetrische versleuteling. Dit bindingselement ondertekent het bericht met behulp van het verificatietoken van de afzender en versleutelt het bericht met behulp van het token van de geadresseerde.
public ref class AsymmetricSecurityBindingElement sealed : System::ServiceModel::Channels::SecurityBindingElement, System::ServiceModel::Description::IPolicyExportExtension
public sealed class AsymmetricSecurityBindingElement : System.ServiceModel.Channels.SecurityBindingElement, System.ServiceModel.Description.IPolicyExportExtension
type AsymmetricSecurityBindingElement = class
inherit SecurityBindingElement
interface IPolicyExportExtension
Public NotInheritable Class AsymmetricSecurityBindingElement
Inherits SecurityBindingElement
Implements IPolicyExportExtension
- Overname
- Implementeringen
Voorbeelden
In het volgende voorbeeld ziet u hoe u deze klasse gebruikt om een aangepaste binding te maken die deze klasse als beveiligingsbindingselement bevat. Zie How to: Consistent Reference X.509 Certificates(X.509-certificaten) voor meer informatie over de code in dit voorbeeld.
public Binding CreateClientBinding()
{
AsymmetricSecurityBindingElement abe =
(AsymmetricSecurityBindingElement)SecurityBindingElement.
CreateMutualCertificateBindingElement(
MessageSecurityVersion.
WSSecurity10WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10);
abe.SetKeyDerivation(false);
X509SecurityTokenParameters istp =
abe.InitiatorTokenParameters as X509SecurityTokenParameters;
if (istp != null)
{
istp.X509ReferenceStyle =
X509KeyIdentifierClauseType.IssuerSerial;
}
X509SecurityTokenParameters rstp =
abe.RecipientTokenParameters as X509SecurityTokenParameters;
if (rstp != null)
{
rstp.X509ReferenceStyle =
X509KeyIdentifierClauseType.IssuerSerial;
}
HttpTransportBindingElement transport =
new HttpTransportBindingElement();
return new CustomBinding(abe, transport);
}
Public Function CreateClientBinding() As Binding
Dim abe As AsymmetricSecurityBindingElement = CType(SecurityBindingElement.CreateMutualCertificateBindingElement(MessageSecurityVersion.WSSecurity10WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10), AsymmetricSecurityBindingElement)
abe.SetKeyDerivation(False)
Dim istp As X509SecurityTokenParameters = TryCast(abe.InitiatorTokenParameters, X509SecurityTokenParameters)
If istp IsNot Nothing Then
istp.X509ReferenceStyle = X509KeyIdentifierClauseType.IssuerSerial
End If
Dim rstp As X509SecurityTokenParameters = TryCast(abe.RecipientTokenParameters, X509SecurityTokenParameters)
If rstp IsNot Nothing Then
rstp.X509ReferenceStyle = X509KeyIdentifierClauseType.IssuerSerial
End If
Dim transport As New HttpTransportBindingElement()
Return New CustomBinding(abe, transport)
End Function
Opmerkingen
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 toegevoegd, het volgende element omlaag in de bindingsstack, wordt tweede toegevoegd, enzovoort.
Deze klasse toevoegen aan een binding
Maak een BindingElementCollection.
Maak aangepaste bindingselementen boven dit bindingselement in de bindingsstack, zoals de optionele TransactionFlowBindingElement en ReliableSessionBindingElement.
Voeg de gemaakte elementen in de voorgaande volgorde toe aan de BindingElementCollection methode.InsertItem(Int32, BindingElement)
Maak een exemplaar van AsymmetricSecurityBindingElement en voeg deze toe aan de verzameling.
Voeg aanvullende aangepaste bindingselementen toe aan de verzameling, zoals TcpTransportBindingElement.
Voordat u deze klasse gebruikt, moet u bepalen of een standaardbinding voldoet aan uw beveiligingsvereisten.
Note
Zodra een exemplaar van dit object is gemaakt, moet u de eigenschappen van de basisklasse SecurityBindingElement behandelen als onveranderbaar. Het aanroepen van bepaalde eigenschappen kan onvoorspelbare effecten hebben: de binding gedraagt zich mogelijk 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 waar dit van is.
Constructors
| Name | Description |
|---|---|
| AsymmetricSecurityBindingElement() |
Hiermee maakt u een exemplaar van deze klasse. |
| AsymmetricSecurityBindingElement(SecurityTokenParameters, SecurityTokenParameters) |
Initialiseert een nieuw exemplaar van AsymmetricSecurityBindingElement de opgegeven geadresseerde en initiatortokenparameters. |
| AsymmetricSecurityBindingElement(SecurityTokenParameters) |
Initialiseert een nieuw exemplaar van AsymmetricSecurityBindingElement met de opgegeven parameters voor het geadresseerdetoken. |
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. (Overgenomen van SecurityBindingElement) |
| AllowSerializedSigningTokenOnReply |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serialiseren van een ondertekeningstoken op een antwoordbericht is toegestaan. |
| DefaultAlgorithmSuite |
Hiermee haalt u de berichtversleuteling en sleutelterugloopalgoritmen op of stelt u deze in. (Overgenomen van SecurityBindingElement) |
| EnableUnsecuredResponse |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of WCF onbeveiligde antwoorden op beveiligde aanvragen kan verzenden en ontvangen. (Overgenomen van SecurityBindingElement) |
| EndpointSupportingTokenParameters |
Hiermee haalt u het eindpunt op dat tokenparameters ondersteunt. (Overgenomen van SecurityBindingElement) |
| IncludeTimestamp |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of tijdstempels zijn opgenomen in elk bericht. (Overgenomen van SecurityBindingElement) |
| InitiatorTokenParameters |
Hiermee geeft u de tokendefinitie voor de initiator. |
| KeyEntropyMode |
Hiermee haalt u de bron van entropie op die wordt gebruikt voor het maken van sleutels. (Overgenomen van SecurityBindingElement) |
| LocalClientSettings |
Hiermee haalt u de bindingseigenschappen op die specifiek zijn voor lokale beveiligingsinstellingen die door de client worden gebruikt. (Overgenomen van SecurityBindingElement) |
| LocalServiceSettings |
Hiermee haalt u de bindingseigenschappen op die specifiek zijn voor lokale beveiligingsinstellingen die door de service worden gebruikt. (Overgenomen van SecurityBindingElement) |
| MessageProtectionOrder |
Hiermee haalt u de volgorde van berichtversleuteling en ondertekening voor deze binding op of stelt u deze in. |
| MessageSecurityVersion |
Hiermee haalt u de beveiligingsversie van het bericht op of stelt u deze in. (Overgenomen van SecurityBindingElement) |
| OperationSupportingTokenParameters |
Hiermee wordt de verzameling bewerkingsparameters opgehaald die tokenparameters ondersteunen. (Overgenomen van SecurityBindingElement) |
| OptionalEndpointSupportingTokenParameters |
Hiermee haalt u de optionele ondersteunende tokenparameters voor het service-eindpunt op. (Overgenomen van SecurityBindingElement) |
| OptionalOperationSupportingTokenParameters |
Hiermee haalt u de verzameling optionele bewerkingen op die tokenparameters ondersteunen. (Overgenomen van SecurityBindingElement) |
| ProtectTokens |
Hiermee haalt u op of stelt u in of het beveiligingsbindingselement tokens beveiligt. (Overgenomen van SecurityBindingElement) |
| RecipientTokenParameters |
Hiermee geeft u de tokendefinitie voor de ontvanger op. |
| RequireSignatureConfirmation |
Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of berichthandtekeningen moeten worden bevestigd. |
| SecurityHeaderLayout |
Hiermee haalt u de volgorde van de elementen in de beveiligingskoptekst voor deze binding op of stelt u deze in. (Overgenomen van SecurityBindingElement) |
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). (Overgenomen van SecurityBindingElement) |
| BuildChannelFactoryCore<TChannel>(BindingContext) |
Wanneer deze is geïmplementeerd, maakt u een kanaalfactory van een opgegeven type. (Overgenomen van SecurityBindingElement) |
| BuildChannelListener<TChannel>(BindingContext) |
Hiermee maakt u een kanaallistener op basis van de SecurityBindingElement instellingen en de bindingscontext die is doorgegeven. (Overgenomen van SecurityBindingElement) |
| BuildChannelListenerCore<TChannel>(BindingContext) |
Wanneer deze is geïmplementeerd, maakt u een kanaallistener van een opgegeven type. (Overgenomen van SecurityBindingElement) |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Bepaalt of een kanaalfactory van het opgegeven type kan worden gebouwd. (Overgenomen van SecurityBindingElement) |
| CanBuildChannelListener<TChannel>(BindingContext) |
Bepaalt of een kanaallistener van het opgegeven type kan worden gebouwd. (Overgenomen van SecurityBindingElement) |
| Clone() |
Hiermee maakt u een nieuw exemplaar van deze klasse die is geïnitialiseerd op basis van de huidige. |
| 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 uit de 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) |
| SetKeyDerivation(Boolean) |
Hiermee stelt u een waarde in die aangeeft of afgeleide sleutels vereist zijn. |
| ToString() |
Retourneert een tekenreeks die dit AsymmetricSecurityBindingElement exemplaar vertegenwoordigt. |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) |
Hiermee exporteert u een aangepaste beleidsverklaring over bindingen, die wordt toegevoegd aan de WSDL-informatie (Web Services Description Language). |