Bagikan melalui

Cara Mengonfigurasi Port Pengiriman HTTP

Anda dapat mengonfigurasi port pengiriman HTTP baik secara terprogram atau dengan menggunakan konsol Administrasi BizTalk Server.

Mengonfigurasi port pengiriman HTTP secara terprogram

Adaptor HTTP menyimpan informasi konfigurasinya dalam database BizTalk Management (juga dikenal sebagai database Konfigurasi). Anda menyimpan informasi konfigurasi dalam tas properti XML kustom. Selama inisialisasi adaptor HTTP dan selama waktu prosesnya, server meneruskan konfigurasi ke adaptor sebagai berikut:

  • Untuk handler pengiriman HTTP, informasi konfigurasi diteruskan ke adaptor dengan memanggil metode Load antarmuka IPersistPropertyBag .

  • Untuk port pengiriman HTTP, informasi konfigurasi diteruskan ke adaptor sebagai sekumpulan properti pada konteks pesan. Namespace HTTP mengelompokkan properti ini bersama-sama.

    Model objek BizTalk Explorer mengekspos ItransportInfo antarmuka konfigurasi adaptor untuk port pengiriman, yang berisi TransportTypeData properti baca/tulis. Properti ini menerima kelompok properti konfigurasi port pengiriman HTTP sebagai string XML pasangan nama/nilai. Perhatikan bahwa untuk mengatur properti ini dalam model objek BizTalk Explorer, properti pertama-tama harus diatur pada Address properti antarmuka ITransportInfo .

    Mengatur properti TransportTypeData antarmuka ITransportInfo tidak diperlukan. Jika tidak diatur, adaptor HTTP akan menggunakan nilai default untuk handler pengiriman HTTP.

    Jika properti konfigurasi port pengiriman yang menduplikasi konfigurasi untuk handler tidak ditentukan, properti konfigurasi untuk handler digunakan. Jika handler pengiriman HTTP tidak memiliki nilai konfigurasi, adaptor pengiriman HTTP mencatat kesalahan di log peristiwa dan memindahkan pesan ke adaptor cadangan.

    Anda dapat mengatur properti konfigurasi secara terprogram pada konteks pesan. Anda dapat mengatur properti ini dalam jadwal orkestrasi BizTalk Server atau di komponen alur kustom. Aturan berikut berlaku saat menggunakan properti ini:

  • Jika properti konfigurasi diatur pada orkestrasi atau dalam komponen alur kustom dalam alur penerima, maka:

    • Jika sebuah pesan dikirim ke port pengiriman statis, nilai properti akan ditimpa dengan nilai yang dikonfigurasi untuk port pengiriman tersebut.

    • Jika pesan dikirim ke port pengiriman dinamis, nilai properti tidak akan ditimpa.

  • Jika properti konfigurasi diatur dalam komponen alur kustom dalam alur kirim, maka:

    • Nilai tidak akan ditimpa terlepas dari apakah pesan dikirim ke port pengiriman statis atau dinamis.

    Tabel berikut mencantumkan properti konfigurasi yang bisa Anda atur dalam model objek BizTalk Explorer untuk lokasi pengiriman HTTP.

Nama properti Tipe Deskripsi Pembatasan Komentar
RequestTimeout xs:int Periode batas waktu untuk menunggu respons dari server. Jika diatur ke nol (0), sistem menghitung waktu habis berdasarkan ukuran pesan permintaan. Nilai minimum: 0

Nilai maksimum: MAX_LONG		 Nilai default: 0
ContentType xs:string Jenis konten pesan permintaan Panjang minimum: 0

Panjang maksimum: 256		 Nilai default: Teks/XML
MaxRedirects xs:int Berapa kali adaptor HTTP dapat mengalihkan permintaan. Nilai minimum: 0

Nilai maksimum: 10		 Nilai default: 5
UseHandlerProxySettings xs:boolean Menentukan apakah port pengiriman HTTP akan menggunakan konfigurasi proksi untuk penghandel pengiriman. Tidak ada Nilai default: Benar

Jika true, port kirim akan menggunakan pengaturan proksi yang ditentukan pada tingkat handler. Ketika bernilai salah, adaptor pengiriman akan menggunakan informasi proksi yang ditentukan pada port pengiriman.
UseProxy xs:boolean Menentukan apakah adaptor HTTP akan menggunakan server proksi. Server proksi dapat digunakan bersama oleh semua port pengiriman HTTP. Tidak ada Nilai default: Palsu

Properti ini diabaikan jika UseHandlerProxySettings adalah True.
ProxyName xs:string Menentukan nama server proksi. Panjang minimum: 0

Panjang maksimum: 256		 Nilai default: Kosong

Adaptor pengiriman HTTP mengabaikan properti ini jika properti UseHandlerProxySettings diatur ke True. Jika tidak, adaptor pengiriman HTTP menggunakan properti ini hanya jika UseProxyadalah True. Properti ini diperlukan jika UseProxytrue.
ProxyPort xs:int Menentukan port server proksi. Nilai minimum: 0

Nilai maksimum: 65535		 Nilai default: 80

Adaptor pengiriman HTTP mengabaikan properti ini jika UseHandlerProxySettings adalah True. Jika tidak, adaptor pengiriman HTTP menggunakan properti ini hanya jika UseProxyadalah True. Properti ini diperlukan jika UseProxytrue.
ProxyUsername xs:string Menentukan nama pengguna untuk autentikasi dengan server proksi. Panjang minimum: 0

Panjang maksimum: 256		 Nilai default: kosong

Adaptor pengiriman HTTP mengabaikan properti ini jika UseHandlerProxySettings adalah True. Jika tidak, adaptor pengiriman HTTP menggunakan properti ini hanya jika UseProxyadalah True.
ProxyPassword xs:string Menentukan kata sandi pengguna untuk autentikasi dengan server proksi. Panjang minimum: 0

Panjang maksimum: 256		 Nilai default: kosong

Adaptor pengiriman HTTP mengabaikan properti ini jika UseHandlerProxySettings adalah True. Jika tidak, adaptor pengiriman HTTP menggunakan properti ini hanya jika UseProxyadalah True.
AuthenticationScheme xs:string Jenis autentikasi yang akan digunakan dengan server tujuan. Tidak ada Nilai yang valid:

- Anonim (Default)
- Dasar
- Kunyah
- Kerberos
Nama pengguna xs:string Nama pengguna yang akan digunakan untuk autentikasi dengan server. Panjang minimum: 0

Panjang maksimum: 256		 Nilai default: Kosong

Nilai ini diperlukan jika Anda memilih autentikasi Dasar atau Digest. Adaptor HTTP mengabaikan nilai properti ini jika UseSSO adalah True.
Kata sandi xs:string Kata sandi pengguna yang digunakan untuk autentikasi dengan server. Panjang minimum: 0

Panjang maksimum: 256		 Nilai default: kosong

Nilai ini diperlukan jika Anda memilih autentikasi Dasar atau Digest. Nilai properti ini diabaikan jika UseSSO adalah True.
Aktifkan Pengkodean Bertahap xs:boolean Menentukan apakah pengodean terpotong digunakan oleh adaptor HTTP atau tidak Tidak ada Nilai default:

Benar
Sertifikat xs:string Sidik jari sertifikat SSL klien. Panjang minimum: 0

Panjang maksimum: 59		 Nilai default: Kosong
UseSSO xs:boolean Menentukan apakah SSO akan digunakan untuk port kirim. Tidak ada Nilai default: Palsu
AffiliateApplicationName xs:string Nama aplikasi afiliasi yang akan digunakan untuk SSO. Panjang minimum: 0

Panjang maksimum: 256		 Nilai default: kosong

Diperlukan jika UseSSOadalah True.

Kode berikut menunjukkan string XML yang akan digunakan untuk mengatur properti ini:

<CustomProps>  
   <ContentType vt="8">text/xml</ContentType>  
   <RequestTimeout vt="3">0</RequestTimeout>  
   <MaxRedirects vt="3">5</MaxRedirects>  
   <UseHandlerProxySettings vt="8">-1</UseHandlerProxySettings>  
   <UseProxy vt="8">-1</UseProxy>  
   <ProxyName vt="8">sdfsd</ProxyName>  
   <ProxyPort vt="3">80</ProxyPort>  
   <ProxyUsername vt="8">Somename</ProxyUsername>  
   <ProxyPassword vt="8">Somepassword</ProxyPassword>  
   <AuthenticationScheme vt="8">Basic</AuthenticationScheme>  
   <Username vt="8">Somename</Username>  
   <Password vt="8">Somepassword</Password>  
   <EnableChunkedEncoding vt="11">1</EnableChunkedEncoding>  
   <Certificate vt="8">AAAA BBBB CCCC DDDD</Certificate>  
   <UseSSO vt="11">0</UseSSO>  
   <AffiliateApplicationName vt="8">Name</AffiliateApplicationName>  
</CustomProps>

Mengonfigurasi port pengiriman HTTP dengan konsol Administrasi BizTalk Server

Anda dapat mengatur variabel adaptor port pengiriman HTTP di konsol Administrasi BizTalk Server. Jika properti tidak diatur untuk port kirim, nilai handler pengiriman default yang diatur di konsol Administrasi BizTalk Server digunakan.

Nota

Properti konfigurasi yang dijelaskan dalam topik ini umum untuk port pengiriman HTTP satu arah dan respons permintaan.

  1. Di konsol Administrasi BizTalk Server, buat port kirim baru atau klik dua kali port kirim yang ada untuk memodifikasinya. Lihat Cara Membuat Port Kirim untuk informasi selengkapnya. Konfigurasikan semua opsi kirim port dan tentukan HTTP untuk opsi Jenis 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 HTTP , pada tab Umum , lakukan hal berikut:

    Gunakan ini Untuk melakukan ini
    URL Tujuan Dibutuhkan. Tentukan alamat untuk mengirim permintaan HTTP. Sertakan string kueri yang ditambahkan ke URL dasar.

    Jenis: String

    Panjang maksimum: 256

    Untuk informasi selengkapnya, lihat Pembatasan pada Properti URL Tujuan. Nota: URI untuk port kirim atau lokasi terima tidak boleh melebihi 256 karakter.
    Aktifkan pengodean terpotong Tentukan untuk menggunakan pengodean chunked. Jika opsi ini diaktifkan, adaptor HTTP akan menggunakan pengodean terpotong HTTP dengan ukuran gugus maksimum 8 KB. Pengodean per bagian dinonaktifkan secara implisit jika handler pengiriman HTTP dikonfigurasi untuk menggunakan proksi.

    Jenis: Boolean

    Nilai Default: Benar
    Batas waktu permintaan (detik) Tentukan batas waktu dalam detik untuk transmisi HTTP/HTTPS. Jika adaptor HTTP tidak menerima respons dalam waktu ini, layanan mencatat kesalahan dan mengirimkan ulang pesan berdasarkan infrastruktur coba lagi.

    Jika diatur ke nol (0), BizTalk Messaging Engine menghitung batas waktu berdasarkan ukuran pesan permintaan. Jika Anda tidak memberikan nilai, nilai untuk handler digunakan.

    Jenis: Panjang

    Nilai minimum: 0

    Nilai maksimum: MAX_LONG
    Pengalihan maksimum Tentukan pengalihan maksimum yang diizinkan untuk pesan yang dikirim.

    Nilai default: 5

    Jenis: Int

    Nilai minimum: 0

    Nilai maksimum: 10
    Tipe isi Tentukan tipe konten pesan permintaan.

    Jika nilai ini tidak ditetapkan, nilai untuk pengendali akan digunakan.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256

  4. Dalam kotak dialog Properti Transportasi HTTP , pada tab Proksi (penimpaan Handler), lakukan hal berikut:

    Gunakan ini Untuk melakukan ini
    Menggunakan konfigurasi proksi default Handler Tentukan bahwa konfigurasi port kirim harus menggunakan pengaturan proksi yang ditentukan untuk handler pengiriman HTTP.

    Ini adalah pengaturan default.
    Jangan gunakan proksi Tentukan apakah handler pengiriman HTTP menggunakan server proksi.

    Jika dipilih, handler pengiriman HTTP untuk port pengiriman ini tidak menggunakan server proksi.
    Gunakan proksi Tentukan apakah handler pengiriman HTTP menggunakan server proksi.

    Jika dipilih, handler pengiriman HTTP menggunakan server proksi.
    Server Tentukan alamat server proksi untuk port pengiriman ini.

    Properti ini hanya memerlukan nilai jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256
    Port Tentukan port server proksi untuk port pengiriman ini.

    Properti ini hanya memerlukan nilai jika Gunakan proksi dipilih.

    Nilai Default: 80

    Jenis: Panjang

    Nilai minimum: 0

    Nilai maksimum: 65535
    Nama pengguna Tentukan nama pengguna untuk autentikasi dengan server proksi.

    Properti ini hanya memerlukan nilai jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256
    Kata sandi Tentukan kata sandi pengguna untuk autentikasi dengan server proksi.

    Properti ini hanya memerlukan nilai jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256

  5. Dalam kotak dialog Properti Transportasi HTTP , pada tab Autentikasi , lakukan hal berikut:

    Gunakan ini Untuk melakukan ini
    Jenis Autentikasi Tentukan jenis autentikasi yang akan digunakan dengan server tujuan.

    Opsi yang valid adalah:

    - Anonim
    - Dasar
    - Kunyah
    - Kerberos

    Nilai Default: Anonim
    Identifikasi Tentukan jenis kredensial yang akan digunakan.

    Hanya tersedia jika Jenis Autentikasi adalah Dasar atau Digest.

    Opsi yang valid adalah:

    - Jangan gunakan Single Sign-On
    Nama pengguna:
    Nama pengguna yang akan digunakan untuk autentikasi dengan server tujuan. Jika properti Jenis Autentikasi adalah Anonim atau Kerberos, opsi ini dinonaktifkan. Properti ini memerlukan nilai jika Basic atau Digest dipilih, dan Enterprise Single Sign-On tidak digunakan.
    Panjang minimum: 0
    Panjang maksimum: 256
    Kata sandi:
    Kata sandi yang digunakan untuk autentikasi dengan server tujuan. Jika properti Jenis Autentikasi adalah Anonim atau Kerberos, opsi ini dinonaktifkan. Properti ini memerlukan nilai jika Basic atau Digest dipilih, dan Sign-On tunggal tidak digunakan.
    Panjang minimum: 0
    Panjang maksimum: 256
    - Menggunakan Single Sign-On
    Tentukan apakah akan memanfaatkan Single Sign-On untuk mengambil kredensial klien untuk otentikasi dengan server tujuan.
    Aplikasi Afiliasi
    Menentukan aplikasi afiliasi yang akan digunakan untuk Single Sign-On.
    Pilih aplikasi yang ingin Anda sertakan dalam Single Sign-On.
    Panjang minimum: 0
    Panjang maksimum: 256
    Sidik jari sertifikat klien SSL Tentukan thumbprint sertifikat klien yang akan digunakan untuk membuat koneksi Secure Sockets Layer (SSL).

    Panjang minimum: 0

    Panjang maksimum: 59

  6. Klik OK dan OK lagi untuk menyimpan pengaturan.

Lihat Juga

Mengonfigurasi Port Pengiriman HTTP