Elemen <jaringan> (Pengaturan Jaringan)

Artikel
04/08/2023

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

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

Sintaks

<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.

Atribut

Atribut	Deskripsi
`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 mandat 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 surat SMTP. Nilai defaultnya adalah 25.
`targetName`	Menentukan Nama Penyedia Layanan (NPL) 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	Deskripsi
<smtp> Elemen (Pengaturan Jaringan)	Mengonfigurasi opsi pengiriman email Protokol Transportasi Sederhana Email (SMTP).

Keterangan

Beberapa server SMTP mengharuskan Anda mengautentikasi diri Anda ke server sebelum digunakan. Jika Anda ingin mengautentikasi diri Anda menggunakan mandat jaringan default di host Anda, atur atribut defaultCredentials ke true. Properti SmtpNetworkElement.DefaultCredentials dapat digunakan untuk mendapatkan nilai atribut defaultCredentials 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.

Catatan

Autentikasi dasar mengirimkan nilai userName dan password ke server yang tidak terenkripsi. Siapa pun yang memantau lalu lintas jaringan dapat melihat mandat 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 mandat jaringan default saling eksklusif; jika Anda mengatur defaultCredentials ke true dan menentukan nama pengguna dan kata sandi, mandat jaringan default digunakan, dan data autentikasi dasar diabaikan.

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

Properti SmtpNetworkElement.UserName dapat digunakan untuk mendapatkan nilai atribut userName saat ini dari file konfigurasi yang berlaku. Properti SmtpNetworkElement.Password dapat digunakan untuk mendapatkan nilai atribut password 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 komputer lokal yang sepenuhnya memenuhi syarat, bukan nama localhost yang digunakan secara default. Hal ini memberikan kepatuhan yang lebih besar dengan standar protokol SMTP. Nilai defaultnya adalah nama localhost komputer lokal yang mengirim permintaan. Properti SmtpNetworkElement.ClientDomain dapat digunakan untuk mendapatkan nilai atribut clientDomain saat ini dari file konfigurasi yang berlaku.

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

Atribut enableSsl menentukan apakah SSL digunakan untuk mengakses server email SMTP. Kelas System.Net.Mail.SmtpClient hanya mendukung Ekstensi Layanan SMTP untuk 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 yang menggunakan SSL saat ini tidak didukung.

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

Contoh

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>

Bagikan melalui