AsymmetricSecurityBindingElement Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Channels

Bütünleştirilmiş Kod:

System.ServiceModel.dll

Asimetrik şifreleme kullanarak kanal güvenliğini destekleyen özel bir bağlama öğesini temsil eder. Bu bağlama öğesi, gönderenin kimlik doğrulama belirtecini kullanarak iletiyi imzalar ve alıcının belirtecini kullanarak iletiyi şifreler.

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

Devralma

Object

BindingElement

SecurityBindingElement

AsymmetricSecurityBindingElement

Uygulamalar

IPolicyExportExtension

Örnekler

Aşağıdaki örnekte, bu sınıfı güvenlik bağlama öğesi olarak içeren bir özel bağlama oluşturmak için bu sınıfın nasıl kullanılacağı gösterilmektedir. Bu örnekteki kod hakkında daha fazla bilgi için bkz . Nasıl yapılır: X.509 Sertifikalarına Tutarlı Olarak Başvurma.

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

Açıklamalar

Özel bağlama, belirli bir sırada düzenlenmiş bağlama öğelerinin bir koleksiyonunu içerir: bağlama yığınının üst kısmını temsil eden öğe önce eklenir, sonraki öğe bağlama yığınında aşağı eklenir, ikinci eklenir ve bu şekilde devam eder.

Bu sınıfı bağlamaya eklemek için

1. oluşturun BindingElementCollection.

2. Bağlama yığınında bu bağlama öğesinin üzerinde olan isteğe bağlı TransactionFlowBindingElement ve ReliableSessionBindingElementgibi özel bağlama öğeleri oluşturun.

3. yöntemini kullanarak yukarıdaki sırayla BindingElementCollection oluşturulan öğeleri öğesine InsertItem(Int32, BindingElement) ekleyin.

4. örneğini AsymmetricSecurityBindingElement oluşturun ve koleksiyona ekleyin.

5. Koleksiyonuna gibi TcpTransportBindingElementek özel bağlama öğeleri ekleyin.

Bu sınıfı kullanmadan önce standart bağlamanın güvenlik gereksinimlerinizi karşılayıp karşılamadığını belirlemeniz gerekir.

Uyarı

Bu nesnenin bir örneği oluşturulduktan sonra, temel sınıfının SecurityBindingElement özelliklerini sabit olarak ele almalısınız. Bazı özelliklerde küme çağrısının öngörülemeyen etkileri olabilir: bağlama özelliğin eski değerini koruyabileceği gibi davranabilir ve çalışma zamanı hatası bir sorunun tek göstergesi olur. Bu şekilde davranan iki özellik ve MessageSecurityVersionşeklindedirKeyType. Bunun doğru olduğu başka özellikler de olabilir.

Oluşturucular

Name	Description
AsymmetricSecurityBindingElement()	Bu sınıfın bir örneğini oluşturur.
AsymmetricSecurityBindingElement(SecurityTokenParameters, SecurityTokenParameters)	Belirtilen alıcı ve başlatıcı belirteci parametreleriyle yeni bir örneği AsymmetricSecurityBindingElement başlatır.
AsymmetricSecurityBindingElement(SecurityTokenParameters)	Belirtilen alıcı belirteci parametreleriyle yeni bir örneği AsymmetricSecurityBindingElement başlatır.

Özellikler

Name	Description
AllowInsecureTransport	Karma modlu güvenli iletilerin HTTP gibi güvenli olmayan bir aktarım üzerinden gönderilip gönderilemeyeceğini gösteren bir değer alır veya ayarlar. (Devralındığı yer: SecurityBindingElement)
AllowSerializedSigningTokenOnReply	Yanıt iletisinde imzalama belirtecini serileştirmeye izin verilip verilmeyeceğini belirten bir değer alır veya ayarlar.
DefaultAlgorithmSuite	İleti şifreleme ve anahtar sarmalama algoritmalarını alır veya ayarlar. (Devralındığı yer: SecurityBindingElement)
EnableUnsecuredResponse	WCF'nin güvenli isteklere güvenli olmayan yanıtlar gönderip gönderip alamayacağını gösteren bir değer alır veya ayarlar. (Devralındığı yer: SecurityBindingElement)
EndpointSupportingTokenParameters	Belirteç parametrelerini destekleyen uç noktayı alır. (Devralındığı yer: SecurityBindingElement)
IncludeTimestamp	Zaman damgalarının her iletiye eklenip eklenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: SecurityBindingElement)
InitiatorTokenParameters	Başlatıcı için belirteç tanımını belirtir.
KeyEntropyMode	Anahtar oluşturmak için kullanılan entropi kaynağını alır veya ayarlar. (Devralındığı yer: SecurityBindingElement)
LocalClientSettings	İstemci tarafından kullanılan yerel güvenlik ayarlarına özgü bağlama özelliklerini alır. (Devralındığı yer: SecurityBindingElement)
LocalServiceSettings	Hizmet tarafından kullanılan yerel güvenlik ayarlarına özgü bağlama özelliklerini alır. (Devralındığı yer: SecurityBindingElement)
MessageProtectionOrder	Bu bağlama için ileti şifreleme ve imzalama sırasını alır veya ayarlar.
MessageSecurityVersion	İleti güvenlik sürümünü alır veya ayarlar. (Devralındığı yer: SecurityBindingElement)
OperationSupportingTokenParameters	Belirteç parametrelerini destekleyen işlem koleksiyonunu alır. (Devralındığı yer: SecurityBindingElement)
OptionalEndpointSupportingTokenParameters	Hizmet uç noktası için isteğe bağlı destekleyici belirteç parametrelerini alır. (Devralındığı yer: SecurityBindingElement)
OptionalOperationSupportingTokenParameters	belirteç parametrelerini destekleyen isteğe bağlı işlem koleksiyonunu alır. (Devralındığı yer: SecurityBindingElement)
ProtectTokens	Güvenlik bağlama öğesinin belirteçleri koruyup korumayacağını alır veya ayarlar. (Devralındığı yer: SecurityBindingElement)
RecipientTokenParameters	Alıcı için belirteç tanımını belirtir.
RequireSignatureConfirmation	İleti imzalarının onaylanması gerekip gerekmediğini belirten bir değer alır veya ayarlar.
SecurityHeaderLayout	Bu bağlama için güvenlik üst bilgisindeki öğelerin sırasını alır veya ayarlar. (Devralındığı yer: SecurityBindingElement)

Yöntemler

Name	Description
BuildChannelFactory<TChannel>(BindingContext)	Geçirilen ayarlara ve bağlama bağlamını SecurityBindingElement temel alan bir kanal fabrikası oluşturur. Oluşturulan kanal fabrikası, bağlama bağlamını (taşıma kanalı fabrikasını içeren) kanal fabrikasına yönelik bir başvuruya sahip olan soap ileti güvenlik kanalı fabrikasıdır. (Devralındığı yer: SecurityBindingElement)
BuildChannelFactoryCore<TChannel>(BindingContext)	Uygulandığında, belirtilen türde bir kanal fabrikası oluşturur. (Devralındığı yer: SecurityBindingElement)
BuildChannelListener<TChannel>(BindingContext)	Geçirilen ayarlara ve bağlama bağlamını SecurityBindingElement temel alan bir kanal dinleyicisi oluşturur. (Devralındığı yer: SecurityBindingElement)
BuildChannelListenerCore<TChannel>(BindingContext)	Uygulandığında, belirtilen türde bir kanal dinleyicisi oluşturur. (Devralındığı yer: SecurityBindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Belirtilen türdeki bir kanal fabrikasının oluşturulup oluşturulamayacağını belirler. (Devralındığı yer: SecurityBindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	Belirtilen türdeki bir kanal dinleyicisinin oluşturulup oluşturulamayacağını belirler. (Devralındığı yer: SecurityBindingElement)
Clone()	Geçerli sınıftan başlatılan bu sınıfın yeni bir örneğini oluşturur.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetProperty<T>(BindingContext)	öğesinden BindingContextbelirtilen nesneyi alır.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
SetKeyDerivation(Boolean)	Türetilmiş anahtarların gerekli olup olmadığını gösteren bir değer ayarlar.
ToString()	Bu AsymmetricSecurityBindingElement örneği temsil eden bir dize döndürür.

Belirtik Arabirim Kullanımları

Name	Description
IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	Web Hizmetleri Açıklama Dili (WSDL) bilgilerine eklenen bağlamalar hakkında özel ilke onayını dışarı aktarır.