Bagikan melalui


Cara Mengonfigurasi Port Pengiriman SOAP

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

Cara Mengonfigurasi PORT Kirim SOAP Secara Terprogram

Model objek BizTalk Explorer mengekspos antarmuka khusus adaptor untuk mengirim port bernama ITransportInfo yang memiliki properti baca/tulis TransportTypeData . Properti ini menerima tas properti konfigurasi port kirim SOAP dalam bentuk pasangan nilai nama string XML. Perhatikan bahwa untuk mengatur properti ini dalam model objek BizTalk Explorer, Anda harus mengatur properti OutboundTransportLocation antarmuka ITransportInfo terlebih dahulu.

Properti TransportTypeData antarmuka ITransportInfo tidak diperlukan. Jika tidak diatur, adaptor menggunakan nilai default untuk konfigurasi port pengiriman SOAP, seperti yang ditunjukkan dalam tabel berikut.

Tabel berikut mencantumkan properti konfigurasi yang dapat Anda atur dalam model objek BizTalk Explorer untuk port pengiriman SOAP.

Nama properti Jenis Deskripsi
URI String Direktori virtual yang berisi layanan Web di server penyebaran.
Nama pengguna String Nama pengguna yang akan ditentukan untuk mengakses layanan Web target.

Nilai default: Kosong
Kata sandi String Kata sandi pengguna yang digunakan untuk autentikasi dengan server.

Nilai default: Kosong
ClientCertificate String Thumbprint sertifikat SSL klien.

Nilai default: Kosong
AffiliateApplicationName String Nama aplikasi SSO yang digunakan untuk menukarkan tiket kredensial klien.

AffiliateApplicationName saling eksklusif untuk pasangan Nama Pengguna dan Kata Sandi.

Nilai default: Kosong
UseProxy Boolean Menunjukkan apakah port pengiriman SOAP menggunakan server proksi untuk mengakses layanan Web target. Server proksi dapat dibagikan oleh semua port pengiriman SOAP.

Nilai default: False
ProxyAddress String Alamat proksi HTTP yang akan digunakan untuk panggilan layanan Web.

Nilai default: Kosong
ProxyPort Bilangan bulat Port proksi HTTP yang akan digunakan untuk panggilan layanan Web.

Nilai default: Kosong
ProxyUsername String Nama pengguna yang akan digunakan untuk proksi.

Nilai default: Kosong
ProxyPassword String Kata sandi yang digunakan untuk proksi.

Nilai default: Kosong

Kode berikut menunjukkan format yang akan digunakan untuk mengatur properti ini:

<CustomProps>  
   <URI vt="8"/>  
   <ClientCertificate vt="8"/>  
   <Password vt="8">Encrypted</Password>  
   <ProxyAddress vt="8"/>  
   <ProxyPassword vt="8">Encrypted</ProxyPassword>  
   <ProxyPort vt="3"/>  
   <ProxyUsername vt="8"/>  
   <UseProxy vt="11"/>  
   <Username vt="8"/>  
   <AffiliateApplicationName vt="8"/>  
</CustomProps>  

Cara Mengonfigurasi Port Pengiriman SOAP dengan Konsol Administrasi BizTalk Server

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

Untuk mengonfigurasi variabel untuk port pengiriman SOAP

  1. Di konsol Administrasi BizTalk Server, 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 SOAP untuk opsi Jenis di bagian Transportasi pada tab Umum .

  2. Pada tab Umum , di bagian Transportasi di samping Jenis, klik Konfigurasikan.

  3. Dalam kotak dialog Properti Transportasi SOAP , pada tab Umum , lakukan hal berikut:

    Gunakan ini Untuk melakukan ini
    URL Layanan Web Tentukan alamat layanan Web yang ingin Anda panggil. Catatan: URI untuk port kirim atau lokasi terima tidak boleh melebihi 256 karakter.
    Autentikasi Tunjukkan metode autentikasi yang digunakan oleh layanan Web yang Anda panggil.

    Opsi:

    - Anonim. Pengaturan default.
    - Dasar. Koneksi SOAP mengirimkan nama pengguna dan kata sandi dalam teks biasa.
    - Mencerna. Koneksi SOAP mengirimkan kata sandi dalam format terenkripsi.
    - NTLM. Nama pengguna maupun kata sandi tidak dikirim melalui koneksi SOAP. Adaptor SOAP selalu menggunakan kredensial proses di mana adaptor pengiriman SOAP berjalan untuk jenis autentikasi ini.
    Kredensial Tentukan jenis kredensial yang akan digunakan.

    Hanya tersedia jika jenis Autentikasi adalah Dasar atau Hash.

    Opsi:

    - Jangan gunakan akses menyeluruh
    Nama pengguna
    Nama pengguna yang digunakan untuk autentikasi dengan server tujuan. Jika properti Jenis autentikasi adalah Anonim atau NTLM, opsi ini dinonaktifkan. Properti ini memerlukan nilai jika Dasar atau Hash dipilih, dan Sign-On Tunggal Perusahaan 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 NTLM, opsi ini dinonaktifkan. Properti ini memerlukan nilai jika Dasar atau Hash dipilih, dan Sign-On Tunggal tidak digunakan.
    Panjang minimum: 0
    Panjang maksimum: 256
    - Menggunakan Akses Menyeluruh
    Tentukan apakah akan menggunakan Sign-On Tunggal untuk mengambil kredensial klien untuk autentikasi dengan server tujuan.
    Aplikasi Afiliasi
    Menentukan aplikasi afiliasi yang akan digunakan untuk Akses Menyeluruh. Untuk informasi tentang mengisi daftar ini, lihat Aplikasi Afiliasi SSO.
    Panjang minimum: 0
    Panjang maksimum: 256
    Thumbprint Sertifikat Klien Tentukan thumbprint sertifikat klien yang akan digunakan untuk membuat koneksi.

    Contoh: 01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67

    Panjang minimum: 0

    Panjang maksimum: 59
  4. Dalam kotak dialog Properti Transportasi SOAP , pada tab Proksi , lakukan hal berikut:

    Gunakan ini Untuk melakukan ini
    Menggunakan konfigurasi proksi default Handler Tentukan konfigurasi handler proksi port kirim. Jika true, port akan menggunakan pengaturan proksi yang ditentukan pada tingkat handler. Ketika false, adaptor kirim akan menggunakan informasi proksi yang ditentukan pada port kirim.

    Pengaturan defaultnya adalah true.
    Jangan gunakan proksi Menunjukkan apakah handler pengiriman SOAP menggunakan server proksi.
    Menggunakan proksi Menunjukkan apakah handler pengiriman SOAP menggunakan server proksi. Server proksi dapat dibagikan oleh semua port pengiriman SOAP.
    Server Menentukan nama server proksi.

    Properti ini hanya memerlukan nilai jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256
    Port Tentukan port yang digunakan handler pengiriman SOAP.

    Properti ini hanya memerlukan nilai jika Gunakan proksi dipilih.

    Nilai Default: 80

    Jenis: Panjang

    Nilai minimum: 0

    Nilai maksimum: 65535 Catatan: Menentukan nilai 0 menunjukkan untuk menggunakan nilai default, yaitu port 80.
    Nama pengguna Tentukan nama pengguna yang akan digunakan untuk autentikasi. Jika Anda menggunakan autentikasi terintegrasi Windows, nama pengguna menyertakan domain, domain\nama pengguna. Jika Anda menggunakan autentikasi Dasar atau Hash, nama pengguna tidak menyertakan domain\.

    Properti ini hanya memerlukan nilai jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256
    Kata sandi Tentukan kata sandi yang akan digunakan untuk autentikasi.

    Properti ini hanya memerlukan nilai jika Gunakan proksi dipilih.

    Jenis: String

    Panjang minimum: 0

    Panjang maksimum: 256
  5. Dalam kotak dialog Properti Transportasi SOAP , pada tab Layanan Web , lakukan hal berikut:

    Gunakan ini Untuk melakukan ini
    Port Web Orkestrasi Tentukan untuk menggunakan layanan Web yang diekspos di URL Layanan Web yang tercantum pada tab Umum .

    Ini adalah pengaturan default.
    Nama rakitan Tentukan nama rakitan yang berisi proksi layanan Web. Bidang ini dapat diisi dengan mengklik tombol telusuri untuk menemukan assembly. Setelah memilih rakitan, kotak ini diisi dengan nama assembly yang sepenuhnya memenuhi syarat. Catatan: Rakitan yang ditentukan harus ada di semua BizTalk Server pada runtime.
    Nama jenis Tentukan nama kelas yang berisi metode Web yang akan dipanggil. Ini dapat dipilih dari daftar jenis yang terkandung dalam assembly.
    Nama metode Tentukan salah satu metode dalam kotak daftar atau pilih opsi untuk "Tentukan nanti". Jika opsi untuk "Tentukan nanti" dipilih, metode Web harus diatur oleh beberapa cara lain, seperti komponen alur. Dalam skenario ini, metode web harus ditulis ke properti konteks Soap Adapter MethodName .
    SOAP 1.2 Tentukan untuk menghasilkan kode proksi yang akan mendukung protokol SOAP 1.2. Jika opsi ini dibiarkan kosong, kode proksi yang mematuhi SOAP 1.1 akan dihasilkan.

    Nilai default: dihapus
  6. Klik OK dan OK lagi untuk menyimpan pengaturan.

Lihat juga

Layanan Web Penerbitan