<элемент network > (сетевой Параметры)

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

<Настройка>
  <system.net>
    <маилсеттингс>
      <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/ < узел > ", где < узел > является именем узла почтового SMTP-сервера. SmtpNetworkElement.TargetNameСвойство можно использовать для получения текущего значения targetName атрибута из применимых файлов конфигурации.

Атрибут указывает, enableSsl используется ли протокол SSL для доступа к почтовому серверу SMTP. System.Net.Mail.SmtpClientКласс поддерживает только расширение службы SMTP для защиты SMTP по протоколу TLS, как определено в RFC 3207. В этом режиме сеанс SMTP начинается на незашифрованном канале, после чего клиент отправляет на сервер команду STARTTLS, чтобы переключиться на безопасное взаимодействие с помощью SSL. Дополнительные сведения см. в RFC 3207, опубликованных с помощью IETF.

Альтернативный способ подключения заключается в том, где сеанс SSL устанавливается перед отправкой любых команд протокола. Этот метод подключения иногда называют SMTP и по умолчанию использует порт 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>  

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