elemen<messageSenderAuthentication>

  • Artikel

Menentukan opsi autentikasi untuk pengirim pesan peer-to-peer.

Untuk informasi selengkapnya tentang pemrograman peer-to-peer, lihat Jaringan Peer-to-Peer.

<konfigurasi>
  <system.serviceModel>
    <perilaku>
      <endpointBehaviors>
        <perilaku>
          <clientCredentials>
            <peer>
              <messageSenderAuthentication>

Sintaks

<messageSenderAuthentication customCertificateValidatorType= "namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"
                             certificateValidationMode = "ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"
                             revocationMode="NoCheck/Online/Offline"
                             trustedStoreLocation="CurrentUser/LocalMachine" />

Atribut dan Elemen

Bagian berikut menjelaskan atribut, elemen anak, dan elemen induk

Atribut

Atribut Deskripsi
customCertificateValidatorType Jenis dan assembly yang digunakan untuk memvalidasi jenis khusus. Atribut ini harus diatur ketika certificateValidationMode diatur ke Custom.
certificateValidationMode Menentukan salah satu dari tiga mode yang digunakan untuk memvalidasi kredensial. Jika diatur menjadi Custom, maka customCertificateValidator juga harus diberikan.
revocationMode Salah satu modus yang digunakan untuk memeriksa daftar sertifikat yang dicabut (CRL).
trustedStoreLocation Salah satu dari dua lokasi penyimpanan sistem: LocalMachine atau CurrentUser. Nilai ini digunakan ketika sertifikat layanan dinegosiasikan ke klien. Validasi dilakukan terhadap penyimpanan Orang Tepercaya di lokasi penyimpanan yang ditentukan.

customCertificateValidatorType Attribute

Nilai Deskripsi
String Opsional. Menentukan nama jenis dan assembly dan data lain yang digunakan untuk menemukan jenis. Paling sedikit diperlukan namespace dan nama jenis. Informasi opsional meliputi: nama assembly, nomor versi, budaya, dan token kunci publik.

Atribut certificateValidationMode

Nilai Deskripsi
Enumeration Opsional. Salah satu dari nilai berikut: None, PeerTrust, ChainTrust, PeerOrChainTrust, Custom. Defaultnya adalah ChainTrust. Defaultnya adalah ChainTrust.

Untuk informasi selengkapnya, lihat Bekerja dengan Sertifikat.

Atribut revocationMode

Nilai Deskripsi
Enumeration Salah satu dari nilai berikut: NoCheck, Online, Offline. Defaultnya adalah Online.

Untuk informasi selengkapnya, lihat Bekerja dengan Sertifikat.

Atribut trustedStoreLocation

Nilai Deskripsi
Enumeration Salah satu nilai berikut: LocalMachine atau CurrentUser. Defaultnya adalah CurrentUser. Jika aplikasi klien berjalan di bagian akun sistem, maka sertifikat biasanya di bagian LocalMachine. Jika aplikasi klien berjalan di bagian akun pengguna, maka sertifikat biasanya di bagian CurrentUser. Defaultnya adalah CurrentUser.

Elemen Anak

Tidak ada.

Elemen Induk

Elemen Deskripsi
<peer> Menentukan kredensial yang digunakan untuk mengautentikasi klien ke layanan peer.

Keterangan

Elemen ini harus dikonfigurasi jika autentikasi pesan dipilih. Untuk saluran output, setiap pesan ditandatangani menggunakan sertifikat yang disediakan oleh <sertifikat>. Semua pesan, sebelum dikirim ke aplikasi, diperiksa terhadap kredensial pesan menggunakan validator yang ditentukan oleh atribut customCertificateValidatorType elemen ini. Validator dapat menerima atau menolak kredensial.

Contoh

Kode berikut mengatur mode validasi pengirim pesan ke PeerOrChainTrust.

<behaviors>
  <endpointBehaviors>
    <behavior name="MyEndpointBehavior">
      <clientCredentials>
        <peer>
          <certificate findValue="www.contoso.com"
                       storeLocation="LocalMachine"
                       x509FindType="FindByIssuerName" />
          <messageSenderAuthentication certificateValidationMode="PeerOrChainTrust" />
          <messageSenderAuthentication certificateValidationMode="None" />
        </peer>
      </clientCredentials>
    </behavior>
  </endpointBehaviors>
</behaviors>

Lihat juga