SecurityBindingElement Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Channels

Bütünleştirilmiş Kodlar:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v10.0.652802

Kaynak:

SecurityBindingElement.cs

Uygulandığında kanal SOAP ileti güvenliğini destekleyen bir bağlama öğesini temsil eden soyut bir sınıf.

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement

public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement

type SecurityBindingElement = class
    inherit BindingElement

Public MustInherit Class SecurityBindingElement
Inherits BindingElement

Devralma

Object

BindingElement

SecurityBindingElement

Türetilmiş

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Açıklamalar

Bu sınıf, WCF'deki SOAP iletisi güvenlik bağlama öğelerinin temel sınıfıdır. Bu soyut sınıfın üç uygulaması vardır: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementve TransportSecurityBindingElement. Bu uygulamalar, WS-Security İlkesi belirtiminde tanımlanan bağlamaları modeller.

Ö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, bağlama yığınındaki sonraki öğe ikinci eklenir ve bu şekilde devam eder.

Bu sınıfı bağlamaya eklemek için aşağıdakileri yapın:

1. oluşturun BindingElementCollection.

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

3. Bu öğeleri yöntemini kullanarak InsertItem öğesine daha önce açıklanan BindingElementCollection sırayla ekleyin.

4. , veya TransportSecurityBindingElementgibi AsymmetricSecurityBindingElementSymmetricSecurityBindingElementöğesinden SecurityBindingElementtüretilmiş bir güvenlik bağlama öğesinin örneğini oluşturun.

5. Türetilmiş güvenlik bağlama öğesini koleksiyona ekleyin.

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

kullanma SecurityBindingElementhakkında daha fazla bilgi için bkz . SecurityBindingElement Kimlik Doğrulama Modları ve Nasıl yapılır: SecurityBindingElement Kullanarak Özel Bağlama Oluşturma.

Uyarı

Bir SecurityBindingElement nesne oluşturulduktan sonra özelliklerini sabit olarak kabul etmelisiniz. Bazı özelliklerde çağrının set ö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 da doğru olduğu başka özellikleri de olabilir.

Özellikler

Name	Description
DefaultAlgorithmSuite	İleti şifreleme ve anahtar sarmalama algoritmalarını alır veya ayarlar.
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.
EndpointSupportingTokenParameters	Belirteç parametrelerini destekleyen uç noktayı alır.
IncludeTimestamp	Zaman damgalarının her iletiye eklenip eklenmediğini belirten bir değer alır veya ayarlar.
KeyEntropyMode	Anahtar oluşturmak için kullanılan entropi kaynağını alır veya ayarlar.
LocalClientSettings	İstemci tarafından kullanılan yerel güvenlik ayarlarına özgü bağlama özelliklerini alır.
MessageSecurityVersion	İleti güvenlik sürümünü alır veya ayarlar.
OperationSupportingTokenParameters	Belirteç parametrelerini destekleyen işlem koleksiyonunu alır.
OptionalEndpointSupportingTokenParameters	Hizmet uç noktası için isteğe bağlı destekleyici belirteç parametrelerini alır.
OptionalOperationSupportingTokenParameters	belirteç parametrelerini destekleyen isteğe bağlı işlem koleksiyonunu alır.
SecurityHeaderLayout	Bu bağlama için güvenlik üst bilgisindeki öğelerin sırasını alır veya ayarlar.

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.
BuildChannelFactoryCore<TChannel>(BindingContext)	Uygulandığında, belirtilen türde bir kanal fabrikası oluşturur.
CanBuildChannelFactory<TChannel>(BindingContext)	Belirtilen türdeki bir kanal fabrikasının oluşturulup oluşturulamayacağını belirler.
Clone()	Türetilmiş bir sınıfta geçersiz kılındığında bağlama öğesi nesnesinin bir kopyasını döndürür. (Devralındığı yer: BindingElement)
CreateCertificateOverTransportBindingElement()	İstemcilerin SOAP ileti güvenliğini kullanarak sertifika tabanlı kimlik doğrulaması yapmasını bekleyen bir güvenlik bağlama öğesi oluşturur.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	İstemcilerin SOAP ileti güvenliğini kullanarak sertifika tabanlı kimlik doğrulaması yapmasını bekleyen bir güvenlik bağlama öğesi oluşturur.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Verilen bir belirteci kullanarak SOAP güvenlik tabanlı istemci kimlik doğrulaması gerektirecek şekilde yapılandırılmış bir güvenlik bağlama öğesi oluşturur. Bu bağlama öğesi, aktarım işleminin sunucu kimlik doğrulaması ve ileti koruması (örneğin, HTTPS) sağlamasını gerektirir.
CreateMutualCertificateBindingElement()	Sertifika tabanlı istemci kimlik doğrulaması ve sertifika tabanlı sunucu kimlik doğrulaması gerektirecek şekilde yapılandırılmış bir asimetrik güvenlik bağlama öğesi oluşturur.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Sertifika tabanlı istemci kimlik doğrulaması ve sertifika tabanlı sunucu kimlik doğrulaması gerektirecek şekilde yapılandırılmış bir asimetrik güvenlik bağlama öğesi oluşturur.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Sertifika tabanlı istemci kimlik doğrulaması ve sertifika tabanlı sunucu kimlik doğrulaması gerektirecek şekilde yapılandırılmış bir asimetrik güvenlik bağlama öğesi oluşturur.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	İstemci ve hizmet arasında güvenli bir konuşma kurmak için yapılandırılmış bir simetrik güvenlik bağlama öğesi oluşturur. Güvenli konuşma el sıkışmasının sonunda verilen güvenlik bağlamı belirteci, iletilerin güvenliğini sağlamak için kullanılır. bootstrap güvenlik bağlama öğesi, güvenli konuşma el sıkışma iletilerinin güvenliğinin nasıl sağlanmış olduğunu belirtir.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	İstemci ve hizmet arasında güvenli bir konuşma kurmak için yapılandırılmış bir simetrik güvenlik bağlama öğesi oluşturur. Güvenli konuşma el sıkışmasının sonunda verilen güvenlik bağlamı belirteci, iletilerin güvenliğini sağlamak için kullanılır.
CreateSecureConversationBindingElement(SecurityBindingElement)	İstemci ve hizmet arasında güvenli bir konuşma kurmak için yapılandırılmış bir simetrik güvenlik bağlama öğesi oluşturur. Güvenli konuşma el sıkışmasının sonunda verilen güvenlik bağlamı belirteci, iletilerin güvenliğini sağlamak için kullanılır. bootstrap güvenlik bağlama öğesi, güvenli konuşma el sıkışma iletilerinin güvenliğinin nasıl sağlanmış olduğunu belirtir.
CreateUserNameOverTransportBindingElement()	SOAP iletisinin bir parçası olarak gönderilen kullanıcı adı ve parola temelinde istemci kimlik doğrulaması için yapılandırılmış bir güvenlik bağlama öğesi oluşturur. Bağlama öğesi, aktarım işleminin sunucu kimlik doğrulaması ve ileti koruması (örneğin, HTTPS) sağlamasını gerektirir.
GetProperty<T>(BindingContext)	Belirtilen nesnesini kullanarak alır BindingContext.
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Gereksinim verilen bir belirteç içinse veren tarafla konuşmak için kullanılan BindingContext değeri olan belirteç gereksinimi özelliğinin anahtarını ayarlar.
SetKeyDerivation(Boolean)	Türetilmiş anahtarların gerekli olup olmadığını gösteren bir değer ayarlar.
ToString()	Bu sınıfın açıklamasını döndürür.

Ayrıca bkz.

• SecurityBindingElement Kimlik Doğrulama Modları
• Nasıl yapılır: SecurityBindingElement Kullanarak Özel Bağlama Oluşturma