Bagikan melalui

Apa itu Adaptor WCF?

  • Artikel

Ada dua adaptor Windows Communication Foundation (WCF) —adaptor penerima dan adaptor kirim. Anda menggunakan adaptor penerima WCF untuk menerima permintaan layanan WCF. Adaptor penerima WCF menerima permintaan, membuat objek Pesan BizTalk, dan mempromosikan properti terkait ke konteks pesan. Anda menggunakan adaptor pengiriman WCF untuk memanggil layanan WCF. Adaptor pengiriman WCF memanggil layanan WCF melalui kontrak tanpa jenis.

Catatan

Adaptor WCF tidak mendukung penggunaan layanan Web bergaya Panggilan Prosedur Jarak Jauh (RPC) karena bagian pesan dalam layanan Web bergaya RPC mengacu pada jenis pesan daripada elemen pesan di mana adaptor WCF menggunakan elemen untuk bagian pesan. Kami menyarankan agar Anda menambahkan layanan Web bergaya RPC melalui wizard Tambahkan Referensi Web untuk menggunakan layanan Web dalam proyek BizTalk.

Dukungan Standar Layanan Web

Adaptor WCF menyediakan dukungan untuk standar WS-* seperti WS-Addressing, WS-Security, dan WS-AtomicTransaction. WS-ReliableMessaging tidak didukung dalam rilis adaptor WCF ini. Untuk daftar spesifikasi yang didukung oleh WCF, lihat https://go.microsoft.com/fwlink/?LinkId=88314.

WS-Addressing

Adaptor WCF mengandalkan dukungan standar WS-Addressing yang disediakan oleh WCF. Fitur berikut tersedia dalam adaptor WCF:

  • Konfigurasi alamat titik akhir port pengiriman yang diperoleh selama permintaan pertukaran metadata.

  • Konfigurasi header alamat untuk alamat titik akhir port kirim.

  • Konfigurasi header alamat untuk titik akhir yang diekspos di lokasi penerimaan BizTalk.

WS-Security

Adaptor WCF mengandalkan dukungan standar keamanan yang disediakan oleh WCF. Standar berikut didukung dalam adaptor WCF:

  • Keamanan Layanan Web: SOAP Message Security (WS-Security) 1.0 dan 1.1

  • Web Services Secure Conversation Language (WS-SecureConversation)

  • Bahasa Kepercayaan Layanan Web (WS-Trust)

  • Profil Token Sertifikat X.509 Keamanan Layanan Web

  • Profil Token Nama Pengguna Keamanan Layanan Web 1.0

  • Profil Token Kerberos Keamanan Layanan Web 1.0

Jenis Autentikasi Layanan

Jenis autentikasi layanan WCF berikut didukung:

  • Tidak ada

  • Windows

  • Sertifikat

Jenis Autentikasi Klien

Jenis autentikasi klien WCF berikut didukung:

  • Anonim

  • NamaPengguna

  • Windows

  • Sertifikat

Mode Keamanan

Mode keamanan berikut didukung:

  • Transportasi

  • Pesan

  • Campuran (keamanan tingkat transportasi dan autentikasi tingkat pesan)

WS-AtomicTransaction

Adaptor WCF-WsHttp, WCF-NetTcp, dan WCF-NetMsmq mendukung protokol WS-AtomicTransaction. Dukungan ini memungkinkan skenario berikut:

  • Pengiriman pesan transaksional ke database MessageBox.

  • Transmisi transaksi dari pesan dari MessageBox ke tujuan transaksi.

Catatan

Cakupan transaksi dibatasi oleh MessageBox. Misalnya, orkestrasi BizTalk tidak dapat berpartisipasi dalam transaksi klien. Demikian pula, titik akhir tujuan tidak dapat berpartisipasi dalam transaksi yang dimulai oleh orkestrasi BizTalk.

Pengiriman Transaksional

Untuk adaptor WCF-WsHttp dan WCF-NetTcp, pengiriman transaksional ke BizTalk Server diaktifkan dengan memilih kotak centang Aktifkan transaksi di kotak dialog terima properti transportasi lokasi. Untuk adaptor WCF-NetMsmq, kotak centang Transaksi dipilih secara default. Jika antrean pesan tempat Anda menarik pesan tidak ditandai sebagai transaksi, Anda perlu menghapus kotak centang ini; jika tidak, Anda akan menerima pesan kesalahan.

Jika fungsionalitas transaksi diaktifkan, pesan dikirimkan ke database MessageBox dengan menggunakan transaksi klien. Jika klien mencoba mengirimkan pesan di luar cakupan transaksi, adaptor akan mengembalikan pengecualian kembali ke klien. Namun, tidak ada pesan yang akan ditangguhkan. Jika fungsionalitas transaksi dinonaktifkan, pesan dikirimkan ke MessageBox tanpa menggunakan transaksi klien. Jika klien mencoba mengirimkan pesan di dalam cakupan transaksi, adaptor akan mengembalikan pengecualian kembali ke klien, dan tidak ada pesan yang akan ditangguhkan.

Transaksi dan Jenis Lokasi Penerimaan

Pengiriman transaksional hanya tersedia untuk lokasi penerimaan satu arah. Jika klien mencoba mengirimkan pesan dalam cakupan transaksi untuk lokasi penerimaan dua arah, pengecualian akan dikembalikan ke klien, dan tidak ada pesan yang akan ditangguhkan.

Transmisi Transaksi

Untuk adaptor WCF-WsHttp dan WCF-NetTcp, transmisi transaksional dari BizTalk Server diaktifkan dengan memilih kotak centang Aktifkan transaksi dalam kotak dialog kirim properti transportasi port. Untuk adaptor WCF-NetMsmq, kotak centang Transaksi dipilih secara default. Jika pesan mengantre yang Anda kirimi pesan tidak ditandai sebagai transaksi, Anda perlu menghapus kotak centang ini; jika tidak, Anda akan menerima pesan kesalahan.

Jika fungsionalitas transaksi diaktifkan, pesan dikirimkan dan dihapus dari database MessageBox di bawah transaksi. Jika layanan tujuan telah melakukan pekerjaan apa pun setelah menerima pesan, dan pesan tidak dihapus dari MessageBox, maka transaksi akan dibatalkan dan semua pekerjaan transaksi pada layanan akan digulung balik. Jika fungsionalitas transaksi dinonaktifkan, pesan dikirimkan dan dihapus dari MessageBox tanpa menggunakan transaksi.

Dukungan Sign-On Tunggal

Anda dapat meniru dan memperoleh tiket Enterprise Single Sign-On (SSO) untuk menggunakan SSO dengan adaptor WCF. Untuk informasi selengkapnya tentang cara menggunakan SSO dengan adaptor WCF, lihat Dukungan Sign-On Tunggal untuk Adaptor WCF.

Tabel berikut ini meringkas skenario yang tidak didukung saat menggunakan dukungan SSO dengan adaptor penerima WCF.

Mode keamanan Kredensial
Tidak ada Tidak ada
Transportasi Tidak ada
Pesan Tidak ada
TransportWithMessageCredentials Tidak ada
TransportCredentialOnly Tidak ada

Ekstensibilitas WCF

Anda dapat memperluas fungsionalitas WCF dengan mengembangkan ekstensi berikut dan menggunakannya dengan adaptor WCF-Custom dan WCF-CustomIsolated:

  • Pengikatan kustom

  • Elemen pengikatan kustom

Pengikatan Kustom

Pengikatan kustom dikembangkan dengan mengemas elemen pengikatan individual ke dalam kontainer yang mengekspos subset properti konfigurasi untuk skenario penggunaan tertentu. Anda perlu mendaftarkan ekstensi pengikatan dengan menginstal assembly ke dalam cache assembly global (GAC) lalu menambahkan elemen ekstensi ke file konfigurasi mesin. Untuk menggunakan pengikatan kustom, Anda perlu menyiapkan pengikatan pada setiap server di grup BizTalk. Setelah pengikatan diinstal, pengikatan akan terlihat oleh adaptor WCF-Custom dan WCF-CustomIsolated. Adaptor WCF-Custom dan WCF-CustomIsolated akan mendapatkan properti konfigurasi pengikatan dengan menggunakan pantulan pada elemen konfigurasi pengikatan.

Elemen Pengikatan Kustom

Elemen pengikatan kustom dikembangkan dengan menambahkan atau memodifikasi komponen saluran transportasi tertentu. Misalnya, komponen dekompresi kustom dikemas sebagai elemen pengikatan, atau transportasi UDP direpresentasikan sebagai elemen pengikatan. Elemen pengikatan ini dapat digunakan di dalam adaptor WCF. Anda dapat menentukan tumpukan saluran yang menggunakan elemen pengikatan kustom dalam kombinasi dengan elemen out-of-box atau pengikatan kustom lainnya. Anda perlu mendaftarkan ekstensi elemen pengikatan dengan menginstal rakitan ke GAC dan kemudian menambahkan elemen ekstensi ke file konfigurasi komputer. Untuk menggunakan pengikatan kustom, Anda perlu menyiapkan pengikatan pada setiap server di grup BizTalk. Untuk menggunakan elemen pengikatan kustom, Anda dapat memilih jenis pengikatan CustomBinding lalu menambahkan, memodifikasi, atau menyusun ulang elemen pengikatan dalam urutan yang diinginkan.

Di Bagian Ini

Lihat juga