Bagikan melalui

Adaptor WCF-BasicHttp

  • Artikel

Microsoft BizTalk Server menggunakan adaptor WCF-BasicHttp untuk menerima dan mengirim permintaan layanan WCF melalui kelas BasicHttpBinding. Adaptor WCF-BasicHttp memungkinkan Anda menerbitkan orkestrasi dan skema sebagai layanan WCF dan menggunakan layanan WCF eksternal dengan BasicHttpBinding.

Anda dapat menggunakan adaptor WCF-BasicHttp untuk melakukan komunikasi lintas komputer dengan layanan Web dan klien berbasis ASMX warisan yang sesuai dengan Profil Dasar WS-I 1.1, menggunakan transportasi HTTP atau HTTPS dengan pengodean teks. Namun, Anda tidak akan dapat memanfaatkan fitur yang didukung oleh protokol WS-*.

Tabel berikut ini meringkas karakteristik adaptor WCF-BasicHttp:

Deskripsi Karakteristik
Tingkat interoperabilitas Profil Dasar
Pengodean pesan Teks atau MTOM
Perbatasan Lintas komputer
Protokol transportasi HTTP atau HTTPS
Mode keamanan None, Message, Transport, TransportWithMessageCredential, dan TransportCredentialOnly
Mekanisme autentikasi klien Keamanan Transportasi dan Keamanan Pesan
Dukungan untuk WS-ReliableMessaging Tidak
Dukungan untuk WS-AtomicTransaction Tidak
Dukungan untuk olahpesan satu arah Ya
Dukungan untuk olahpesan dua arah Ya
Jenis host untuk menerima adaptor Terpisah
Jenis host untuk adaptor pengiriman Dalam proses

Adaptor WCF-BasicHttp terdiri dari dua adaptor — adaptor penerima dan adaptor kirim.

Topik ini menunjukkan kepada Anda cara membuat lokasi terima dan mengirim port menggunakan BizTalk Administration. Anda juga dapat membuat lokasi terima dan mengirim port secara terprogram.

Sebelum Anda mulai

  • Dimulai dengan BizTalk Server 2016, adaptor pengiriman ini dapat menggunakan Access Control Service (ACS) atau Tanda Tangan Akses Bersama (SAS) untuk memahami bus layanan. Sebaiknya gunakan Tanda Tangan Akses Bersama (SAS) saat mengautentikasi dengan Azure Service Bus.

    Saat Anda membuat namespace Service Bus, namespace layanan Access Control (ACS) tidak dibuat secara otomatis. Jika Anda menggunakan ACS untuk mengautentikasi, maka Anda mungkin perlu membuat namespace LAYANAN ACS baru. Lihat adaptor SB-Messaging untuk informasi lebih rinci, termasuk langkah-langkah untuk mengambil nilai kunci ACS.

  • Adaptor WCF-BasicHttp lebih disukai daripada adaptor SOAP dalam skenario berikut:

    • Adaptor WCF laju dokumen per detik umumnya lebih baik daripada adaptor SOAP.
    • Adaptor SOAP memiliki kelemahan dari serialisasi dan deserialisasi pesan antara jenis .NET dan data XML mentah; yang dalam beberapa kasus dapat mengakibatkan modifikasi data yang tidak diinginkan. Adaptor WCF mengambil pendekatan untuk mempertahankan aliran data.
    • Adaptor WCF menerbitkan skema apa yang pada dasarnya sama seperti yang akan digunakan dalam runtime BizTalk. Sebaliknya, adaptor SOAP mengembalikan metadata yang dihasilkan dengan mencerminkan kelas .NET yang dihasilkan untuk mewakili skema. Karena .NET tidak mempertahankan semua nuansa skema XSD, WSDL yang diekspos mungkin tidak secara akurat mencerminkan skema yang digunakan oleh runtime BizTalk.
    • Lebih mudah untuk bermigrasi dari WCF-BasicHttp ke WCF-WSHttp, jika diperlukan.

  • Anda menggunakan WCF-BasicHttp menerima adaptor untuk menerima permintaan layanan WCF melalui protokol HTTP atau HTTPS. Anda menggunakan adaptor pengiriman WCF-BasicHttp untuk memanggil layanan WCF melalui kontrak tanpa jenis dengan menggunakan protokol HTTP atau HTTPS.

Membuat lokasi penerimaan

Lokasi penerimaan ini dapat dikonfigurasi sebagai satu arah atau respons permintaan (dua arah).

Catatan

Sebelum menyelesaikan langkah-langkah berikut, Anda harus sudah menambahkan port penerima. Lihat Cara Membuat Port Penerima.

Anda juga dapat membuat lokasi penerimaan secara terprogram.

  1. Di konsol BizTalk Administration, perluas BizTalk Server Administration, perluas BizTalk Group, perluas Aplikasi, lalu perluas aplikasi tempat Anda ingin membuat lokasi penerimaan.

  2. Di konsol Administrasi BizTalk, di panel kiri, klik simpul Terima Port . Kemudian di panel kanan, klik kanan port terima yang terkait dengan lokasi terima yang sudah ada atau yang ingin Anda kaitkan dengan lokasi penerimaan baru, lalu klik Properti.

  3. Dalam kotak dialog Terima Properti Port , di panel kiri, pilih Terima Lokasi, lalu di panel kanan, klik dua kali lokasi terima yang sudah ada atau klik Baru untuk membuat lokasi penerimaan baru.

  4. Dalam kotak dialog Terima Properti Lokasi , di bagian Transportasi di samping Tipe, pilih WCF-BasicHttp dari daftar turun bawah, lalu klik Konfigurasikan.

  5. Di Properti Transportasi WCF-BasicHttp, pada tab Umum , konfigurasikan alamat titik akhir dan identitas layanan untuk lokasi penerima WCF-BasicHttp:

    Catatan

    Jika Anda menggunakan Transport atau TransportWithMessageCredential untuk mode Keamanan, Anda harus menyiapkan Secure Sockets Layer (SSL) di Microsoft Internet Information Services (IIS).

    Gunakan ini Untuk melakukan ini
    Alamat (URI) Wajib diisi. Tentukan URI untuk lokasi penerima ini. Tentukan direktori virtual ditambah nama file .svc yang dihasilkan BizTalk WCF Service Publishing Wizard—misalnya, /path/service.svc.

    Nilai default: /

    Panjang minimum: 1

    Panjang maksimum: 255
    Identitas Titik Akhir Pilihan. Tentukan identitas layanan yang disediakan lokasi penerima ini dengan mengklik tombol Edit . Nilai yang dapat ditentukan untuk properti Identitas Titik Akhir berbeda sesuai dengan konfigurasi keamanan. Pengaturan ini memungkinkan klien untuk mengautentikasi lokasi penerimaan ini. Dalam proses jabat tangan antara klien dan layanan, infrastruktur Windows Communication Foundation (WCF) akan memastikan bahwa identitas layanan yang diharapkan cocok dengan nilai elemen ini.

    Defaultnya adalah string kosong.

    Panjang minimum: 0

    Panjang maksimum: 32767

  6. Dalam kotak dialog Properti Transportasi WCF-BasicHttp , pada tab Pengikatan , konfigurasikan properti waktu habis dan pengodean:

    Gunakan ini Untuk melakukan ini
    Batas waktu buka (hh:mmss) Tentukan nilai rentang waktu yang menunjukkan interval waktu yang disediakan agar operasi pembukaan saluran selesai. Nilai ini harus lebih besar dari atau sama dengan System.TimeSpan.Zero.

    Nilai default: 00:01:00

    Nilai maksimum: 23:59:59
    Kirim batas waktu (hh:mmss) Tentukan nilai rentang waktu yang menunjukkan interval waktu yang disediakan agar operasi pengiriman selesai. Nilai ini harus lebih besar dari atau sama dengan System.TimeSpan.Zero. Jika Anda menggunakan port penerima permintaan-respons, nilai ini menentukan rentang waktu untuk menyelesaikan seluruh interaksi, bahkan jika klien mengembalikan pesan besar.

    Nilai default: 00:01:00

    Nilai maksimum: 23:59:59
    Tutup batas waktu (hh:mmss) Tentukan nilai rentang waktu yang menunjukkan interval waktu yang disediakan agar operasi penutupan saluran selesai. Nilai ini harus lebih besar dari atau sama dengan System.TimeSpan.Zero.

    Nilai default: 00:01:00

    Nilai maksimum: 23:59:59
    Ukuran pesan maksimum yang diterima (byte) Tentukan ukuran maksimum, dalam byte, untuk pesan termasuk header, yang dapat diterima pada kawat. Ukuran pesan dibatasi oleh jumlah memori yang dialokasikan untuk setiap pesan. Anda dapat menggunakan properti ini untuk membatasi paparan serangan penolakan layanan (DoS).

    Adaptor WCF-BasicHttp memanfaatkan kelas BasicHttpBinding dalam mode transfer buffer untuk berkomunikasi dengan titik akhir. Untuk mode transportasi yang di-buffer, properti BasicHttpBinding.MaxBufferSize selalu sama dengan nilai properti ini.

    Nilai default: 65536

    Nilai maksimum: 2147483647
    Pengodean pesan Tentukan encoder yang digunakan untuk mengodekan pesan SOAP. Nilai yang valid mencakup hal-hal berikut:

    - Teks: Gunakan encoder pesan teks.
    - Mtom: Gunakan encoder Message Transmission Organization Mechanism 1.0 (MTOM).

    Defaultnya adalah Teks.
    Pengodean teks Tentukan pengodean set karakter yang akan digunakan untuk memancarkan pesan pada pengikatan saat properti Pengodean pesan diatur ke Teks. Nilai yang valid mencakup hal-hal berikut:

    - utf-16BE (unicodeFFFE): Pengodean Unicode BigEndian.
    - utf-16: Pengodean 16-bit.
    - utf-8: Pengodean 8-bit

    Defaultnya adalah utf-8.
    Panggilan bersamaan maksimum Tentukan jumlah panggilan bersamaan ke satu instans layanan. Panggilan yang melebihi batas akan dimasukkan ke antrean. Mengatur nilai ini ke 0 setara dengan mengaturnya ke Int32.MaxValue.

    Defaultnya adalah 200

  7. Dalam kotak dialog Properti Transportasi WCF-BasicHttp , pada tab Keamanan , tentukan kapabilitas keamanan:

    Gunakan ini Untuk melakukan ini
    Mode keamanan Tentukan jenis keamanan yang digunakan. Nilai yang valid mencakup hal-hal berikut:

    - Tidak ada: Pesan tidak diamankan selama transfer.
    - Transportasi: Keamanan disediakan menggunakan transportasi HTTPS. Pesan SOAP diamankan menggunakan HTTPS. Untuk menggunakan mode ini, Anda harus menyiapkan Secure Sockets Layer (SSL) di Microsoft Internet Information Services (IIS).
    - Pesan: Keamanan disediakan menggunakan keamanan pesan SOAP melalui transportasi HTTP. Secara default, Isi SOAP dienkripsi dan ditandatangani. Satu-satunya jenis kredensial klien Pesan yang valid untuk adaptor WCF-Basic adalah Sertifikat. Mode ini memerlukan transportasi HTTP. Saat menggunakan mode keamanan ini, sertifikat layanan untuk lokasi penerima ini perlu disediakan melalui sertifikat Layanan - properti Thumbprint .
    - TransportWithMessageCredential: Integritas, kerahasiaan, dan autentikasi layanan disediakan oleh transportasi HTTPS. Untuk menggunakan mode ini, Anda harus menyiapkan Secure Sockets Layer (SSL) di Microsoft Internet Information Services (IIS).
    - TransportCredentialOnly: Mode ini tidak memberikan integritas dan kerahasiaan pesan. Mode ini menyediakan autentikasi klien berbasis HTTP. Mode ini harus digunakan dengan hati-hati. Ini harus digunakan di lingkungan di mana keamanan transportasi disediakan dengan cara lain (seperti IPSec) dan hanya autentikasi klien yang disediakan oleh infrastruktur WCF. Jika Anda memilih Sertifikat untuk properti Jenis kredensial klien transportasi dalam mode keamanan ini, sertifikat layanan untuk lokasi penerimaan ini perlu disediakan melalui properti Sertifikat layanan - Thumbprint .

    Default Tidak Ada.
    Jenis kredensial klien transportasi Tentukan jenis kredensial yang akan digunakan saat melakukan autentikasi klien. Nilai yang valid mencakup hal-hal berikut:

    - Tidak ada: Tidak ada autentikasi yang terjadi pada tingkat transportasi.
    - Dasar: Autentikasi dasar. Dalam autentikasi Dasar, nama pengguna dan kata sandi dikirim dalam teks biasa melalui jaringan. Anda harus membuat domain atau akun pengguna lokal yang terkait dengan kredensial.
    - Hash: Autentikasi hash. Metode autentikasi ini beroperasi seperti Autentikasi dasar, kecuali bahwa kata sandi dikirim ke seluruh jaringan sebagai nilai hash untuk keamanan tambahan. Autentikasi hash hanya tersedia pada domain dengan pengendali domain yang menjalankan autentikasi sistem operasi Windows Server. Anda harus membuat domain atau akun pengguna lokal yang terkait dengan kredensial klien.
    - Ntlm: Autentikasi NTLM. Klien dapat mengirim kredensial tanpa mengirim kata sandi ke lokasi penerimaan ini. Anda harus membuat domain atau akun pengguna lokal yang terkait dengan kredensial klien.
    - Windows: Autentikasi terintegrasi Windows. Windows Communication Foundation menegosiasikan Kerberos atau NTLM, lebih memilih Kerberos jika ada domain. Jika Anda ingin menggunakan Kerberos, penting untuk meminta klien mengidentifikasi layanan dengan nama perwakilan layanan (SPN). Anda harus membuat domain atau akun pengguna lokal yang terkait dengan kredensial klien.
    - Sertifikat: Autentikasi klien menggunakan sertifikat klien. Rantai sertifikat CA untuk sertifikat X.509 klien harus diinstal di penyimpanan sertifikat Otoritas Sertifikasi Akar Tepercaya komputer ini sehingga klien dapat diautentikasi ke lokasi terima ini. Catatan: Properti Jenis kredensial klien Transportasi harus cocok dengan skema autentikasi direktori virtual IIS yang menghosting lokasi penerimaan ini. Misalnya, jika properti diatur ke Windows, Anda juga perlu mengaktifkan autentikasi Windows Terintegrasi untuk direktori virtual yang menghostingnya. Demikian pula jika properti diatur ke Tidak Ada, Anda harus mengizinkan akses anonim ke direktori virtual yang menghosting lokasi penerimaan ini.

    Default Tidak Ada.
    Jenis kredensial klien pesan Tentukan jenis kredensial yang akan digunakan saat melakukan autentikasi klien menggunakan keamanan berbasis pesan. Nilai yang valid mencakup hal-hal berikut:

    - UserName: Izinkan lokasi terima ini mengharuskan klien diautentikasi menggunakan kredensial UserName . Anda harus membuat domain atau akun pengguna lokal yang sesuai dengan kredensial klien.
    - Sertifikat: Klien diautentikasi ke lokasi penerima ini menggunakan sertifikat klien. Rantai sertifikat CA untuk sertifikat X.509 klien harus diinstal di penyimpanan sertifikat Otoritas Sertifikasi Akar Tepercaya komputer ini sehingga klien dapat diautentikasi ke lokasi terima ini.

    Defaultnya adalah UserName.
    Suite algoritma Tentukan enkripsi pesan dan algoritma pembungkus kunci. Algoritma ini dipetakan ke yang ditentukan dalam spesifikasi Bahasa Kebijakan Keamanan (WS-SecurityPolicy). Potensi nilai:

    - Basic128: Gunakan enkripsi Aes128, Sha1 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic128Rsa15: Gunakan Aes128 untuk enkripsi pesan, Sha1 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Basic128Sha256: Gunakan Aes256 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic128Sha256Rsa15: Gunakan Aes128 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Dasar192: Gunakan enkripsi Aes192, Sha1 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic192Rsa15: Gunakan Aes192 untuk enkripsi pesan, Sha1 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Basic192Sha256: Gunakan Aes192 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic192Sha256Rsa15: Gunakan Aes192 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Dasar256: Gunakan enkripsi Aes256, Sha1 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic256Rsa15: Gunakan Aes256 untuk enkripsi pesan, Sha1 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Basic256Sha256: Gunakan Aes256 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic256Sha256Rsa15: Gunakan Aes256 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - TripleDes: Gunakan enkripsi TripleDes, Sha1 untuk hash pesan, Rsa-oaep-mgf1p untuk pembungkus kunci.
    - TripleDesRsa15: Gunakan enkripsi TripleDes, Sha1 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - TripleDesSha256: Gunakan TripleDes untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - TripleDesSha256Rsa15: Gunakan TripleDes untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.

    Nilai defaultnya adalah Basic256.
    Sertifikat layanan -Thumbprint Tentukan thumbprint sertifikat X.509 untuk lokasi penerimaan ini yang digunakan klien untuk mengautentikasi layanan. Thumbprint dapat dipilih dengan menavigasi Toko Saya di lokasi Pengguna Saat Ini dengan tombol Telusuri . Catatan: Anda harus menginstal sertifikat layanan ke lokasi Pengguna Saat Ini dari akun pengguna untuk handler penerima yang menghosting lokasi terima ini.

    Panjang minimum: 0

    Panjang maksimum: 40

    Defaultnya adalah string kosong.
    Menggunakan Single Sign-On Gunakan Single Sign-On untuk mengambil kredensial klien untuk menerbitkan tiket SSO. Opsi ini hanya valid untuk konfigurasi keamanan yang tercantum di bagian berikut, "Enterprise Single Sign-On Supportability for the WCF-BasicHttp Receive Adapter."

    Nilai default dibersihkan.

    Dukungan Sign-On Tunggal Perusahaan untuk Adaptor Penerima WCF-BasicHttp Adaptor ini dapat mengeluarkan tiket SSO dari server SSO hanya dalam konfigurasi keamanan yang diperlihatkan dalam tabel berikut:

    Mode keamanan Jenis kredensial klien transportasi Jenis kredensial klien pesan
    Transportasi Dasar T/A
    Transportasi Mencerna T/A
    Transportasi Ntlm T/A
    Transportasi Windows T/A
    Transportasi Sertifikat T/A
    Pesan T/A UserName
    TransportWithMessageCredential T/A UserName
    TransportCredentialOnly Dasar T/A
    TransportCredentialOnly Mencerna T/A
    TransportCredentialOnly Ntlm T/A
    TransportCredentialOnly Windows T/A
    TransportCredentialOnly Sertifikat T/A

  8. Dalam kotak dialog Properti Transportasi WCF-BasicHttp , pada tab Pesan , tentukan pilihan data untuk elemen Isi SOAP:

    Gunakan ini Untuk melakukan ini
    Amplop -- seluruh <sabun:Amplop> Buat bagian isi pesan BizTalk dari seluruh Amplop SOAP dari pesan masuk.

    Nilai default dibersihkan.
    Isi -- isi <elemen soap:Body> Gunakan konten elemen ISI SOAP dari pesan masuk untuk membuat bagian isi pesan BizTalk. Jika elemen Body memiliki lebih dari satu elemen anak, hanya elemen pertama yang menjadi bagian isi pesan BizTalk.

    Ini adalah pengaturan default.
    Jalur -- konten yang terletak menurut jalur isi Gunakan ekspresi jalur isi dalam kotak teks Ekspresi jalur isi untuk membuat bagian isi pesan BizTalk. Ekspresi jalur isi dievaluasi terhadap elemen turunan langsung dari elemen ISI SOAP dari pesan masuk.

    Nilai default dibersihkan.
    Ekspresi jalur isi Ketik ekspresi jalur isi untuk mengidentifikasi bagian tertentu dari pesan masuk yang digunakan untuk membuat bagian isi pesan BizTalk. Ekspresi jalur isi ini dievaluasi terhadap elemen turunan langsung dari elemen Isi SOAP dari pesan masuk. Jika ekspresi jalur isi ini mengembalikan lebih dari satu simpul, hanya simpul pertama yang dipilih untuk bagian isi pesan BizTalk. Properti ini diperlukan jika opsi Jalur -- konten yang terletak menurut jalur isi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 32767

    Defaultnya adalah string kosong.
    Pengodean simpul Tentukan jenis pengodean yang digunakan adaptor penerima WCF-BasicHttp untuk mendekode simpul yang diidentifikasi oleh ekspresi jalur isi dalam kotak teks Ekspresi jalur isi .

    Properti ini diperlukan jika opsi Jalur -- konten yang terletak menurut jalur isi dipilih. Nilai yang valid mencakup hal-hal berikut:

    - Base64: Pengodean Base64.
    - Hex: Pengodean heksadesimal.
    - String: Pengodean teks - UTF-8
    - XML: Adaptor WCF membuat isi pesan BizTalk dengan XML luar simpul yang dipilih oleh ekspresi jalur isi dalam kotak teks Ekspresi jalur isi .

    Defaultnya adalah XML.
    Isi -- Isi pesan respons BizTalk Gunakan bagian isi pesan BizTalk untuk membuat konten elemen ISI SOAP dari pesan respons keluar. Properti ini hanya valid untuk lokasi penerima permintaan-respons.

    Ini adalah pengaturan default.
    Templat -- konten yang ditentukan oleh templat Gunakan templat yang disediakan dalam kotak teks XML untuk membuat konten elemen Isi SOAP untuk pesan keluar. Properti ini hanya valid untuk lokasi penerima permintaan-respons.

    Nilai default dibersihkan.
    XML Ketik templat berformat XML untuk konten elemen Isi SOAP dari pesan keluar. Properti ini diperlukan jika templat -- opsi isi pesan respons BizTalk dipilih. Properti ini hanya valid untuk lokasi penerimaan respons permintaan.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 32767

    Default adalah <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">.
    Menangguhkan pesan permintaan saat gagal Tentukan apakah akan menangguhkan pesan permintaan yang gagal diproses masuk karena kegagalan alur penerima atau kegagalan perutean.

    Nilai default dibersihkan.
    Sertakan detail pengecualian dalam kesalahan Tentukan apakah akan mengembalikan kesalahan SOAP ketika terjadi kesalahan untuk memudahkan penelusuran kesalahan.

    Nilai default dibersihkan.

Membuat port kirim

Catatan

Anda juga dapat membuat port kirim secara terprogram.

  1. Di konsol Administrasi BizTalk, buat port kirim baru atau klik dua kali port kirim yang ada untuk memodifikasinya. Untuk informasi selengkapnya, lihat Cara Membuat Port Kirim. Konfigurasikan semua opsi kirim port dan tentukan WCF-BasicHttp untuk opsi Tipe di bagian Transportasi pada tab Umum .

  2. Pada tab Umum , di bagian Transportasi , klik tombol Konfigurasi di samping Ketik.

  3. Dalam kotak dialog Properti Transportasi WCF-BasicHttp , pada tab Umum , konfigurasikan alamat titik akhir, identitas layanan, dan header HTTP SOAPAction untuk port pengiriman WCF-BasicHttp:

    Catatan

    Jika Anda menentukan skema https untuk properti Alamat (URI), Anda harus mengonfigurasi properti Mode keamanan ke Transport atau TransportWithMessageCredential. Anda dapat menggunakan tab Keamanan untuk mengonfigurasi properti Mode keamanan .

    Gunakan ini Untuk melakukan ini
    Alamat (URI) Wajib diisi. Tentukan URI yang sepenuhnya memenuhi syarat untuk port pengiriman ini. Gunakan https atau skema http tergantung pada konfigurasi keamanan.

    Panjang maksimum: 255

    Nilai default: http://localhost/
    Identitas Titik Akhir Pilihan. Tentukan identitas layanan yang diharapkan port pengiriman ini. Pengaturan ini memfungsikan port pengiriman ini untuk mengautentikasi layanan. Dalam proses jabat tangan antara klien dan layanan, infrastruktur Windows Communication Foundation (WCF) akan memastikan bahwa identitas layanan yang diharapkan cocok dengan nilai elemen ini. Nilai yang dapat ditentukan untuk properti Identitas berbeda sesuai dengan konfigurasi keamanan.

    Nilai default dibersihkan.
    Tindakan Tentukan bidang header HTTP SOAPAction untuk pesan keluar. Properti ini juga dapat diatur melalui properti konteks pesan WCF. Tindakan dalam alur atau orkestrasi.

    Anda dapat menentukan nilai ini dengan dua cara berbeda: format tindakan tunggal dan format pemetaan tindakan. Jika Anda mengatur properti ini dalam format tindakan tunggal, misalnya, http://contoso.com/Svc/Op1, header SOAPAction untuk pesan keluar selalu diatur ke nilai yang ditentukan dalam properti ini.

    Jika Anda mengatur properti ini dalam format pemetaan tindakan, header SOAPAction keluar ditentukan oleh BTS. Properti konteks operasi . Misalnya, jika properti ini diatur ke format XML berikut, dan BTS. Properti operasi diatur ke Op1, adaptor pengiriman WCF menggunakan http://contoso.com/Svc/Op1 untuk header SOAPAction keluar.

    <BtsActionMapping>
    <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />
    <Operation Name="Op2" Action="http://contoso.com/Svc/Op2"/>
    </BtsActionMapping>

    Jika pesan keluar berasal dari port orkestrasi, instans orkestrasi secara dinamis mengatur BTS. Properti operasi dengan nama operasi port. Jika pesan keluar dirutekan dengan perutean berbasis konten, Anda dapat mengatur BTS. Properti operasi dalam komponen alur.

    Panjang minimum: 0

    Panjang maksimum: 32767

    Defaultnya adalah string kosong.

  4. Di Properti Transportasi WCF-BasicHttp, pada tab Pengikatan , konfigurasikan properti waktu habis dan pengodean:

    Gunakan ini Untuk melakukan ini
    Batas waktu buka (hh:mmss) Tentukan nilai rentang waktu yang menunjukkan interval waktu yang disediakan agar operasi pembukaan saluran selesai. Nilai ini harus lebih besar dari atau sama dengan System.TimeSpan.Zero.

    Nilai default: 00:01:00

    Nilai maksimum: 23:59:59
    Kirim batas waktu (hh:mmss) Tentukan nilai rentang waktu yang menunjukkan interval waktu yang disediakan agar operasi pengiriman selesai. Nilai ini harus lebih besar dari atau sama dengan System.TimeSpan.Zero. Jika Anda menggunakan port pengiriman respons ajakan, nilai ini menentukan rentang waktu untuk menyelesaikan seluruh interaksi, bahkan jika layanan mengembalikan pesan besar.

    Nilai default: 00:01:00

    Nilai maksimum: 23:59:59
    Tutup batas waktu (hh:mmss) Tentukan nilai rentang waktu yang menunjukkan interval waktu yang disediakan agar operasi penutupan saluran selesai. Nilai ini harus lebih besar dari atau sama dengan System.TimeSpan.Zero.

    Nilai default: 00:01:00

    Nilai maksimum: 23:59:59
    Ukuran pesan maksimum yang diterima (byte) Tentukan ukuran maksimum, dalam byte, untuk pesan termasuk header, yang dapat diterima pada kawat. Ukuran pesan dibatasi oleh jumlah memori yang dialokasikan untuk setiap pesan. Anda dapat menggunakan properti ini untuk membatasi paparan serangan penolakan layanan (DoS).

    Adaptor WCF-BasicHttp memanfaatkan kelas BasicHttpBinding dalam mode transfer buffer untuk berkomunikasi dengan titik akhir. Untuk mode transportasi yang di-buffer, properti BasicHttpBinding.MaxBufferSize selalu sama dengan nilai properti ini.

    Nilai default: 65536

    Nilai maksimum: 2147483647
    Pengodean pesan Tentukan encoder yang digunakan untuk mengodekan pesan SOAP. Nilai yang valid mencakup hal-hal berikut:

    - Teks: Gunakan encoder pesan teks.
    - Mtom: Gunakan encoder Message Transmission Organization Mechanism 1.0 (MTOM).

    Nilai default: Teks
    Pengodean teks Tentukan pengodean set karakter yang akan digunakan untuk memancarkan pesan pada pengikatan saat properti Pengodean pesan diatur ke Teks. Nilai yang valid mencakup hal-hal berikut:

    - utf-16BE (unicodeFFFE): Pengodean Unicode BigEndian.
    - utf-16: pengodean 16-bit.
    - utf-8: Pengodean 8-bit

    Nilai default: utf-8

  5. Dalam kotak dialog Properti Transportasi WCF-BasicHttp , pada tab Keamanan , tentukan kapabilitas keamanan port pengiriman WCF-BasicHttp:

    Gunakan ini Untuk melakukan ini
    Mode keamanan Tentukan jenis keamanan yang digunakan. Nilai yang valid mencakup hal-hal berikut:

    - Tidak ada: Pesan tidak diamankan selama transfer.
    - Transportasi: Keamanan disediakan menggunakan transportasi HTTPS. Pesan SOAP diamankan menggunakan HTTPS. Rantai sertifikat CA untuk sertifikat X.509 layanan harus diinstal di penyimpanan sertifikat Otoritas Sertifikasi Akar Tepercaya komputer ini sehingga layanan dapat diautentikasi ke port kirim menggunakan sertifikat layanan.
    - Pesan: Keamanan disediakan menggunakan keamanan pesan SOAP. Secara default, elemen ISI SOAP dienkripsi dan ditandatangani. Satu-satunya jenis kredensial klien Pesan yang valid untuk adaptor pengiriman WCF-BasicHttp adalah Sertifikat. Mode ini memerlukan transportasi HTTP.
    - TransportWithMessageCredential: Integritas, kerahasiaan, dan autentikasi layanan disediakan oleh transportasi HTTPS. Rantai sertifikat CA untuk sertifikat X.509 layanan harus diinstal di penyimpanan sertifikat Otoritas Sertifikasi Akar Tepercaya di komputer ini sehingga layanan dapat diautentikasi ke port pengiriman menggunakan sertifikat layanan. Autentikasi port pengiriman disediakan oleh keamanan pesan SOAP.
    - TransportCredentialOnly: Mode ini tidak memberikan integritas dan kerahasiaan pesan. Mode ini menyediakan autentikasi klien berbasis HTTP. Mode ini harus digunakan dengan hati-hati. Ini harus digunakan di lingkungan di mana keamanan transportasi disediakan dengan cara lain (seperti IPSec) dan hanya autentikasi klien yang disediakan oleh infrastruktur WCF.

    Default Tidak Ada.
    Jenis kredensial klien transportasi Tentukan tipe kredensial yang akan digunakan saat melakukan autentikasi port pengiriman. Nilai yang valid mencakup hal-hal berikut:

    - Tidak ada: Tidak ada autentikasi yang terjadi pada tingkat transportasi.
    - Dasar: Autentikasi dasar. Dalam autentikasi Dasar, nama pengguna dan kata sandi dikirim dalam teks biasa melalui jaringan. Opsi ini memerlukan konfigurasi properti kredensial Klien .
    - Hash: Autentikasi hash. Metode autentikasi ini beroperasi seperti Autentikasi dasar, kecuali bahwa kata sandi dikirim ke seluruh jaringan sebagai nilai hash untuk keamanan tambahan. Autentikasi hash hanya tersedia pada domain dengan pengendali domain yang menjalankan autentikasi sistem operasi Windows Server. Opsi ini memerlukan konfigurasi properti kredensial Klien .
    - Ntlm: Autentikasi NTLM. Akun pengguna tempat port pengiriman ini dijalankan digunakan untuk layanan untuk mengautentikasi port pengiriman ini.
    - Windows: Autentikasi terintegrasi Windows. Akun pengguna tempat port pengiriman ini dijalankan digunakan untuk layanan untuk mengautentikasi port pengiriman ini.
    - Sertifikat: Autentikasi klien menggunakan sertifikat klien yang ditentukan melalui properti Sertifikat klien - Thumbprint . Saat menggunakan jenis kredensial ini, sertifikat layanan perlu disediakan melalui sertifikat Layanan - properti Thumbprint .

    Default Tidak Ada.
    Jenis kredensial klien pesan Tentukan jenis kredensial yang akan digunakan saat melakukan autentikasi klien menggunakan keamanan berbasis pesan. Nilai yang valid mencakup hal-hal berikut:

    - UserName: Port pengiriman ini diautentikasi ke layanan dengan kredensial UserName . Untuk adaptor pengiriman WCF-BasicHttp, ini tidak didukung.
    - Sertifikat: Port pengiriman ini diautentikasi ke layanan menggunakan sertifikat klien yang ditentukan melalui properti Sertifikat klien - Thumbprint . Selain itu, saat menggunakan jenis kredensial ini, sertifikat layanan perlu disediakan melalui properti Sertifikat layanan - Thumbprint .

    Defaultnya adalah UserName.
    Suite algoritma Tentukan enkripsi pesan dan algoritma pembungkus kunci. Algoritma ini dipetakan ke yang ditentukan dalam spesifikasi Bahasa Kebijakan Keamanan (WS-SecurityPolicy). Potensi nilai:

    - Basic128: Gunakan enkripsi Aes128, Sha1 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic128Rsa15: Gunakan Aes128 untuk enkripsi pesan, Sha1 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Basic128Sha256: Gunakan Aes256 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic128Sha256Rsa15: Gunakan Aes128 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Dasar192: Gunakan enkripsi Aes192, Sha1 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic192Rsa15: Gunakan Aes192 untuk enkripsi pesan, Sha1 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Basic192Sha256: Gunakan Aes192 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic192Sha256Rsa15: Gunakan Aes192 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Dasar256: Gunakan enkripsi Aes256, Sha1 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic256Rsa15: Gunakan Aes256 untuk enkripsi pesan, Sha1 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - Basic256Sha256: Gunakan Aes256 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - Basic256Sha256Rsa15: Gunakan Aes256 untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - TripleDes: Gunakan enkripsi TripleDes, Sha1 untuk hash pesan, Rsa-oaep-mgf1p untuk pembungkus kunci.
    - TripleDesRsa15: Gunakan enkripsi TripleDes, Sha1 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.
    - TripleDesSha256: Gunakan TripleDes untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa-oaep-mgf1p untuk pembungkus kunci.
    - TripleDesSha256Rsa15: Gunakan TripleDes untuk enkripsi pesan, Sha256 untuk hash pesan, dan Rsa15 untuk pembungkus kunci.

    Nilai defaultnya adalah Basic256.
    Sertifikat klien - Thumbprint Tentukan thumbprint sertifikat X.509 untuk mengautentikasi port pengiriman ini ke layanan. Anda dapat memilih thumbprint dengan menavigasi ke Penyimpanan saya di lokasi Pengguna Saat Ini dengan tombol Telusuri . Catatan: Anda harus menginstal sertifikat klien ke lokasi Pengguna Saat Ini dari akun pengguna untuk pengirim yang menghosting port pengiriman ini.

    Panjang minimum: 0

    Panjang maksimum: 40

    Defaultnya adalah string kosong.
    Sertifikat layanan - Thumbprint Tentukan thumbprint sertifikat X.509 untuk mengautentikasi layanan tempat port pengiriman ini mengirim pesan. Anda dapat memilih thumbprint yang menavigasi ke penyimpanan Orang Lainnya di lokasi Komputer Lokal dengan tombol Telusuri.

    Panjang minimum: 0

    Panjang maksimum: 40

    Defaultnya adalah string kosong.
    Kredensial nama pengguna Tentukan kredensial untuk mengirim pesan. Anda dapat menentukan properti dengan mengklik tombol Edit . Opsi ini hanya valid untuk konfigurasi keamanan yang tercantum di bagian berikut, "Enterprise Single Sign-On Supportability for the WCF-BasicHttp Send Adapter."

    Nilai defaultnya adalah Jangan gunakan Akses Menyeluruh.
    Informasi koneksi Azure Service Bus Baru dimulai dengan BizTalk Server 2016.

    Pilih untuk menggunakan Tanda Tangan Akses Bersama (SAS) atau layanan Access Control (ACS) dari namespace Bus Layanan.

    Pilih opsi, lalu pilih Edit untuk memasukkan informasi utama:

    - Tanda Tangan Akses Bersama : Masukkan nama kunci akses, dan kunci akses. Kedua nilai tercantum dalam portal Azure.
    - layanan Access Control : Masukkan STS URI (https://<yourNamespace>-sb.accesscontrol.windows.net/), Nama pengeluar sertifikat, dan kunci Penerbit. Gunakan Windows PowerShell untuk mengambil nilai-nilai ini, seperti yang dijelaskan dalam adaptor SB-Messaging.

    Dukungan Sign-On Tunggal Perusahaan untuk Adaptor Kirim WCF-BasicHttp Adaptor pengiriman WCF-BasicHttp dapat menukarkan tiket SSO dari server SSO untuk mendapatkan kredensial pengguna hanya dalam konfigurasi keamanan yang ditunjukkan dalam tabel berikut.

    Mode keamanan Jenis kredensial klien transportasi Jenis kredensial klien pesan
    Transportasi Dasar T/A
    Transportasi Mencerna T/A
    TransportCredentialOnly Dasar T/A
    TransportCredentialOnly Mencerna T/A
    Pesan T/A UserName
    TransportWithMessageCredential T/A UserName

  6. Dalam kotak dialog Properti Transportasi WCF-BasicHttp , pada tab Proksi , konfigurasikan pengaturan proksi untuk port pengiriman WCF-BasicHttp:

    Gunakan ini Untuk melakukan ini
    Gunakan pengaturan proksi default Handler Tentukan apakah port pengiriman ini menggunakan pengaturan proksi di penghandel pengirim yang menghosting port pengiriman ini.

    Ini adalah pengaturan default.
    Jangan gunakan proksi Menunjukkan apakah port pengiriman ini menggunakan server proksi.

    Nilai default dibersihkan.
    Gunakan proksi Tunjukkan apakah port pengiriman ini menggunakan server proksi yang ditentukan dalam properti Alamat .

    Nilai default dibersihkan.
    Alamat Tentukan alamat server proksi. Gunakan https atau skema http tergantung pada konfigurasi keamanan. Alamat ini dapat diikuti oleh titik dua dan nomor port. Contohnya,http://127.0.0.1:8080.

    Properti ini memerlukan nilai hanya jika Gunakan proksi dipilih.

    Jenis: String

    Panjang maksimum: 256

    Defaultnya adalah string kosong.
    Nama pengguna Tentukan nama pengguna yang akan digunakan untuk autentikasi. Jika autentikasi terintegrasi digunakan, nama pengguna menyertakan domain, yaitu domain\nama pengguna. Jika autentikasi Dasar atau Hash digunakan, nama pengguna tidak menyertakan domain\. Properti ini memerlukan nilai hanya jika Gunakan proksi dipilih. Catatan: Adaptor pengiriman WCF-BasicHttp menggunakan autentikasi dasar untuk proksi.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256

    Defaultnya adalah string kosong.
    Kata sandi Tentukan kata sandi yang akan digunakan untuk autentikasi.

    Properti ini memerlukan nilai hanya jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256

    Defaultnya adalah string kosong.

  7. Dalam kotak dialog Properti Transportasi WCF-BasicHttp , pada tab Pesan , tentukan pilihan data untuk elemen Isi SOAP.

    Gunakan ini Untuk melakukan ini
    Isi -- Isi pesan permintaan BizTalk Gunakan bagian isi pesan BizTalk untuk membuat konten elemen ISI SOAP untuk pesan keluar.

    Ini adalah pengaturan default.
    Templat -- konten yang ditentukan oleh templat Gunakan templat yang disediakan dalam kotak teks XML untuk membuat konten elemen Isi SOAP untuk pesan keluar.

    Nilai default dibersihkan.
    XML Ketik templat berformat XML untuk konten elemen Isi SOAP dari pesan keluar. Properti ini diperlukan jika templat -- opsi isi pesan respons BizTalk dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 32767

    Default adalah <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>.
    Amplop -- seluruh <sabun:Amplop> Buat bagian isi pesan BizTalk dari seluruh Amplop SOAP dari pesan masuk. Properti ini hanya valid untuk port solicit-response.

    Nilai default dibersihkan.
    Isi -- isi <elemen soap:Body> Gunakan konten elemen ISI SOAP dari pesan masuk untuk membuat bagian isi pesan BizTalk. Jika elemen Body memiliki lebih dari satu elemen anak, hanya elemen pertama yang menjadi bagian isi pesan BizTalk. Properti ini hanya valid untuk port solicit-response.

    Ini adalah pengaturan default.
    Jalur -- konten yang terletak menurut jalur isi Gunakan ekspresi jalur isi dalam kotak teks Ekspresi jalur isi untuk membuat bagian isi pesan BizTalk. Ekspresi jalur isi dievaluasi terhadap elemen turunan langsung dari elemen ISI SOAP dari pesan masuk. Properti ini hanya valid untuk port solicit-response.

    Nilai default dibersihkan.
    Ekspresi jalur isi Ketik ekspresi jalur isi untuk mengidentifikasi bagian tertentu dari pesan masuk yang digunakan untuk membuat bagian isi pesan BizTalk. Ekspresi jalur isi ini dievaluasi terhadap elemen turunan langsung dari simpul Isi SOAP dari pesan masuk. Jika ekspresi jalur isi ini mengembalikan lebih dari satu simpul, hanya simpul pertama yang dipilih untuk bagian isi pesan BizTalk. Properti ini diperlukan jika opsi Jalur -- konten yang terletak menurut jalur isi dipilih. Properti ini hanya valid untuk port solicit-response.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 32767

    Defaultnya adalah string kosong.
    Pengodean simpul Tentukan jenis pengodean yang digunakan adaptor pengiriman WCF-BasicHttp untuk mendekode untuk simpul yang diidentifikasi oleh ekspresi jalur isi dalam kotak teks Ekspresi jalur isi . Properti ini diperlukan jika opsi Jalur -- konten yang terletak menurut jalur isi dipilih. Properti ini hanya valid untuk port solicit-response. Nilai yang valid mencakup hal-hal berikut:

    - Base64: Pengodean Base64.
    - Hex: Pengodean heksadesimal.
    - String: Pengodean teks - UTF-8
    - XML: Adaptor WCF membuat isi pesan BizTalk dengan XML luar simpul yang dipilih oleh ekspresi jalur isi dalam kotak teks Ekspresi jalur isi .

    Defaultnya adalah XML.
    Menyebarkan pesan kesalahan Pilih kotak centang ini untuk merutekan pesan yang gagal diproses keluar ke aplikasi berlangganan (seperti port penerima lain atau jadwal orkestrasi). Kosongkan kotak centang untuk menangguhkan pesan yang gagal dan menghasilkan pengakuan negatif (NACK). Properti ini hanya valid untuk port solicit-response.

    Nilai default dipilih.

Menambahkan proksi ke handler pengiriman

Anda dapat menambahkan proksi ke port kirim, atau pengirim handler. Jika Anda menambahkan proksi di port kirim, lewati bagian ini.

  1. Di Konsol Administrasi BizTalk Server, perluas Administrasi BizTalk Server, perluas Grup BizTalk, perluas Pengaturan Platform, lalu perluas Adaptor.

  2. Pilih WCF-BasicHttp, lalu pilih dua kali handler pengirim.

  3. Di Properti Handler Adapter, pada tab Umum , pilih Properti.

  4. Di tab Proksi , lakukan hal berikut ini.

    Gunakan ini Untuk melakukan ini
    Menggunakan proksi Menunjukkan apakah handler pengiriman ini menggunakan server proksi.

    Nilai default dibersihkan.
    Alamat Tentukan alamat server proksi. Gunakan https atau skema http tergantung pada konfigurasi keamanan. Alamat ini dapat diikuti oleh titik dua dan nomor port. Contohnya,http://127.0.0.1:8080.

    Properti ini memerlukan nilai hanya jika Gunakan proksi dipilih.

    Jenis: String

    Panjang maksimum: 256

    Defaultnya adalah string kosong.
    Nama pengguna Tentukan nama pengguna yang akan digunakan untuk autentikasi. Jika autentikasi terintegrasi atau Dasar digunakan, nama pengguna menyertakan domain, yaitu domain\nama pengguna. Jika autentikasi Digest digunakan, nama pengguna tidak menyertakan domain\.

    Properti ini memerlukan nilai hanya jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256

    Defaultnya adalah string kosong.
    Kata sandi Tentukan kata sandi yang akan digunakan untuk autentikasi.

    Properti ini memerlukan nilai hanya jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256

    Defaultnya adalah string kosong.

  5. Klik OK hingga Anda keluar dari semua kotak dialog.

    Lihat juga

Apa itu Adaptor WCF?

Adaptor SB-Messaging

Menggunakan Adapter