SecurityBindingElement Kelas

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Sumber:

SecurityBindingElement.cs

Kelas abstrak yang, saat diimplementasikan, mewakili elemen pengikatan yang mendukung keamanan pesan SOAP saluran.

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

Warisan

Object

BindingElement

SecurityBindingElement

Turunan

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Keterangan

Kelas ini adalah kelas dasar untuk elemen pengikatan keamanan pesan SOAP di WCF. Ada tiga implementasi dari kelas abstrak ini: SymmetricSecurityBindingElement, , AsymmetricSecurityBindingElementdan TransportSecurityBindingElement. Implementasi ini memodelkan pengikatan yang ditentukan dalam spesifikasi Kebijakan WS-Security.

Pengikatan kustom berisi kumpulan elemen pengikatan yang disusun dalam urutan tertentu: elemen yang mewakili bagian atas tumpukan pengikatan ditambahkan terlebih dahulu, elemen berikutnya ke bawah dalam tumpukan pengikatan ditambahkan kedua, dan sebagainya.

Untuk menambahkan kelas ini ke pengikatan, lakukan hal berikut:

1. Buat BindingElementCollection.

2. Buat elemen pengikatan kustom yang berada di atas elemen pengikatan ini di tumpukan pengikatan, seperti opsional TransactionFlowBindingElement dan ReliableSessionBindingElement.

3. Tambahkan elemen-elemen ini dalam urutan yang dijelaskan sebelumnya ke BindingElementCollection menggunakan InsertItem metode .

4. Buat instans elemen pengikatan keamanan yang berasal dari SecurityBindingElement, seperti AsymmetricSecurityBindingElement, , SymmetricSecurityBindingElementatau TransportSecurityBindingElement.

5. Tambahkan elemen pengikatan keamanan turunan ke koleksi.

6. Tambahkan elemen pengikatan kustom tambahan ke koleksi, seperti TcpTransportBindingElement.

Untuk informasi selengkapnya tentang menggunakan SecurityBindingElement, lihat Mode Autentikasi SecurityBindingElement dan Cara: Membuat Pengikatan Kustom Menggunakan SecurityBindingElement.

Catatan

SecurityBindingElement Setelah objek dibuat, Anda harus memperlakukan propertinya sebagai tidak dapat diubah. Memanggil set beberapa properti mungkin memiliki efek yang tidak dapat diprediksi: pengikatan mungkin berperilaku seolah-olah properti mempertahankan nilai lamanya, dengan kegagalan runtime menjadi satu-satunya indikasi masalah. Dua properti yang diketahui bersifat seperti ini adalah KeyType dan MessageSecurityVersion. Mungkin ada properti lain yang ini juga benar.

Properti

DefaultAlgorithmSuite	Mendapatkan atau mengatur enkripsi pesan dan algoritma pembungkus kunci.
EnableUnsecuredResponse	Mendapatkan atau menetapkan nilai yang menunjukkan apakah WCF dapat mengirim dan menerima respons yang tidak aman terhadap permintaan aman.
EndpointSupportingTokenParameters	Mendapatkan titik akhir yang mendukung parameter token.
IncludeTimestamp	Mendapatkan atau menetapkan nilai yang menunjukkan apakah stempel waktu disertakan dalam setiap pesan.
KeyEntropyMode	Mendapatkan atau mengatur sumber entropi yang digunakan untuk membuat kunci.
LocalClientSettings	Mendapatkan properti pengikatan khusus untuk pengaturan keamanan lokal yang digunakan oleh klien.
MessageSecurityVersion	Mendapatkan atau mengatur versi keamanan pesan.
SecurityHeaderLayout	Mendapatkan atau mengatur urutan elemen di header keamanan untuk pengikatan ini.

Metode

BuildChannelFactory<TChannel>(BindingContext)	Membuat pabrik saluran berdasarkan SecurityBindingElement pengaturan dan konteks pengikatan yang diteruskan. Pabrik saluran yang dibuat adalah pabrik saluran keamanan pesan SOAP, yang secara internal memiliki referensi ke pabrik saluran yang sesuai dengan konteks pengikatan, (yang mencakup pabrik saluran transportasi).
BuildChannelFactoryCore<TChannel>(BindingContext)	Saat diimplementasikan, membuat pabrik saluran dari jenis tertentu.
BuildChannelListener<TChannel>(BindingContext)	Menginisialisasi pendengar saluran untuk menerima saluran dengan jenis tertentu dari konteks pengikatan. (Diperoleh dari BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Menentukan apakah pabrik saluran dari jenis yang ditentukan dapat dibangun.
CanBuildChannelListener<TChannel>(BindingContext)	Mengembalikan nilai yang menunjukkan apakah elemen pengikatan dapat membangun pendengar untuk jenis saluran tertentu. (Diperoleh dari BindingElement)
Clone()	Saat ditimpa di kelas turunan, mengembalikan salinan objek elemen pengikatan. (Diperoleh dari BindingElement)
CreateCertificateOverTransportBindingElement()	Membuat elemen pengikatan keamanan yang mengharapkan klien melakukan autentikasi berbasis sertifikat menggunakan keamanan pesan SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Membuat elemen pengikatan keamanan yang mengharapkan klien melakukan autentikasi berbasis sertifikat menggunakan keamanan pesan SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Membuat elemen pengikatan keamanan yang dikonfigurasi untuk mewajibkan autentikasi klien berbasis keamanan SOAP menggunakan token yang dikeluarkan. Elemen pengikatan ini memerlukan transportasi untuk memberikan autentikasi server dan perlindungan pesan (misalnya, HTTPS).
CreateSecureConversationBindingElement(SecurityBindingElement)	Membuat elemen pengikatan keamanan simetris yang dikonfigurasi untuk membuat percakapan aman antara klien dan layanan. Token konteks keamanan yang dikeluarkan di akhir jabat tangan percakapan aman digunakan untuk mengamankan pesan. Elemen pengikatan keamanan bootstrap menentukan bagaimana pesan jabat tangan percakapan aman diamankan.
CreateUserNameOverTransportBindingElement()	Membuat elemen pengikatan keamanan yang dikonfigurasi untuk autentikasi klien berdasarkan nama pengguna dan kata sandi yang dikirim sebagai bagian dari pesan SOAP. Elemen pengikatan memerlukan transportasi untuk memberikan autentikasi server dan perlindungan pesan (misalnya, HTTPS).
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetProperty<T>(BindingContext)	Mendapatkan objek tertentu menggunakan BindingContext.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan deskripsi kelas ini.

Lihat juga

• Mode Autentikasi SecurityBindingElement
• Cara: Membuat Pengikatan Kustom Menggunakan SecurityBindingElement