Adaptor Penerima HTTP

2023-05-04

Lokasi terima untuk adaptor penerima HTTP adalah URL berbeda yang dikonfigurasi melalui konsol Administrasi BizTalk Server.

Anda dapat mengonfigurasi adaptor penerima HTTP untuk pengiriman asinkron atau pengiriman sinkron dari klien. Pengiriman asinkron adalah pengiriman satu arah dan pengiriman sinkron adalah dua cara atau pengiriman respons permintaan.

Anda menggunakan keamanan IIS untuk autentikasi dan otorisasi permintaan masuk.

Permintaan HTTP GET dan HTTP POST

Adaptor penerima HTTP dapat menerima pesan dengan dua cara berbeda—dengan permintaan HTTP POST atau permintaan HTTP GET.

Ketika adaptor penerima HTTP mendapatkan pesan pada permintaan HTTP POST, urutan peristiwa berikut terjadi:

URL yang dikonfigurasi di BizTalk Server menerima pesan baru di lokasi terima.
Adaptor penerima membuat objek Pesan BizTalk sehingga pesan dapat dikirimkan ke server.
Adaptor penerima membuat objek Pesan BizTalk hanya dengan satu bagian—bagian isi.
Setelah pesan dibaca dan berhasil dikirim ke server, adaptor penerima HTTP mengirim kode HTTP 202 kembali ke klien yang menunjukkan bahwa permintaan diterima.

Secara opsional, adaptor penerima HTTP dapat mengirim token korelasi pesan pada respons HTTP. Token korelasi ini mewakili pesan dalam BizTalk Server. Jika lokasi penerima HTTP berada di port respons permintaan, adaptor mengembalikan kode keberhasilan 200 bersama dengan pesan respons.

Ketika adaptor penerima HTTP memproses pesan dari permintaan HTTP GET, adaptor penerima membuat objek Pesan BizTalk dan menempatkan string kueri yang didekodekan dari permintaan HTTP GET ke bagian isi pesan BizTalk. Adaptor HTTP memilih string kueri yang ditempatkan ke dalam bagian isi pesan BizTalk menggunakan algoritma berikut:

Jika adaptor penerima HTTP menerima permintaan HTTP GET, adaptor tersebut membagi string URI masuk menjadi dua bagian, menggunakan simbol tanda tanya (?) sebagai pemisah.
Bagian pertama dari string URI, bagian sebelum pemisah tanda tanya, disalin ke properti InboundTransportLocation pada konteks pesan. Properti InboundTransportLocation secara unik mengidentifikasi lokasi tempat BizTalk Server menerima pesan. Mesin menggunakan properti ini untuk menentukan lokasi penerima mana yang akan dijalankan untuk pesan.
Adaptor HTTP mengambil sisa string URI, bagian setelah pemisah tanda tanya, dan mendekode dan menyalinnya ke bagian isi pesan BizTalk.
Jika operasi HTTP GET atau HTTP POST kosong diterima oleh adaptor penerima HTTP, operasi tersebut akan ditolak.

PEMROSESAN Adaptor Penerima HTTP dari Permintaan GET

Berikut ini adalah contoh bagaimana HTTP menerima pesan proses adaptor yang diterima oleh permintaan HTTP GET. Contoh-contoh ini mengasumsikan bahwa adaptor penerima HTTP dikonfigurasi dengan dua lokasi penerima berikut:

/vroot/BTSHTTPReceive.dll  
/vroot/BTSHTTPReceive.dll?LocationID=1

Mengingat permintaan HTTP GET berikut untuk klien:
```
http://servername/vroot/BTSHTTPReceive.dll?LocationID=1  
```
Tindakan yang diambil oleh adaptor penerima HTTP adalah sebagai berikut:

Atur properti InboundTransportLocation pada konteks pesan yang sama dengan /vroot/BTSHTTPReceive.dll, dan bagian isi objek Pesan BizTalk sama dengan LocationID=1.
Mengingat permintaan HTTP GET berikut untuk klien:
```
http://servername/vroot/BTSHTTPReceive.dll?LocationID=1&MyParam=My%20Value  
```
Tindakan yang diambil oleh adaptor penerima HTTP adalah sebagai berikut:

Atur properti InboundTransportLocation sama dengan /vroot/BTSHTTPReceive.dll, dan bagian isi objek Pesan BizTalk sama dengan LocationID=1&MyParam=Nilai Saya.
Mengingat permintaan HTTP GET berikut untuk klien:
```
http://servername/vroot/BTSHTTPReceive.dll  
```
Tindakan yang diambil oleh adaptor penerima HTTP adalah+ sebagai berikut:

Tolak permintaan karena pemformatan permintaan HTTP GET yang salah.

Dukungan Batching untuk Adaptor Penerima HTTP

Adaptor penerima HTTP mengirimkan pesan ke server dalam batch. Ukuran batch yang digunakan untuk mengirimkan pesan ke server dapat dikonfigurasi pada handler penerima adaptor HTTP.

DUKUNGAN Adapter Penerima HTTP untuk Menangguhkan Permintaan yang Gagal

Adaptor penerima HTTP BizTalk Server memiliki pengaturan konfigurasi, Menangguhkan Permintaan Gagal, untuk mengontrol apa yang terjadi dengan permintaan HTTP jika gagal memproses masuk karena kegagalan alur penerimaan, kegagalan pemetaan, atau kegagalan perutean. Pengaturan memiliki dua nilai yang mungkin:

Salah. Ini adalah pengaturan default. Adaptor penerima HTTP membuang pesan yang gagal diproses masuk karena kegagalan alur penerima, kegagalan pemetaan, atau kegagalan perutean. Selain itu, kode status kesalahan 401 atau 500 dikirim ke klien.
Benar. Adaptor penerima HTTP menangguhkan pesan yang gagal diproses masuk karena kegagalan alur penerimaan, kegagalan pemetaan, atau kegagalan perutean. Untuk port penerima satu arah, kode status yang Diterima 202 dikirim ke klien. Untuk port penerima dua arah, kode status Kesalahan 500 dikirim ke klien.

Dukungan Pengodean Terpotong untuk Adaptor Penerima HTTP

Adaptor penerima HTTP menerima permintaan HTTP dengan pesan isi terkodekan yang dipotong. Adaptor penerima menggunakan pengodean yang dipotong untuk mengirim pesan respons ketika ukuran isi lebih besar dari 4 KB. Pengodean yang dipotong dapat dinonaktifkan dengan mengatur entri registri DWORD yang dijelaskan dalam Konfigurasi Adapter HTTP dan Parameter Penyetelan

Sertifikat Klien untuk Adaptor Penerima HTTP

Setiap kali koneksi aman dengan sertifikat klien digunakan untuk lokasi terima HTTP, adaptor penerima HTTP mendapatkan thumbprint sertifikat klien dari Microsoft Internet Information Services (IIS) dan menambahkannya ke konteks pesan semua pesan yang diterima melalui HTTPS di lokasi tersebut. Adaptor penerima HTTP mengatur properti sistem berikut:

SourcePartyEvidenceQualifier = "Certificate"  
SourcePartyEvidence = <certificate thumbprint>

Kode Status yang Dikembalikan oleh Adaptor Penerima HTTP

Daftar berikut berisi kode status yang dikembalikan oleh adaptor penerima HTTP.

200 OK. Adaptor berhasil memproses pesan permintaan dan menghasilkan respons. Adaptor mengembalikan kode status ini pada respons HTTP dari port respons permintaan HTTP.
Pesan 202 Diterima. Adaptor berhasil mengirimkan pesan ke server atau permintaan satu arah ditangguhkan. Adaptor mengembalikan kode status ini pada respons HTTP dari port penerima HTTP satu arah.
Akses 401 Ditolak. Permintaan HTTP diterima pada port penerima yang diperlukan autentikasi dan pemeriksaan keamanan untuk pesan tersebut gagal. Misalnya, pihak tidak diselesaikan atau pesan tidak didekripsi.
500 Kesalahan Server Internal. Kegagalan umum untuk memproses permintaan HTTP. Pesan tidak ditangguhkan oleh BizTalk Server kecuali pengaturan konfigurasi Menangguhkan Permintaan Gagal diatur ke True untuk port penerima dua arah.

Lihat juga

HTTP Adapter