<element sítě> (nastavení sítě)

Článek
05/10/2023

Konfiguruje možnosti sítě pro externí server SMTP (Simple Mail Transport Protocol).

<Konfigurace>
  <system.net>
    <mailSettings>
      <Smtp>
        <Síťové>

Syntax

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

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut	Popis
`clientDomain`	Určuje název domény klienta, který se má použít v počátečním požadavku protokolu SMTP pro připojení k poštovnímu serveru SMTP. Výchozí hodnota je název místního hostitele místního počítače odesílajícího požadavek.
`defaultCredentials`	Určuje, zda mají být pro přístup k poštovnímu serveru SMTP pro transakce SMTP použity výchozí přihlašovací údaje uživatele. Výchozí hodnota je `false`.
`enableSsl`	Určuje, jestli se pro přístup k poštovnímu serveru SMTP použije protokol SSL. Výchozí hodnota je `false`.
`host`	Určuje název hostitele poštovního serveru SMTP, který se má použít pro transakce SMTP. Tento atribut nemá žádnou výchozí hodnotu.
`password`	Určuje heslo pro ověření poštovního serveru SMTP. Tento atribut nemá žádnou výchozí hodnotu.
`port`	Určuje číslo portu pro připojení k poštovnímu serveru SMTP. Výchozí hodnota je 25.
`targetName`	Určuje název poskytovatele služby (SPN), který se má použít k ověřování při použití rozšířené ochrany pro transakce SMTP. Tento atribut nemá žádnou výchozí hodnotu.
`userName`	Určuje uživatelské jméno, které se má použít pro ověřování na poštovním serveru SMTP. Tento atribut nemá žádnou výchozí hodnotu.

Podřízené elementy

Žádné

Nadřazené elementy

Element	Popis
<smtp> – element (nastavení sítě)	Konfiguruje možnosti odesílání pošty smtp (Simple Mail Transport Protocol).

Poznámky

Některé servery SMTP vyžadují, abyste se před použitím ověřili na serveru. Pokud se chcete ověřit pomocí výchozích síťových přihlašovacích údajů na hostiteli, nastavte defaultCredentials atribut na true. Vlastnost SmtpNetworkElement.DefaultCredentials lze použít k získání aktuální hodnoty atributu defaultCredentials z příslušných konfiguračních souborů.

K ověření na serveru SMTP můžete také použít základní ověřování (uživatelské jméno a heslo). Chcete-li použít tuto možnost, je nutné zadat platné uživatelské jméno a heslo pro zadaný server SMTP.

Poznámka

Základní ověřování odesílá userName hodnoty a password na server bez šifrování. Každý, kdo monitoruje síťový provoz, může zobrazit vaše přihlašovací údaje a použít je pro připojení k serveru. Měli byste zvážit použití bezpečnějšího mechanismu ověřování, jako je kerberos nebo NT LAN Manager (NTLM). Pokud defaultCredentials je true, použije se Protokol Kerberos nebo NTLM, pokud server podporuje tyto protokoly.

Možnosti základního ověřování a výchozích síťových přihlašovacích údajů se vzájemně vylučují. Pokud nastavíte defaultCredentialstrue a zadáte uživatelské jméno a heslo, použijí se výchozí přihlašovací údaje sítě a základní ověřovací data se ignorují.

Pokud zadáte userNamezákladní ověřování , měli byste také zadat , password abyste se na poštovním serveru mohli ověřit sami.

Vlastnost SmtpNetworkElement.UserName lze použít k získání aktuální hodnoty atributu userName z příslušných konfiguračních souborů. Vlastnost SmtpNetworkElement.Password lze použít k získání aktuální hodnoty atributu password z příslušných konfiguračních souborů. Atribut password by obvykle nebyl z bezpečnostních důvodů zadán do konfiguračních souborů.

Atribut clientDomain změní název domény klienta použitý v počátečním požadavku protokolu SMTP na server SMTP. Atribut clientDomain lze nastavit na plně kvalifikovaný název domény místního počítače, nikoli na název localhost, který se používá ve výchozím nastavení. To zajišťuje lepší dodržování standardů protokolu SMTP. Výchozí hodnota je název místního hostitele místního počítače odesílajícího požadavek. Vlastnost SmtpNetworkElement.ClientDomain lze použít k získání aktuální hodnoty atributu clientDomain z příslušných konfiguračních souborů.

Atribut se targetName používá k ověřování při použití rozšířené ochrany. Výchozí hodnota je ve tvaru SMTPSVC/<host>, kde <hostitel> je název hostitele poštovního serveru SMTP. Vlastnost SmtpNetworkElement.TargetName lze použít k získání aktuální hodnoty atributu targetName z příslušných konfiguračních souborů.

Atribut enableSsl určuje, jestli se pro přístup k poštovnímu serveru SMTP používá protokol SSL. Třída System.Net.Mail.SmtpClient podporuje pouze rozšíření služby SMTP pro secure SMTP over Transport Layer Security, jak je definováno v DOKUMENTU RFC 3207. V tomto režimu začíná relace SMTP na nešifrované kanálu. Klient pak vydá na server příkaz STARTTLS, aby se přepnul na zabezpečenou komunikaci pomocí PROTOKOLU SSL. Další informace najdete v dokumentu RFC 3207 publikovaném týmem IETF (Internet Engineering Task Force).

Alternativní způsob připojení je, kdy se relace SSL vytvoří předem před odesláním příkazů protokolu. Tato metoda připojení se někdy nazývá SMTPS a ve výchozím nastavení používá port 465. Tato alternativní metoda připojení využívající PROTOKOL SSL se v současné době nepodporuje.

Vlastnost SmtpNetworkElement.EnableSsl lze použít k získání aktuální hodnoty atributu enableSsl z příslušných konfiguračních souborů.

Příklad

Následující příklad určuje příslušné parametry SMTP pro odesílání e-mailů pomocí výchozích síťových přihlašovacích údajů.

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

Sdílet prostřednictvím