Elemento <network> (configuración de red)

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

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

Sintaxis

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

Atributos

Elementos secundarios

Ninguno.

Elementos primarios

Comentarios

Algunos servidores SMTP requieren que se autentique en el servidor antes del uso. Si quiere autenticarse con las credenciales de red predeterminadas en el host, establezca el atributo defaultCredentials en true. La propiedad SmtpNetworkElement.DefaultCredentials se puede usar para obtener el valor actual del atributo defaultCredentials de los 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.

La autenticación básica y las opciones predeterminadas de credenciales de red se excluyen mutuamente; si establece defaultCredentials en true y especifica un nombre de usuario y una contraseña, se utiliza la credencial de red predeterminar y se omiten los datos de autenticación básica.

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

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

El atributo clientDomain cambia el nombre de dominio del cliente que se usa en la solicitud del protocolo SMTP inicial a un servidor SMTP. El atributo clientDomain se puede establecer en el nombre de dominio completo de la máquina local en lugar del nombre de localhost que se usa de manera predeterminada. Esto proporciona un 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 propiedad SmtpNetworkElement.ClientDomain se puede usar para obtener el valor actual del atributo clientDomain de los archivos de configuración aplicables.

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

El atributo enableSsl especifica si se usa SSL para acceder a un servidor de correo SMTP. La clase System.Net.Mail.SmtpClient solo admite la extensión de servicio SMTP para SMTP seguro sobre la Seguridad de la capa de transporte, según lo definido en RFC 3207. En este modo, la sesión SMTP comienza en un canal sin cifrar y, luego, el cliente emite un comando STARTTLS al servidor para cambiar a una comunicación segura mediante SSL. Para más información, consulte el documento RFC 3207, publicado por el Grupo de trabajo de ingeniería de Internet (IETF).

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. Este método de conexión se denomina a veces SMTPS y, de manera predeterminada, usa el puerto 465. Actualmente, no se admite este método de conexión alternativo mediante SSL.

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

Ejemplo

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 la configuración de red