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

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

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

Syntaxe

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

Atributy a prvky

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

Attributes

Vlastnost Description
clientDomain Určuje název domény klienta, který se má použít v počáteční žádosti protokolu SMTP pro připojení k poštovnímu serveru SMTP. Výchozí hodnota je název localhost místního počítače, který požadavek odesílá.
defaultCredentials Určuje, jestli se mají použít výchozí přihlašovací údaje uživatele pro přístup k poštovnímu serveru SMTP pro transakce SMTP. Výchozí hodnota je false.
enableSsl Určuje, jestli se pro přístup k poštovnímu serveru SMTP používá 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á výchozí hodnotu.
password Určuje heslo, které se má použít pro ověřování poštovního serveru SMTP. Tento atribut nemá výchozí hodnotu.
port Určuje číslo portu, které se má použít pro připojení k poštovnímu serveru SMTP. Výchozí hodnota je 25.
targetName Určuje název Zprostředkovatele služeb (SPN), který se má použít pro ověřování při použití rozšířené ochrany pro transakce SMTP. Tento atribut nemá výchozí hodnotu.
userName Určuje uživatelské jméno, které se má použít pro ověřování poštovního serveru SMTP. Tento atribut nemá výchozí hodnotu.

Podřízené prvky

Žádné.

Nadřazené prvky

prvek Description
<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 atribut na defaultCredentialstrue. 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 použít také základní ověřování (uživatelské jméno a heslo). Chcete-li použít tuto možnost, musíte zadat platné uživatelské jméno a heslo pro zadaný server SMTP.

Poznámka:

Základní ověřování odesílá userName a password hodnoty na server nešifrovaný. Každý, kdo monitoruje síťový provoz, může zobrazit vaše přihlašovací údaje a použít je k 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, Protokol Kerberos nebo NTLM se použije, pokud server podporuje tyto protokoly.

Základní ověřování a výchozí možnosti přihlašovacích údajů sítě 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 ověřování sami na poštovním serveru.

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 se obvykle nezadá do konfiguračních souborů z bezpečnostních důvodů.

Atribut clientDomain změní název domény klienta použitý v počáteční žádosti protokolu SMTP na server SMTP. Atribut clientDomain lze nastavit na plně kvalifikovaný název domény místního počítače, nikoli název localhost, který se ve výchozím nastavení používá. To zajišťuje větší dodržování standardů protokolu SMTP. Výchozí hodnota je název localhost místního počítače, který požadavek odesílá. 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 targetName se používá pro ověřování při použití rozšířené ochrany. Výchozí hodnota je ve formátu SMTPSVC/<host>, kde <host> 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 RFC 3207. V tomto režimu začíná relace SMTP v nešifrovaném kanálu a pak klient vydá příkaz STARTTLS serveru, který přepne na zabezpečenou komunikaci pomocí PROTOKOLU SSL. Další informace najdete v dokumentu RFC 3207 publikovaném týmem IETF (Internet Engineering Task Force).

Alternativní metoda připojení je místo, kde je relace SSL vytvořena 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ů.

Example

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>

Viz také

  • Last updated on