<httpTransport>

Artikel
06/08/2023

Menentukan transportasi HTTP untuk mentransmisikan pesan SOAP untuk pengikatan kustom.

<konfigurasi>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <httpTransport>

Sintaks

<httpTransport allowCookies="Boolean"
               authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
               bypassProxyOnLocal="Boolean"
               hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
               keepAliveEnabled="Boolean"
               maxBufferSize="Integer"
               proxyAddress="Uri"
               proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
               realm="String"
               transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
               unsafeConnectionNtlmAuthentication="Boolean"
               useDefaultWebProxy="Boolean" />

Atribut dan Elemen

Bagian berikut menjelaskan atribut, elemen turunan, dan elemen induk.

Atribut

Atribut	Deskripsi
allowCookies	Nilai Boolean yang menentukan apakah klien menerima cookie dan menyebarkannya pada permintaan mendatang. Defaultnya adalah `false`. Anda dapat menggunakan atribut ini ketika berinteraksi dengan layanan Web ASMX yang menggunakan cookie. Dengan cara ini, Anda dapat yakin bahwa cookie yang dikembalikan dari server secara otomatis disalin ke semua permintaan klien di masa mendatang untuk layanan tersebut.
authenticationScheme	Menentukan protokol yang digunakan untuk mengautentikasi permintaan klien yang sedang diproses oleh pendengar HTTP. Nilai yang valid mencakup hal-hal berikut: - Digest: Menentukan autentikasi digest. - Negotiate: Bernegosiasi dengan klien untuk menentukan skema autentikasi. Jika klien dan server mendukung Kerberos, Kerberos digunakan; jika tidak, NTLM digunakan. - Ntlm: Menentukan autentikasi NTLM. - Basic: Menentukan autentikasi dasar. - Anonymous: Menentukan autentikasi anonim. Defaultnya adalah Anonim. Atribut ini berjenis AuthenticationSchemes. Atribut ini hanya dapat diatur satu kali.
bypassProxyOnLocal	Nilai Boolean yang menunjukkan apakah akan melewati server proksi untuk alamat lokal. Defaultnya adalah `false`. Alamat lokal adalah alamat yang ada di LAN lokal atau intranet. Windows Communication Foundation (WCF) selalu mengabaikan proksi jika alamat layanan dimulai dengan `http://localhost`. Anda harus menggunakan nama host daripada localhost jika ingin agar klien melewati proksi saat berbicara dengan layanan di mesin yang sama.
hostnameComparisonMode	Menentukan mode perbandingan nama host HTTP yang digunakan untuk mengurai URI. Nilai yang valid adalah, - StrongWildcard: ("+") cocok dengan semua kemungkinan nama host dalam konteks skema, port, dan URI relatif yang ditentukan. - Exact: tidak ada wildcard - WeakWildcard: ("*") cocok dengan semua kemungkinan nama host dalam konteks skema tertentu, port, dan UIR relatif yang belum dicocokkan secara eksplisit atau melalui mekanisme wildcard yang kuat. Atribut ini adalah jenis HostNameComparisonMode. Defaultnya adalah StrongWildcard.
keepAliveEnabled	Nilai Boolean yang menentukan apakah akan membuat koneksi persisten ke sumber daya internet.
maxBufferSize	Bilangan bulat positif yang menentukan ukuran maksimum buffer. Defaultnya adalah 524288
proxyAddress	URI yang menentukan alamat proksi HTTP. Jika `useSystemWebProxy` adalah `true`, pengaturan ini harus `null`. Defaultnya adalah `null`.
proxyAuthenticationScheme	Menentukan protokol yang digunakan untuk mengautentikasi permintaan klien yang sedang diproses oleh proksi HTTP. Nilai yang valid mencakup hal-hal berikut: - None: Tidak ada autentikasi yang dilakukan. - Digest: Menentukan autentikasi digest. - Negotiate: Bernegosiasi dengan klien untuk menentukan skema autentikasi. Jika klien dan server mendukung Kerberos, Kerberos digunakan; jika tidak, NTLM digunakan. - Ntlm: Menentukan autentikasi NTLM. - Basic: Menentukan autentikasi dasar. - Anonymous: Menentukan autentikasi anonim. Defaultnya adalah Anonim. Atribut ini berjenis AuthenticationSchemes. Perhatikan bahwa AuthenticationSchemes.IntegratedWindowsAuthentication tidak didukung.
Realm	String yang menentukan realm yang akan digunakan pada proksi/server. Defaultnya adalah string kosong. Server menggunakan realm untuk mempartisi sumber daya yang dilindungi. Setiap partisi dapat memiliki skema autentikasi dan/atau database otorisasinya sendiri. Realm hanya digunakan untuk autentikasi dasar dan digest. Setelah klien berhasil mengautentikasi, autentikasi berlaku untuk semua sumber daya di realm tertentu. Untuk penjelasan terperinci tentang realm, lihat RFC 2617 di situs web IETF.
transferMode	Menentukan apakah pesan di-buffer atau dialirkan atau merupakan permintaan atau respons. Nilai yang valid mencakup hal-hal berikut: - Buffered: Pesan permintaan dan respons di-buffer. - Streaming: Pesan permintaan dan respons dialirkan. - StreamedRequest: Pesan permintaan dialirkan dan pesan respons di-buffer. - StreamedResponse: Pesan permintaan di-buffer dan pesan respons dialirkan. Defaultnya adalah Buffered. Atribut ini adalah jenis TransferMode.
unsafeConnectionNtlmAuthentication	Nilai Boolean yang menentukan apakah Berbagi Koneksi Tidak Aman diaktifkan di server. Defaultnya adalah `false`. Jika diaktifkan, autentikasi NTLM dilakukan sekali pada setiap koneksi TCP.
useDefaultWebProxy	Nilai Boolean yang menentukan apakah pengaturan proksi seluruh mesin digunakan alih-alih pengaturan khusus pengguna. Defaultnya adalah `true`.

Elemen Anak

Tidak ada

Elemen Induk

Elemen	Deskripsi
<pengikatan>	Menentukan semua kemampuan pengikatan dari pengikatan kustom.

Keterangan

Elemen httpTransport adalah titik awal untuk membuat pengikatan kustom yang mengimplementasikan protokol transportasi HTTP. HTTP adalah transportasi utama yang digunakan untuk tujuan interoperabilitas. Transportasi ini didukung oleh Windows Communication Foundation (WCF) untuk memastikan interoperabilitas dengan tumpukan layanan Web non-WCF lainnya.

Bagikan melalui