SecurityBindingElement.CreateSecureConversationBindingElement Metode

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

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

Paket:

System.ServiceModel.Primitives v10.0.652802

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

Nama	Deskripsi
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)

Sumber:

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

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

Mengembalikan

SecurityBindingElement

Objek SecurityBindingElement.

Pengecualian

ArgumentNullException

bootstrapSecurity adalah null.

Keterangan

Elemen pengikatan dikonfigurasi untuk menggunakan token konteks keamanan berbasis sesi.

bootstrapSecurity digunakan untuk menunjukkan pengikatan dan kebijakan keamanan 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, dikembalikan SymmetricSecurityBindingElement , dengan RequireSignatureConfirmation diatur ke false.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Sumber:

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

Yang SecurityBindingElement berisi spesifikasi tentang bagaimana pesan jabat tangan percakapan 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

Objek SecurityBindingElement.

Pengecualian

ArgumentNullException

bootstrapSecurity adalah 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 dan kebijakan keamanan 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, dikembalikan SymmetricSecurityBindingElement , dengan RequireSignatureConfirmation diatur ke false.

Nota

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

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Sumber:

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

Yang SecurityBindingElement berisi spesifikasi tentang bagaimana pesan jabat tangan percakapan 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

Objek SecurityBindingElement.

Pengecualian

ArgumentNullException

bootstrapSecurity adalah null.

Keterangan

Parameter bootstrapProtectionRequirements memungkinkan penyesuaian cara pesan ditukar sebagai bagian dari jabat tangan percakapan aman diamankan.

bootstrapSecurity digunakan untuk menunjukkan pengikatan dan kebijakan keamanan 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, dikembalikan SymmetricSecurityBindingElement , dengan RequireSignatureConfirmation diatur ke false.

Nota

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