<network> Elemento (Configuración de red)

Configura las opciones de red para un servidor externo de Protocolo de transporte de correo simple (SMTP).

<configuración>
   <system.net>
     <mailSettings>
       <SMTP>
         <red>

Syntax

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Attributes

Elementos secundarios

Ninguno.

Elementos primarios

Observaciones

Algunos servidores SMTP requieren que se autentique en el servidor antes de usarlo. Si desea autenticarse usted mismo con las credenciales de red predeterminadas en el host, establezca el defaultCredentials atributo trueen . La SmtpNetworkElement.DefaultCredentials propiedad se puede usar para obtener el valor actual del atributo de los defaultCredentials archivos de configuración aplicables.

También puede usar la autenticación básica (un nombre de usuario y una contraseña) para autenticarse en el servidor SMTP. Para usar esta opción, debe especificar un nombre de usuario y una contraseña válidos para el servidor SMTP especificado.

Las opciones básicas de autenticación y credenciales de red predeterminadas son mutuamente excluyentes; si establece defaultCredentialstrue en y especifica un nombre de usuario y una contraseña, se usa la credencial de red predeterminada y se omiten los datos de autenticación básicos.

Para la autenticación básica si especifica un userName, también debe especificar un password para autenticarse usted mismo en el servidor de correo.

La SmtpNetworkElement.UserName propiedad se puede usar para obtener el valor actual del atributo de los userName archivos de configuración aplicables. La SmtpNetworkElement.Password propiedad se puede usar para obtener el valor actual del atributo de los password archivos de configuración aplicables. Normalmente password , un atributo no se escribiría en los archivos de configuración por motivos de seguridad.

El clientDomain atributo cambia el nombre de dominio de cliente usado en la solicitud de protocolo SMTP inicial a un servidor SMTP. El clientDomain atributo se puede establecer en el nombre de dominio completo de la máquina local, en lugar del nombre de localhost que se usa de forma predeterminada. Esto proporciona mayor cumplimiento con los estándares del protocolo SMTP. El valor predeterminado es el nombre localhost del equipo local que envía la solicitud. La SmtpNetworkElement.ClientDomain propiedad se puede usar para obtener el valor actual del atributo de los clientDomain archivos de configuración aplicables.

El targetName atributo se usa para la autenticación cuando se usa la protección ampliada. El valor predeterminado es de la forma "SMTPSVC/<host>", donde <host> es el nombre de host del servidor de correo SMTP. La SmtpNetworkElement.TargetName propiedad se puede usar para obtener el valor actual del atributo de los targetName archivos de configuración aplicables.

El enableSsl atributo especifica si SSL se usa para acceder a un servidor de correo SMTP. La System.Net.Mail.SmtpClient clase solo admite la extensión de servicio SMTP para SMTP seguro a través de la seguridad de la capa de transporte tal como se define en RFC 3207. En este modo, la sesión SMTP comienza en un canal sin cifrar y el cliente emite un comando STARTTLS al servidor para cambiar a la comunicación segura mediante SSL. Consulte RFC 3207 publicado por internet Engineering Task Force (IETF) para obtener más información.

Un método de conexión alternativo es donde se establece una sesión SSL por adelantado antes de que se envíen comandos de protocolo. A veces, este método de conexión se denomina SMTPS y, de forma predeterminada, usa el puerto 465. Actualmente no se admite este método de conexión alternativo mediante SSL.

La SmtpNetworkElement.EnableSsl propiedad se puede usar para obtener el valor actual del atributo de los enableSsl archivos de configuración aplicables.

Example

En el ejemplo siguiente se especifican los parámetros SMTP adecuados para enviar correo electrónico mediante las credenciales de red predeterminadas.

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

Consulte también

• System.Net.Configuration.SmtpNetworkElement
• System.Net.Configuration.SmtpSection
• System.Net.Mail.SmtpClient
• Esquema de configuración de red