SecurityBindingElement.CreateSecureConversationBindingElement Metode

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

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.

Overload

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.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	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.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	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.

CreateSecureConversationBindingElement(SecurityBindingElement)

Source:

SecurityBindingElement.cs

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement) As SecurityBindingElement

Parameter

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement yang berisi spesifikasi tentang bagaimana pesan jabat tangan percakapan yang aman diamankan.

Mengembalikan

SecurityBindingElement

Objek SecurityBindingElement.

Pengecualian

ArgumentNullException

bootstrapSecurityadalah null.

Keterangan

Elemen pengikatan dikonfigurasi untuk menggunakan token konteks keamanan berbasis sesi.

bootstrapSecurity digunakan untuk menunjukkan pengikatan keamanan dan kebijakan yang digunakan untuk meminta token percakapan yang aman dari layanan.

Jika bootstrapSecurity adalah TransportSecurityBindingElement, elemen pengikatan yang dikembalikan oleh metode ini juga satu, dan IncludeTimestamp diatur ke true; dan LocalClientSecuritySettings objek yang dikembalikan dari LocalClientSettings memiliki properti yang DetectReplays diatur ke false; dan LocalServiceSecuritySettings objek yang dikembalikan dari LocalServiceSettings memiliki properti yang DetectReplays diatur ke false.

Jika tidak, SymmetricSecurityBindingElement dikembalikan, dengan RequireSignatureConfirmation diatur ke false.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Source:

SecurityBindingElement.cs

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean) As SecurityBindingElement

Parameter

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement yang berisi spesifikasi tentang bagaimana pesan jabat tangan percakapan yang aman diamankan.

requireCancellation

Boolean

true jika pembatalan diperlukan; jika tidak, false. Mengatur parameter ini untuk false mengaktifkan token konteks keamanan yang berguna dalam skenario farm Web, karena dalam mode ini status sesi dikodekan di dalam token konteks keamanan yang ditetapkan alih-alih disimpan dalam memori server.

Mengembalikan

SecurityBindingElement

Objek SecurityBindingElement.

Pengecualian

ArgumentNullException

bootstrapSecurityadalah null.

Contoh

Kode berikut menunjukkan cara memanggil metode ini.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

// Use a secure session.
security = SecurityBindingElement.CreateSecureConversationBindingElement(security, true);

Keterangan

Jika requireCancellation adalah false, token konteks keamanan berbasis cookie dikeluarkan; jika tidak, token konteks keamanan berbasis sesi dikeluarkan.

bootstrapSecurity digunakan untuk menunjukkan pengikatan keamanan dan kebijakan yang SecureConversationToken digunakan untuk meminta dari layanan.

Jika bootstrapSecurity adalah TransportSecurityBindingElement, elemen pengikatan yang dikembalikan oleh metode ini juga merupakan TransportSecurityBindingElement, dan IncludeTimestamp diatur ke true; dan LocalClientSecuritySettings objek yang dikembalikan dari LocalClientSettings memiliki properti yang DetectReplays diatur ke false; dan LocalServiceSecuritySettings objek yang dikembalikan dari LocalServiceSettings memiliki properti yang DetectReplays diatur ke false.

Jika tidak, SymmetricSecurityBindingElement dikembalikan, dengan RequireSignatureConfirmation diatur ke false.

Catatan

Ketika peniruan nama diperlukan pada Windows XP, gunakan sesi aman tanpa token konteks keamanan. Ketika token konteks keamanan digunakan dengan peniruan InvalidOperationException , token akan dilemparkan. Untuk mengetahui informasi selengkapnya, lihat Skenario yang Tidak Didukung. Untuk informasi selengkapnya tentang sesi aman, lihat Sesi Aman.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Source:

SecurityBindingElement.cs

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation, System::ServiceModel::Security::ChannelProtectionRequirements ^ bootstrapProtectionRequirements);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation, System.ServiceModel.Security.ChannelProtectionRequirements bootstrapProtectionRequirements);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool * System.ServiceModel.Security.ChannelProtectionRequirements -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean, bootstrapProtectionRequirements As ChannelProtectionRequirements) As SecurityBindingElement

Parameter

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement yang berisi spesifikasi tentang bagaimana pesan jabat tangan percakapan yang aman diamankan.

requireCancellation

Boolean

true jika pembatalan diperlukan; jika tidak, false. Mengatur parameter ini untuk false mengaktifkan token konteks keamanan yang berguna dalam skenario farm Web, karena dalam mode ini status sesi dikodekan di dalam token konteks keamanan yang ditetapkan alih-alih disimpan dalam memori server.

bootstrapProtectionRequirements

ChannelProtectionRequirements

Objek ChannelProtectionRequirements yang menentukan persyaratan untuk perlindungan saluran.

Mengembalikan

SecurityBindingElement

Objek SecurityBindingElement.

Pengecualian

ArgumentNullException

bootstrapSecurityadalah null.

Keterangan

Parameter bootstrapProtectionRequirements memungkinkan penyesuaian tentang bagaimana pesan yang ditukar sebagai bagian dari jabat tangan percakapan aman diamankan.

bootstrapSecurity digunakan untuk menunjukkan pengikatan keamanan dan kebijakan yang digunakan untuk meminta token percakapan yang aman dari layanan.

Jika bootstrapSecurity adalah TransportSecurityBindingElement, elemen pengikatan yang dikembalikan oleh metode ini juga merupakan TransportSecurityBindingElement, dan IncludeTimestamp diatur ke true; dan LocalClientSecuritySettings objek yang dikembalikan dari LocalClientSettings memiliki properti yang DetectReplays diatur ke false; dan LocalServiceSecuritySettings objek yang dikembalikan dari LocalServiceSettings memiliki properti yang DetectReplays diatur ke false.

Jika tidak, SymmetricSecurityBindingElement dikembalikan, dengan RequireSignatureConfirmation diatur ke false.

Catatan

Ketika peniruan nama diperlukan pada Windows XP, gunakan sesi aman tanpa token konteks keamanan. Ketika token konteks keamanan digunakan dengan peniruan InvalidOperationException , token akan dilemparkan. Untuk mengetahui informasi selengkapnya, lihat Skenario yang Tidak Didukung. Untuk informasi selengkapnya tentang sesi aman, lihat Sesi Aman.