AsymmetricSecurityBindingElement Klasse

Definition

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

Vererbung

Object

BindingElement

SecurityBindingElement

AsymmetricSecurityBindingElement

Implementiert

IPolicyExportExtension

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Klasse verwenden, um eine benutzerdefinierte Bindung zu erstellen, die diese Klasse als Sicherheitsbindungselement enthält. Weitere Informationen zum Code in diesem Beispiel finden Sie unter How to: Consistently Reference X.509 Certificates.

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

Hinweise

Eine benutzerdefinierte Bindung enthält eine Auflistung von Bindungselementen, die in einer bestimmten Reihenfolge angeordnet sind: Das Element, das den oberen Rand des Bindungsstapels darstellt, wird zuerst hinzugefügt, das nächste Element unten im Bindungsstapel hinzugefügt, zweiten hinzugefügt usw.

So fügen Sie diese Klasse einer Bindung hinzu

1. Erstellen Sie eine BindingElementCollection.

2. Erstellen Sie benutzerdefinierte Bindungselemente, die über diesem Bindungselement im Bindungsstapel liegen, z. B. optional TransactionFlowBindingElement und ReliableSessionBindingElement.

3. Fügen Sie die erstellten Elemente in der vorherigen Reihenfolge zur BindingElementCollection Verwendung der InsertItem(Int32, BindingElement) Methode hinzu.

4. Erstellen Sie eine Instanz der AsymmetricSecurityBindingElement Auflistung, und fügen Sie sie der Auflistung hinzu.

5. Fügen Sie der Auflistung zusätzliche benutzerdefinierte Bindungselemente hinzu, z TcpTransportBindingElement. B. .

Bevor Sie diese Klasse verwenden, sollten Sie ermitteln, ob eine Standardbindung Ihre Sicherheitsanforderungen erfüllt.