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

Настраивает параметры сети для внешнего SMTP-сервера.Configures the network options for an external Simple Mail Transport Protocol (SMTP) server.

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

СинтаксисSyntax

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

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

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
clientDomain Указывает доменное имя клиента для использования в первоначальном запросе протокола SMTP для подключения к почтовому SMTP-серверу.Specifies the client domain name to use in the initial SMTP protocol request to connect to the SMTP mail server. Значение по умолчанию — имя localhost локального компьютера, отправляющего запрос.The default value is the localhost name of the local computer sending the request.
defaultCredentials Указывает, следует ли использовать учетные данные пользователя по умолчанию для доступа к почтовому серверу SMTP для транзакций SMTP.Specifies whether the default user credentials should be used to access the SMTP mail server for SMTP transactions. Значение по умолчанию — false.The default value is false.
enableSsl Указывает, используется ли протокол SSL для доступа к почтовому серверу SMTP.Specifies whether SSL is used to access an SMTP mail server. Значение по умолчанию — false.The default value is false.
host Указывает имя узла почтового SMTP-сервера, используемого для транзакций SMTP.Specifies the hostname of the SMTP mail server to use for SMTP transactions. Этот атрибут не имеет значения по умолчанию.This attribute has no default value.
password Указывает пароль, используемый для проверки подлинности на почтовом сервере SMTP.Specifies the password to use for authentication to the SMTP mail server. Этот атрибут не имеет значения по умолчанию.This attribute has no default value.
port Указывает номер порта, используемый для подключения к почтовому SMTP-серверу.Specifies the port number to use to connect to the SMTP mail server. По умолчанию используется значение 25.The default value is 25.
targetName Указывает имя поставщика услуг (SPN), используемое для проверки подлинности при использовании расширенной защиты для транзакций SMTP.Specifies the Service Provider Name (SPN) to use for authentication when using extended protection for SMTP transactions. Этот атрибут не имеет значения по умолчанию.This attribute has no default value.
userName Указывает имя пользователя, используемое для проверки подлинности на почтовом сервере SMTP.Specifies the user name to use for authentication to the SMTP mail server. Этот атрибут не имеет значения по умолчанию.This attribute has no default value.

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

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

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

ЭлементElement ОписаниеDescription
Элемент <smtp> (параметры сети)<smtp> Element (Network Settings) Настраивает параметры отправки почты по протоколу SMTP.Configures Simple Mail Transport Protocol (SMTP) mail sending options.

RemarksRemarks

Некоторые SMTP-серверы должны пройти проверку подлинности на сервере перед использованием.Some SMTP servers require that you authenticate yourself to the server before use. Если вы хотите пройти проверку подлинности самостоятельно, используя сетевые учетные данные по умолчанию на узле, задайте defaultCredentials для атрибута значение true .If you want to authenticate yourself using the default network credentials on your host, set the defaultCredentials attribute to true. SmtpNetworkElement.DefaultCredentialsСвойство можно использовать для получения текущего значения defaultCredentials атрибута из применимых файлов конфигурации.The SmtpNetworkElement.DefaultCredentials property can be used to get the current value of the defaultCredentials attribute from applicable configuration files.

Для проверки подлинности на SMTP-сервере также можно использовать обычную проверку подлинности (имя пользователя и пароль).You can also use basic authentication (a user name and password) to authenticate yourself to the SMTP server. Чтобы использовать этот параметр, необходимо указать допустимое имя пользователя и пароль для указанного SMTP-сервера.To use this option, you must specify a valid user name and password for the specified SMTP server.

Примечание

Обычная проверка подлинности отправляет userName password значения и на сервер в незашифрованном виде.Basic authentication sends the userName and password values to the server unencrypted. Любой пользователь, отслеживающий сетевой трафик, может просматривать ваши учетные данные и использовать их для подключения к серверу.Anyone monitoring network traffic can view your credentials and use them to connect to the server. Рекомендуется использовать более безопасный механизм проверки подлинности, например Kerberos или NT LAN Manager (NTLM). Если defaultCredentials имеет значение true , то используется протокол Kerberos или NTLM, если сервер поддерживает эти протоколы.You should consider using a more secure authentication mechanism, such as Kerberos or NT LAN Manager (NTLM.) If defaultCredentials is true, Kerberos or NTLM will be used if the server supports these protocols.

Параметры обычной проверки подлинности и сетевых учетных данных по умолчанию являются взаимоисключающими. Если задано defaultCredentials значение true и указано имя пользователя и пароль, используются учетные данные сети по умолчанию, а основные данные проверки подлинности игнорируются.The basic authentication and default network credentials options are mutually exclusive; if you set defaultCredentials to true and specify a user name and password, the default network credential is used, and the basic authentication data is ignored.

При обычной проверке подлинности при указании необходимо userName также указать password для проверки подлинности на почтовом сервере.For basic authentication if you specify a userName, you should also specify a password to authentication yourself to the mail server.

SmtpNetworkElement.UserNameСвойство можно использовать для получения текущего значения userName атрибута из применимых файлов конфигурации.The SmtpNetworkElement.UserName property can be used to get the current value of the userName attribute from applicable configuration files. SmtpNetworkElement.PasswordСвойство можно использовать для получения текущего значения password атрибута из применимых файлов конфигурации.The SmtpNetworkElement.Password property can be used to get the current value of the password attribute from applicable configuration files. passwordВ целях безопасности атрибут обычно не указывается в файлах конфигурации.A password attribute would not normally be entered in configuration files for security reasons.

clientDomainАтрибут изменяет доменное имя клиента, используемое в первоначальном запросе протокола SMTP, на SMTP-сервер.The clientDomain attribute changes the client domain name used in the initial SMTP protocol request to an SMTP server. clientDomainДля атрибута можно задать полное доменное имя локального компьютера, а не имя localhost, используемое по умолчанию.The clientDomain attribute can be set to the fully-qualified domain name of the local machine, rather than the localhost name that is used by default. Это обеспечивает более высокий уровень соответствия стандартам протокола SMTP.This provides greater compliance with the SMTP protocol standards. Значение по умолчанию — имя localhost локального компьютера, отправляющего запрос.The default value is the localhost name of the local computer sending the request. SmtpNetworkElement.ClientDomainСвойство можно использовать для получения текущего значения clientDomain атрибута из применимых файлов конфигурации.The SmtpNetworkElement.ClientDomain property can be used to get the current value of the clientDomain attribute from applicable configuration files.

targetNameАтрибут используется для проверки подлинности при использовании расширенной защиты.The targetName attribute is used for authentication when using extended protection. Значение по умолчанию — "SMTPSVC/", <host> где <host> — имя узла почтового SMTP-сервера.The default value is of the form "SMTPSVC/<host>" where <host> is the hostname of the SMTP mail server. SmtpNetworkElement.TargetNameСвойство можно использовать для получения текущего значения targetName атрибута из применимых файлов конфигурации.The SmtpNetworkElement.TargetName property can be used to get the current value of the targetName attribute from applicable configuration files.

enableSslАтрибут указывает, используется ли протокол SSL для доступа к почтовому серверу SMTP.The enableSsl attribute specifies whether SSL is used to access an SMTP mail server. System.Net.Mail.SmtpClientКласс поддерживает только расширение службы SMTP для защиты SMTP по протоколу TLS, как определено в RFC 3207.The System.Net.Mail.SmtpClient class only supports the SMTP Service Extension for Secure SMTP over Transport Layer Security as defined in RFC 3207. В этом режиме сеанс SMTP начинается на незашифрованном канале, после чего клиент отправляет на сервер команду STARTTLS, чтобы переключиться на безопасное взаимодействие с помощью SSL.In this mode, the SMTP session begins on an unencrypted channel, then a STARTTLS command is issued by the client to the server to switch to secure communication using SSL. Дополнительные сведения см. в RFC 3207, опубликованных с помощью IETF.See RFC 3207 published by the Internet Engineering Task Force (IETF) for more information.

Альтернативный способ подключения заключается в том, где сеанс SSL устанавливается перед отправкой любых команд протокола.An alternate connection method is where an SSL session is established up front before any protocol commands are sent. Этот метод подключения иногда называют SMTP и по умолчанию использует порт 465.This connection method is sometimes called SMTPS and by default uses port 465. Этот альтернативный метод подключения, использующий SSL, в настоящее время не поддерживается.This alternate connection method using SSL is not currently supported.

SmtpNetworkElement.EnableSslСвойство можно использовать для получения текущего значения enableSsl атрибута из применимых файлов конфигурации.The SmtpNetworkElement.EnableSsl property can be used to get the current value of the enableSsl attribute from applicable configuration files.

ПримерExample

В следующем примере задаются соответствующие параметры SMTP для отправки электронной почты с использованием сетевых учетных данных по умолчанию.The following example specifies the appropriate SMTP parameters to send email using the default network credentials.

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

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