Bagikan melalui

<network> Elemen (Pengaturan Jaringan)

Mengonfigurasi opsi jaringan untuk server Simple Mail Transport Protocol (SMTP) eksternal.

<configuration>
  <system.net>
    <mailSettings>
      <smtp>
        <network>

Syntax

<network
  clientDomain="string"
  defaultCredentials="true|false"
  enableSsl="true|false"
  host="string"
  password="string"
  port="integer"
  targetName="string"
  userName="string"
/>

Atribut dan Elemen

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

Attributes

Attribute Description
clientDomain Menentukan nama domain klien yang akan digunakan dalam permintaan protokol SMTP awal untuk menyambungkan ke server email SMTP. Nilai defaultnya adalah nama localhost komputer lokal yang mengirim permintaan.
defaultCredentials Menentukan apakah kredensial pengguna default harus digunakan untuk mengakses server email SMTP untuk transaksi SMTP. Nilai defaultnya adalah false.
enableSsl Menentukan apakah SSL digunakan untuk mengakses server email SMTP. Nilai defaultnya adalah false.
host Menentukan nama host server email SMTP yang akan digunakan untuk transaksi SMTP. Atribut ini tidak memiliki nilai default.
password Menentukan kata sandi yang akan digunakan untuk autentikasi ke server email SMTP. Atribut ini tidak memiliki nilai default.
port Menentukan nomor port yang akan digunakan untuk menyambungkan ke server email SMTP. Nilai defaultnya adalah 25.
targetName Menentukan Nama Penyedia Layanan (SPN) yang akan digunakan untuk autentikasi saat menggunakan perlindungan yang diperluas untuk transaksi SMTP. Atribut ini tidak memiliki nilai default.
userName Menentukan nama pengguna yang akan digunakan untuk autentikasi ke server email SMTP. Atribut ini tidak memiliki nilai default.

Elemen Anak

Tidak ada.

Elemen Induk

Elemen Description
<Elemen smtp> (Pengaturan Jaringan) Mengonfigurasi opsi pengiriman surat Simple Mail Transport Protocol (SMTP).

Komentar

Beberapa server SMTP mengharuskan Anda mengautentikasi diri Anda ke server sebelum digunakan. Jika Anda ingin mengautentikasi diri Anda menggunakan kredensial jaringan default di host Anda, atur defaultCredentials atribut ke true. SmtpNetworkElement.DefaultCredentials Properti dapat digunakan untuk mendapatkan nilai defaultCredentials atribut saat ini dari file konfigurasi yang berlaku.

Anda juga dapat menggunakan autentikasi dasar (nama pengguna dan kata sandi) untuk mengautentikasi diri Anda ke server SMTP. Untuk menggunakan opsi ini, Anda harus menentukan nama pengguna dan kata sandi yang valid untuk server SMTP yang ditentukan.

Nota

Autentikasi dasar mengirimkan userName nilai dan password ke server yang tidak terenkripsi. Siapa pun yang memantau lalu lintas jaringan dapat melihat kredensial Anda dan menggunakannya untuk terhubung ke server. Anda harus mempertimbangkan untuk menggunakan mekanisme autentikasi yang lebih aman, seperti Kerberos atau NT LAN Manager (NTLM.) Jika defaultCredentials adalah true, Kerberos atau NTLM akan digunakan jika server mendukung protokol ini.

Opsi autentikasi dasar dan kredensial jaringan default saling eksklusif; jika Anda mengatur defaultCredentials ke true dan menentukan nama pengguna dan kata sandi, kredensial jaringan default digunakan, dan data autentikasi dasar diabaikan.

Untuk autentikasi dasar jika Anda menentukan userName, Anda juga harus menentukan untuk mengautentikasi password sendiri ke server email.

SmtpNetworkElement.UserName Properti dapat digunakan untuk mendapatkan nilai userName atribut saat ini dari file konfigurasi yang berlaku. SmtpNetworkElement.Password Properti dapat digunakan untuk mendapatkan nilai password atribut saat ini dari file konfigurasi yang berlaku. Atribut password biasanya tidak akan dimasukkan dalam file konfigurasi karena alasan keamanan.

Atribut clientDomain mengubah nama domain klien yang digunakan dalam permintaan protokol SMTP awal ke server SMTP. Atribut clientDomain dapat diatur ke nama domain yang sepenuhnya memenuhi syarat dari komputer lokal, bukan nama localhost yang digunakan secara default. Ini memberikan kepatuhan yang lebih besar dengan standar protokol SMTP. Nilai defaultnya adalah nama localhost komputer lokal yang mengirim permintaan. SmtpNetworkElement.ClientDomain Properti dapat digunakan untuk mendapatkan nilai clientDomain atribut saat ini dari file konfigurasi yang berlaku.

Atribut targetName digunakan untuk autentikasi saat menggunakan perlindungan yang diperluas. Nilai defaultnya adalah formulir "SMTPSVC/<host>" di mana <host> adalah nama host server email SMTP. SmtpNetworkElement.TargetName Properti dapat digunakan untuk mendapatkan nilai targetName atribut saat ini dari file konfigurasi yang berlaku.

Atribut enableSsl menentukan apakah SSL digunakan untuk mengakses server email SMTP. Kelas System.Net.Mail.SmtpClient ini hanya mendukung Ekstensi Layanan SMTP untuk Keamanan SMTP Aman melalui Keamanan Lapisan Transportasi seperti yang didefinisikan dalam RFC 3207. Dalam mode ini, sesi SMTP dimulai pada saluran yang tidak terenkripsi, lalu perintah STARTTLS dikeluarkan oleh klien ke server untuk beralih ke komunikasi yang aman menggunakan SSL. Lihat RFC 3207 yang diterbitkan oleh Internet Engineering Task Force (IETF) untuk informasi selengkapnya.

Metode koneksi alternatif adalah tempat sesi SSL dibuat di depan sebelum perintah protokol dikirim. Metode koneksi ini terkadang disebut SMTPS dan secara default menggunakan port 465. Metode koneksi alternatif menggunakan SSL saat ini tidak didukung.

SmtpNetworkElement.EnableSsl Properti dapat digunakan untuk mendapatkan nilai enableSsl atribut saat ini dari file konfigurasi yang berlaku.

Example

Contoh berikut menentukan parameter SMTP yang sesuai untuk mengirim email menggunakan kredensial jaringan default.

<configuration>
  <system.net>
    <mailSettings>
      <smtp deliveryMethod="Network">
        <network
          clientDomain="www.contoso.com"
          defaultCredentials="true"
          enableSsl="false"
          host="mail.contoso.com"
          port="25"
        />
      </smtp>
    </mailSettings>
  </system.net>
</configuration>

Lihat juga

  • Last updated on