AsymmetricSecurityBindingElement Kelas

Definisi

Ruang nama:: System.ServiceModel.Channels

Rakitan:: System.ServiceModel.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili elemen pengikatan kustom yang mendukung keamanan saluran menggunakan enkripsi asimetris. Elemen pengikatan ini menandatangani pesan menggunakan token autentikasi pengirim dan mengenkripsi pesan menggunakan token penerima.

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

Warisan: Object

BindingElement

SecurityBindingElement
AsymmetricSecurityBindingElement

Penerapan: IPolicyExportExtension

Contoh

Contoh berikut menunjukkan cara menggunakan kelas ini untuk membuat pengikatan kustom yang menyertakan kelas ini sebagai elemen pengikatan keamanan. Untuk informasi selengkapnya tentang kode dalam contoh ini, lihat Cara: Referensi Sertifikat X.509 secara konsisten.

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

Keterangan

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

Buat BindingElementCollection.
Buat elemen pengikatan kustom yang berada di atas elemen pengikatan ini di tumpukan pengikatan, seperti opsional TransactionFlowBindingElement dan ReliableSessionBindingElement.
Tambahkan elemen yang dibuat dalam urutan sebelumnya ke BindingElementCollection menggunakan InsertItem(Int32, BindingElement) metode .
Buat instans AsymmetricSecurityBindingElement dan tambahkan ke koleksi.
Tambahkan elemen pengikatan kustom tambahan ke koleksi, seperti TcpTransportBindingElement.

Sebelum menggunakan kelas ini, Anda harus menentukan apakah pengikatan standar memenuhi persyaratan keamanan Anda.

Nota

Setelah instans objek ini dibuat, Anda harus memperlakukan properti kelas SecurityBindingElement dasarnya sebagai tidak dapat diubah. Panggilan yang diatur pada beberapa properti mungkin memiliki efek yang tidak dapat diprediksi: pengikatan mungkin berperilaku seolah-olah properti mempertahankan nilai lamanya, dengan kegagalan run-time menjadi satu-satunya indikasi masalah. Dua properti yang diketahui berulah dengan cara ini adalah KeyType dan MessageSecurityVersion. Mungkin ada properti lain yang benar.

Konstruktor

Nama	Deskripsi
AsymmetricSecurityBindingElement()	Membuat instans kelas ini.
AsymmetricSecurityBindingElement(SecurityTokenParameters, SecurityTokenParameters)	Menginisialisasi instans AsymmetricSecurityBindingElement baru dengan parameter token penerima dan inisiator yang ditentukan.
AsymmetricSecurityBindingElement(SecurityTokenParameters)	Menginisialisasi instans AsymmetricSecurityBindingElement baru dengan parameter token penerima yang ditentukan.

Properti

Nama	Deskripsi
AllowInsecureTransport	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pesan aman mode campuran dapat dikirim melalui transportasi yang tidak aman seperti HTTP. (Diperoleh dari SecurityBindingElement)
AllowSerializedSigningTokenOnReply	Mendapatkan atau menetapkan nilai yang menunjukkan apakah membuat serial token penandatanganan pada pesan balasan diizinkan.
DefaultAlgorithmSuite	Mendapatkan atau mengatur enkripsi pesan dan algoritma pembungkus kunci. (Diperoleh dari SecurityBindingElement)
EnableUnsecuredResponse	Mendapatkan atau menetapkan nilai yang menunjukkan apakah WCF dapat mengirim dan menerima respons yang tidak aman terhadap permintaan aman. (Diperoleh dari SecurityBindingElement)
EndpointSupportingTokenParameters	Mendapatkan titik akhir yang mendukung parameter token. (Diperoleh dari SecurityBindingElement)
IncludeTimestamp	Mendapatkan atau menetapkan nilai yang menunjukkan apakah stempel waktu disertakan dalam setiap pesan. (Diperoleh dari SecurityBindingElement)
InitiatorTokenParameters	Menentukan definisi token untuk inisiator.
KeyEntropyMode	Mendapatkan atau mengatur sumber entropi yang digunakan untuk membuat kunci. (Diperoleh dari SecurityBindingElement)
LocalClientSettings	Mendapatkan properti pengikatan khusus untuk pengaturan keamanan lokal yang digunakan oleh klien. (Diperoleh dari SecurityBindingElement)
LocalServiceSettings	Mendapatkan properti pengikatan khusus untuk pengaturan keamanan lokal yang digunakan oleh layanan. (Diperoleh dari SecurityBindingElement)
MessageProtectionOrder	Mendapatkan atau mengatur urutan enkripsi pesan dan penandatanganan untuk pengikatan ini.
MessageSecurityVersion	Mendapatkan atau mengatur versi keamanan pesan. (Diperoleh dari SecurityBindingElement)
OperationSupportingTokenParameters	Mendapatkan kumpulan parameter token pendukung operasi. (Diperoleh dari SecurityBindingElement)
OptionalEndpointSupportingTokenParameters	Mendapatkan parameter token pendukung opsional untuk titik akhir layanan. (Diperoleh dari SecurityBindingElement)
OptionalOperationSupportingTokenParameters	Mendapatkan kumpulan parameter token pendukung operasi opsional. (Diperoleh dari SecurityBindingElement)
ProtectTokens	Mendapatkan atau mengatur apakah elemen pengikatan keamanan melindungi token. (Diperoleh dari SecurityBindingElement)
RecipientTokenParameters	Menentukan definisi token untuk penerima.
RequireSignatureConfirmation	Mendapatkan atau menetapkan nilai yang menunjukkan apakah tanda tangan pesan harus dikonfirmasi.
SecurityHeaderLayout	Mendapatkan atau mengatur urutan elemen di header keamanan untuk pengikatan ini. (Diperoleh dari SecurityBindingElement)

Metode

Nama	Deskripsi
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). (Diperoleh dari SecurityBindingElement)
BuildChannelFactoryCore<TChannel>(BindingContext)	Saat diimplementasikan, membuat pabrik saluran dari jenis tertentu. (Diperoleh dari SecurityBindingElement)
BuildChannelListener<TChannel>(BindingContext)	Membuat pendengar saluran berdasarkan SecurityBindingElement pengaturan dan konteks pengikatan yang diteruskan. (Diperoleh dari SecurityBindingElement)
BuildChannelListenerCore<TChannel>(BindingContext)	Saat diimplementasikan, membuat pendengar saluran dari jenis tertentu. (Diperoleh dari SecurityBindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Menentukan apakah pabrik saluran dari jenis yang ditentukan dapat dibangun. (Diperoleh dari SecurityBindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	Menentukan apakah pendengar saluran dari jenis yang ditentukan dapat dibangun. (Diperoleh dari SecurityBindingElement)
Clone()	Membuat instans baru dari kelas ini yang diinisialisasi dari yang saat ini.
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 dari BindingContext.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
SetKeyDerivation(Boolean)	Menetapkan nilai yang menunjukkan apakah kunci turunan diperlukan.
ToString()	Mengembalikan string yang mewakili instans ini AsymmetricSecurityBindingElement .

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	Mengekspor pernyataan kebijakan kustom tentang pengikatan, yang ditambahkan ke informasi Web Services Description Language (WSDL).

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?