<Элемент network> (параметры сети)

  • Статья

Настраивает параметры сети для внешнего SMTP-сервера.

<Конфигурации>
  <system.net>
    <mailSettings>
      <Smtp>
        <Сети>

Синтаксис

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Описание
clientDomain Указывает доменное имя клиента, используемое в исходном запросе протокола SMTP для подключения к почтовому smtp-серверу. Значением по умолчанию является имя localhost локального компьютера, отправляющего запрос.
defaultCredentials Указывает, следует ли использовать учетные данные пользователя по умолчанию для доступа к почтовому smtp-серверу для smtp-транзакций. Значение по умолчанию — false.
enableSsl Указывает, используется ли SSL для доступа к почтовому smtp-серверу. Значение по умолчанию — false.
host Указывает имя узла почтового SMTP-сервера, используемого для транзакций SMTP. Этот атрибут не имеет значения по умолчанию.
password Указывает пароль, используемый для проверки подлинности на smtp-почтовом сервере. Этот атрибут не имеет значения по умолчанию.
port Указывает номер порта, используемого для подключения к почтовому SMTP-серверу. По умолчанию используется значение 25.
targetName Указывает имя поставщика услуг (SPN), используемое для проверки подлинности при использовании расширенной защиты для транзакций SMTP. Этот атрибут не имеет значения по умолчанию.
userName Указывает имя пользователя, используемое для проверки подлинности на smtp-почтовом сервере. Этот атрибут не имеет значения по умолчанию.

Дочерние элементы

Отсутствует.

Родительские элементы

Элемент Описание
<Элемент smtp> (параметры сети) Настраивает параметры отправки почты SMTP.

Комментарии

Некоторые SMTP-серверы требуют проверки подлинности на сервере перед использованием. Если вы хотите пройти проверку подлинности с помощью сетевых учетных данных по умолчанию на узле, задайте для атрибута defaultCredentials значение true. Свойство SmtpNetworkElement.DefaultCredentials можно использовать для получения текущего значения атрибута defaultCredentials из применимых файлов конфигурации.

Вы также можете использовать обычную проверку подлинности (имя пользователя и пароль) для проверки подлинности на SMTP-сервере. Чтобы использовать этот параметр, необходимо указать допустимое имя пользователя и пароль для указанного SMTP-сервера.

Примечание

Обычная проверка подлинности отправляет userName значения и password на сервер в незашифрованном режиме. Любой пользователь, отслеживая сетевой трафик, может просматривать ваши учетные данные и использовать их для подключения к серверу. Рекомендуется использовать более безопасный механизм проверки подлинности, например Kerberos или NT LAN Manager (NTLM). Если defaultCredentials имеет значение true, будут использоваться Kerberos или NTLM, если сервер поддерживает эти протоколы.

Параметры обычной проверки подлинности и сетевых учетных данных по умолчанию являются взаимоисключающими; Если задать значение defaultCredentialstrue и указать имя пользователя и пароль, используются сетевые учетные данные по умолчанию, а данные обычной проверки подлинности игнорируются.

Для обычной проверки подлинности при указании userNameнеобходимо также указать password для проверки подлинности на почтовом сервере.

Свойство SmtpNetworkElement.UserName можно использовать для получения текущего значения атрибута userName из применимых файлов конфигурации. Свойство SmtpNetworkElement.Password можно использовать для получения текущего значения атрибута password из применимых файлов конфигурации. Атрибут password обычно не вводится в файлы конфигурации по соображениям безопасности.

Атрибут clientDomain изменяет доменное имя клиента, используемое в исходном запросе протокола SMTP к SMTP-серверу. Атрибуту clientDomain можно задать полное доменное имя локального компьютера, а не имя localhost, которое используется по умолчанию. Это обеспечивает более полное соответствие стандартам протокола SMTP. Значением по умолчанию является имя localhost локального компьютера, отправляющего запрос. Свойство SmtpNetworkElement.ClientDomain можно использовать для получения текущего значения атрибута clientDomain из применимых файлов конфигурации.

Атрибут targetName используется для проверки подлинности при использовании расширенной защиты. Значение по умолчанию имеет вид "SMTPSVC/<узел>", где <host> — это имя узла почтового smtp-сервера. Свойство SmtpNetworkElement.TargetName можно использовать для получения текущего значения атрибута targetName из применимых файлов конфигурации.

Атрибут enableSsl указывает, используется ли протокол SSL для доступа к почтовому smtp-серверу. Класс System.Net.Mail.SmtpClient поддерживает только расширение службы SMTP для secure SMTP over Transport Layer Security, как определено в RFC 3207. В этом режиме сеанс SMTP начинается в незашифрованном канале, а затем клиент выдает серверу команду STARTTLS, чтобы переключиться на безопасный обмен данными с помощью SSL. Дополнительные сведения см. в документе RFC 3207, опубликованном Целевой группой по разработке интернета (IETF).

Альтернативный метод подключения — это когда сеанс SSL устанавливается заранее перед отправкой каких-либо команд протокола. Этот метод подключения иногда называется SMTPS и по умолчанию использует порт 465. Этот альтернативный метод подключения с использованием SSL в настоящее время не поддерживается.

Свойство SmtpNetworkElement.EnableSsl можно использовать для получения текущего значения атрибута enableSsl из применимых файлов конфигурации.

Пример

В следующем примере указываются соответствующие параметры SMTP для отправки электронной почты с использованием сетевых учетных данных по умолчанию.

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

См. также раздел